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 styleluxos/titlebar.cssthrough the autoconfig fileluxos.cfgonly into browser windows - your ownuserChrome.csskeeps working and wins. Turn it off withluxos.titlebar.trafficlights = falseinabout: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:welcomeare 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 withluxos-desktop, also on older installations withlux update) is in/usr/lib/firefox/browser/extensionsand 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 inabout: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 withluxos-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 throughluxos-mail-reader(exo helperMailReaderin/etc/xdg/luxos/xfce4/helpers.rc): the app set formailtolinks (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 updatein 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:
- Welcome.
- The Menu Bar.
- The Dock.
- Launchpad and Search (with LuxAI questions).
- Files and Safe.
- Installing Apps (Store,
lux). - Light, Dark or Auto.
- Share and Print (LuxDrop, Printers & Scanners).
- 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 (also1e5); 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*.icsfiles 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(orluxos-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-wifiis 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
/procevery 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 --backgroundstarts 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/Screenshotsnamed 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).