LuxOS Apps

LuxOS ships its own small apps, mostly in the luxos-desktop package (GTK 3, Python or bash, /usr/bin/luxos-*). All of them follow the system language (luxos-i18n: English plus 12 translations) and the light/dark mode.

Overview

App (name in Launchpad) Command What for
About This Computer luxos-about version, hardware, links to What's New, Tour, Feedback, Software Update
Welcome to LuxOS luxos-welcome first steps: dark mode, Store, update, LuxAI sign-in, Tour, Shortcuts
LuxOS Tour luxos-tour short illustrated tour of where everything is
What's New luxos-whats-new news of the installed LuxOS version
LuxOS News luxos-news announcements from the LuxOS team (releases, maintenance)
Calculator luxos-calculator basic and scientific calculator
Calendar luxos-calendar calendar under the clock, events with reminders (.ics)
Camera luxos-camera photos and videos from the webcam; --scan-wifi joins a Wi-Fi from a QR code
Weather luxos-weather current weather, 24-hour and 7-day forecast (weather.md)
Maps luxos-maps OpenStreetMap map, place search, routes, navigation, favorites, geo: links (maps.md, maps-navigation.md)
Text Editor luxos-text text and code editor: folder sidebar, syntax, outline, encodings, find and replace (text-editor.md)
Wi-Fi QR Code luxos-wifi-qr share the Wi-Fi as a QR code, join one by scanning (wifi-qr.md)
System Monitor luxos-monitor performance charts, quit frozen apps
Screenshot luxos-screenshot screenshots and screen recording
Emoji & Symbols luxos-emoji search and insert emoji, Super+. or Ctrl+Super+Space (emoji.md)
Feedback luxos-feedback send a bug report or an idea to the author of LuxOS
Control Center luxos-control-center quick settings (desktop.md)
Search / Launchpad luxos-search / luxos-launchpad find and launch apps (desktop.md)
Toggle Dark Mode luxos-appearance toggle switch light/dark
LuxDrop luxdrop send files nearby (luxdrop.md)
Printers & Scanners, Scanner luxos-printers, luxos-scan printing-scanning.md
Software Update luxos-update updates (care-updates.md)
LuxOS Store luxos-store install apps (store.md)
Safe, Sandbox luxos-safe, luxos-sandbox safe.md, sandbox.md
Lux Guard luxos-guard-gui watched downloaded programs, recent decisions, restore files from snapshots (guard.md)
Backups (Zálohy) luxos-backup-gui automatic backups to a USB or network disk, browse backups by time and restore files (backups.md)
Settings apps luxos-settings, luxos-display-settings, … settings-apps.md

Standard apps that are installed by default: Firefox, Files (Thunar), Terminal (luxos-terminal with the lsh shell, terminal.md), Text Editor (luxos-text, text-editor.md), Ristretto (images), Evince (documents), Xarchiver, Celluloid (video). In the top bar, some of them get short names such as "Files", "Terminal", "Text Editor", "Image Viewer" and "Document Viewer".

Double-clicking a file in Files opens the default app from /etc/xdg/luxos/mimeapps.list (package luxos-desktop): text and source files in Text Editor, PDF, PostScript, DjVu, XPS and comic books (CBZ/CBR) in Evince, images (PNG, JPEG, GIF, WebP, BMP, TIFF, SVG) in Ristretto and archives (ZIP, 7z, RAR, tar.*) in Xarchiver - also after you install another app that handles the same type (e.g. a game launcher that opens ZIP files). Your own choice in Open With › Other Application (~/.config/mimeapps.list) always wins; a default app that is not installed is skipped.

Firefox in LuxOS

LuxOS ships Firefox defaults in /usr/lib/firefox (package luxos-desktop); you can change every one of them in Firefox Settings or about:config:

  • Window buttons like other LuxOS windows: the close, minimize and maximize buttons in the tab strip are the red, yellow and green circles of the LuxOS window frames, on the same side and in the same order (from gtk-decoration-layout), grey in an inactive window, showing ×, − and arrows under the mouse; correct in light and dark mode, private windows, with the menu bar or vertical tabs and at 2x scaling. Firefox loads the style luxos/titlebar.css through the autoconfig file luxos.cfg only into browser windows - your own userChrome.css keeps working and wins. Turn it off with luxos.titlebar.trafficlights = false in about:config (applies immediately). If a new Firefox version renames its buttons, Firefox simply shows its own buttons again.
  • LuxOS welcome page on the first start: a new Firefox profile opens a local page (no internet needed, no tracking) in the system language: import bookmarks and passwords from Chrome or Edge (the button opens Firefox's import wizard; bookmarks exported as HTML and passwords as CSV on Windows work too), the privacy settings below and tiles for the LuxOS help (web), LuxAI, Store, Keyboard Shortcuts and Feedback - the last four open the app directly, or its help page on the web when the app is not installed. It opens only once per profile - not on later starts or after Firefox updates - and it does not replace your home page. Mozilla's privacy notice tab and about:welcome are not shown. You can open it again any time: firefox /usr/lib/firefox/luxos/welcome/index.html. In a Firefox window that was already running before a LuxOS update installed a new version of the page, the tiles open the web pages and the import button also shows where to find the import in Settings; after restarting Firefox they work directly.
  • No ads: uBlock Origin built in: the ad and tracker blocker uBlock Origin (package firefox-ublock-origin, installed with luxos-desktop, also on older installations with lux update) is in /usr/lib/firefox/browser/extensions and is on in every profile, new and existing, without asking. It works offline from the first start with its built-in filter lists and updates the lists itself later; the add-on itself is updated with the system. Its icon is in the toolbar: click it to switch blocking off for one site, or manage it in about:addons, where you can also turn it off (it stays off). The welcome page shows "Ads and trackers blocked" when it is on.
  • Privacy: no telemetry or technical data to Mozilla (datareporting.healthreport.uploadEnabled, toolkit.telemetry.*), no studies (app.shield.optoutstudies.enabled, app.normandy.enabled), no sponsored shortcuts or stories on the new tab page, no country lookup by IP (browser.region.*), no connectivity and Wi-Fi sign-in checks against detectportal.firefox.com (LuxOS detects sign-in pages itself with luxos-portal-check) and no add-on recommendations (browser.discovery.enabled). Firefox still downloads updates of its block lists, certificate revocations and Safe Browsing lists.
  • Speed and scrolling: hardware video decoding (VA-API), unloading unused tabs when memory is low, smooth scrolling with touchpad inertia (scrolling.md). E-mail links (mailto: in Files, xdg-email) go through luxos-mail-reader (exo helper MailReader in /etc/xdg/luxos/xfce4/helpers.rc): the app set for mailto links (default Thunderbird, see email.md), otherwise an installed mail app (Thunderbird also from Flathub, LuxOS Mail, Evolution, Geary). Without one, a notification appears and the Store searches for mail apps.

About This Computer

Run luxos-about, or use the LuxOS logo menu (first favourite). It shows the LuxOS version and build ("Rolling release · based on Arch Linux"), computer model, processor, memory (installed size as on the box, e.g. 16 GB – the kernel reports a little less because graphics and firmware reserve part of it), graphics, storage, battery and the Linux kernel, with the values aligned in one column. Buttons: What's New, LuxOS Tour, Send Feedback…, Software Update (luxos-update, or lux update in a terminal if LuxOS Care is missing), Close. It is a native LSL program (files/lsl/luxos-about.lsl) and opens under any locale, also LANG=C; luxos-about --print prints the same values as text.

Welcome to LuxOS

Run luxos-welcome. It opens on first login (after the Tour), and on the live ISO it opens right away. It lists the key shortcuts. Buttons:

  • Install LuxOS (live ISO only);
  • Light Mode / Dark Mode;
  • LuxOS Store;
  • Update (runs lux update in a terminal);
  • Sign in to LuxAI (only while not signed in);
  • LuxOS Tour;
  • Shortcuts (luxos-shortcuts).

After it closes, it writes ~/.config/luxos/welcome-done.

LuxOS Tour

luxos-tour opens the tour, luxos-tour --page N opens page N, and --first-run is used at the first login (it runs only once; ~/.config/luxos/tour-done). Pages:

  1. Welcome.
  2. The Menu Bar.
  3. The Dock.
  4. Launchpad and Search (with LuxAI questions).
  5. Files and Safe.
  6. Installing Apps (Store, lux).
  7. Light, Dark or Auto.
  8. Share and Print (LuxDrop, Printers & Scanners).
  9. Help and Shortcuts.

Buttons open the apps, and "Show on Screen" highlights the real top bar or Dock (needs the compositor).

What's New

luxos-whats-new shows the news of the current version. The notes are in /usr/share/luxos/whats-new/<version>.json (package luxos-branding), with English and Czech text. After an update to a new LuxOS version, luxos-whats-new --auto runs at login and shows the news of every version since the last one seen (~/.config/luxos/whats-new-seen). New users see the Tour instead (--mark-seen). The installed version is in /usr/lib/luxos/version.

LuxOS News

luxos-news shows announcements from the LuxOS team (new release, planned server maintenance, important change). New ones also come as notifications; a click opens the app. The session hub runs luxos-news --check 3 minutes after login and then every 6 hours; it only downloads https://luxos.lux-ai.cz/announcements.json and sends nothing.

  • Unread announcements are on top with a dot; opening the window marks them read. Important ones have an orange label and their notification stays until closed.
  • Notify me about news turns the notifications off; Check Now downloads the feed again.
  • First check: announcements older than 14 days are not notified; at most 3 notifications per check.
  • Plain text only; links (https:// only) open just by clicking More information. Invalid entries and feeds over 256 kB are ignored.
  • State: ~/.cache/luxos/news.json (feed), ~/.local/state/luxos/news.json (read, switch).

Calculator

Run luxos-calculator, or press the Calculator key. It uses decimal arithmetic, so 0.1 + 0.2 = 0.3, and it respects operator precedence and parentheses.

  • Basic mode is Ctrl+1, scientific mode is Ctrl+2. Scientific mode adds powers, roots, logarithms, trigonometric functions (degrees/radians), factorial and constants.
  • Keyboard: digits, + - * / ^ ( ), Enter, Backspace, Esc, %, Ctrl+C and Ctrl+V, Ctrl+W or Ctrl+Q closes it. Ctrl+V pastes a number (also 1e5); a number longer than the display is rounded and text that is not a number is ignored.

Calendar

Click the clock in the top bar (luxos-calendar-toggle), or run luxos-calendar.

  • Views: Day (big date and today's events as coloured cards), Month (a dot marks a day with events, click a day to see them) and Year (click a month to open it).
  • + / New Event: title, date, start and end or All day, Repeat (Never, Daily, Weekly, Monthly, Yearly, or Custom for imported rules), colour, "Remind 10 minutes before". Click an event card to edit or delete it.
  • Data: ~/.local/share/luxos/calendar/events.ics (iCalendar RFC 5545). Other *.ics files in that folder are loaded read-only, so you can drop an export from Google Calendar there. Supported: VEVENT with SUMMARY, DTSTART/DTEND/DURATION, time zones, RRULE (DAILY, WEEKLY, MONTHLY, YEARLY with INTERVAL, COUNT, UNTIL, BYDAY, BYMONTHDAY, BYMONTH), EXDATE, RECURRENCE-ID, COLOR, VALARM. Unknown properties are kept unchanged.
  • Reminders are sent as desktop notifications by the calendar running inside luxos-hub (or luxos-calendar --background).
  • Under today's date the Day view shows the weather of the place selected in Weather ("13° Partly Cloudy · Praha") when the Weather app downloaded it in the last 3 hours; a click opens Weather (weather.md).

Camera

Run luxos-camera. It is a Photo Booth-style webcam app built on GStreamer (v4l2).

  • Photo or Video, a mirrored preview (toggle "Mirror preview"), Choose camera when there are several, and "Take the picture after 3 seconds".
  • Photos (JPEG) are saved to $(xdg-user-dir PICTURES)/Camera, and videos (WebM VP8 + Opus, or MP4 if x264enc is available) to $(xdg-user-dir VIDEOS)/Camera. "Open last capture" opens the latest file.
  • Possible errors: "No camera found", "The camera is being used by another app", "Camera access is not allowed", or a missing gst-plugins-good. Webcams that need special drivers (Intel IPU6/IPU7) are handled by drivers.md.
  • luxos-camera --scan-wifi is the scan mode for Wi-Fi QR codes (wifi-qr.md).

System Monitor

Run luxos-monitor, or press Super+Alt+Esc or Ctrl+Shift+Esc.

  • Cards with gauges and a 60-second chart for Processor, Memory, Disk and Network (download and upload).
  • Below them, the open apps with icons and a Quit button. If an app does not respond, it offers "Force Quit" (unsaved changes are lost).
  • A switch shows "All processes" (a technical list with processor and memory use).
  • Click a column header (Name, Processor, Memory) to sort the list by it; a second click reverses the order (arrow next to the header). The choice is remembered in ~/.config/luxos/monitor.conf.
  • The data is read straight from /proc every second.

Clock

Run luxos-clock-app (Clock in Launchpad), or click the time on the Clock & Weather widget.

  • Alarm: alarms with a time, a label and repeat days (or once); a switch turns each on or off, + adds one, × deletes it. A ringing alarm shows a window above all others with a sound and a notification: Snooze (10 minutes) or Stop. A one-time alarm turns itself off after ringing. Nobody reacts: the sound and the window stop after 10 minutes, the notification stays.
  • World Clock: the local time and chosen cities with the time difference (search by city or time zone, from /usr/share/zoneinfo/zone1970.tab).
  • Stopwatch with laps and Timer (hours, minutes, seconds or 1-30 minute presets); a finished timer rings like an alarm.
  • Closing the window keeps the app in the background while an alarm is on or a timer runs, so alarms ring without the window. At login luxos-clock-app --background starts it only when an alarm is on. Opening it again just shows the running app. Data: ~/.local/share/luxos/clock/clock.json.
  • Ctrl+W or Ctrl+Q closes the window (alarms keep running in the background), Esc closes the new-alarm form.

Screenshot

Run luxos-screenshot, press Print or Super+Shift+5 for the floating bar, or use the direct shortcuts Super+Shift+3 (whole screen) and Super+Shift+4 / Shift+Print (selected area; press Space to pick a window instead).

The bar has these modes: Capture Entire Screen, Capture Selected Window, Capture Selected Portion, Record Entire Screen, Record Selected Portion. Its Options menu has:

  • Save to: Screenshots (default, Pictures/Screenshots named in the user's language, created on the first save), Desktop, Pictures, Clipboard, Other… (a chosen folder). Recordings cannot go to the clipboard and are saved to the default folder instead.
  • Timer: None, 5 Seconds, 10 Seconds.
  • Show Mouse Pointer.
  • Remember Last Selection.

Files are named like Screenshot 2026-10-22 at 11.12.03.png and Screen Recording … .mp4. A thumbnail appears for 5 s after saving. Options are stored in ~/.config/luxos/screenshot.json.

Recording uses ffmpeg (x11grab, MP4). A small pill with a timer and Stop appears. Running luxos-screenshot --stop (or starting the tool again) also stops recording.

Command-line options:

luxos-screenshot --screen | --portion | --window
luxos-screenshot --record-screen | --record-portion | --stop
  --clipboard            copy instead of saving a file
  --output DIR           save into DIR
  --region X,Y,W,H       capture this rectangle without selecting
  --no-thumbnail
luxos-screenshot --close   close an open bar, selection or thumbnail

Esc closes the tool in every state (bar, selection, timer countdown, thumbnail) even when another app has the keyboard focus; an open Options or thumbnail menu closes first. While recording, Esc is left to the recorded apps – use Stop or run the tool again. The bar and its windows live in the session process luxos-hub, so the bar appears instantly; without it luxos-screenshot starts the same tool on its own (/usr/lib/luxos/luxos-screenshot-ui).

Old xfce4-screenshooter launchers open this tool too.

Feedback

Run luxos-feedback, or use About This Computer › Send Feedback… or Keyboard Shortcuts › Send Feedback…. The report goes directly to the author of LuxOS: POST https://lux-ai.cz/api/feedback (JSON).

  • Type: Bug ("Something doesn't work"), Idea ("Suggest an improvement"), or Something else ("Question or comment"). A text with a minimum length.
  • Optional e-mail (if you would like a reply), optional screenshot ("Attach a screenshot").
  • Attach system information (optional, with "Show what will be sent"):
  • OS name and version, kernel, computer model, CPU and cores, GPU, memory, free disk space;
  • session type, language, uptime;
  • versions of LuxOS-related packages (luxos*, lux, lux-*, luxai, lsl, kernels, mesa, xorg-server, xfce4-session);
  • the last 50 error lines of the user and system journal of this boot, and ~/.xsession-errors.

Personal files, tokens, e-mail addresses and the home path are not included. - If you are signed in to LuxAI, the account is attached (cookie). Otherwise the report is anonymous. - Offline: the report is saved in ~/.local/share/luxos/feedback-outbox and sent later (luxos-feedback --send-outbox). - After sending, you get a Report ID.

Network warning (luxos-netcheck)

luxos-netcheck is not a window. It is the "!" icon in the top bar, shown when NetworkManager reports a connection without internet (limited/none) or a captive portal (portal). For a portal, clicking it opens the sign-in page. Otherwise it opens Control Center. To check by hand: nmcli -t -f CONNECTIVITY,STATE general.

Captive portal sign-in (hotel, train, airport Wi-Fi)

The sign-in window (luxos-network-login, a private Firefox window that forgets everything) opens by itself once per connection. Closing it, even without signing in, does not mark the portal as done. Until the internet works you can always get back to it:

  • click the "!" icon in the top bar (tooltip "Sign in to the network…");
  • Control Center › Sign In to "<network>"… under the tiles;
  • the Sign In button in the notification. The notification stays until you close it. If you close it while the network still blocks the internet, one reminder comes after 5 minutes, then after 10, 20, 40 and at most every 60 minutes. The window never reopens by itself;
  • the command luxos-network-login.

Only one sign-in window runs. Opening it again brings the open window to the front. When the internet works, the window, the notification and the "!" icon go away by themselves. A portal that NetworkManager cannot see (Tailscale or VPN DNS) is found by luxos-hub with luxos-portal-check and handled the same way (state in $XDG_RUNTIME_DIR/luxos-portal).