Dokumentace
Příručka LuxOS: stejné stránky, jaké má LuxOS offline (balík luxos-docs) a ze kterých čerpá i LuxAI, doplněné o návody k LuxAI, Lux Code, hardwaru, zkratkám a často kladené otázky. Většina dokumentace je v angličtině (značka EN); české jsou stránky bez značky.
LuxOS
- LuxOS overview ENWhat LuxOS is, version 1.0.4 "Sirius" and codenames, release history, what differs from other distributions and where each component is documented.
- Časté otázkyOdpovědi o LuxOS: co to je, cena a licence, rozdíl proti Ubuntu, Mintu, Zorinu, elementary a Archu, aplikace z Windows, Steam, hardware, bezpečnost.
- LuxOS ve srovnání s Ubuntu, Mintem, Zorinem, elementary a ArchemČím se LuxOS liší od Ubuntu, Linux Mintu, Zorin OS, elementary OS, Manjara, EndeavourOS a Arch Linuxu: základ, prostředí, balíky, aktualizace, zralost.
- LuxAI – AI asistentLuxAI je AI asistent systému LuxOS: režimy Chat a Agent, hledání na webu, offline příručka, oprávnění, účet LuxAI a soukromí.
- Lux Code – terminálový AI agentLux Code je AI agent pro programování v terminálu: čte projekt, upravuje soubory, spouští příkazy a testy. Instalace jedním příkazem, přihlášení LuxAI.
- Guide for AI assistants on LuxOS ENHow an AI assistant should do admin tasks safely on LuxOS: use lux not pacman, pkexec/polkit instead of passwords, LuxAI administrator mode (password once, only for LuxAI), which settings app or…
- Troubleshooting LuxOS ENFixes for failed updates, locked package database, boot problems, drivers, displays, sound, Bluetooth, printing, keyboard layouts, network, memory, fork bombs (luxos-forkguard), Safe, Sandbox and…
- Package management with lux ENAll lux commands and the full /etc/lux/lux.conf reference (TOML: [repo.NAME], server, mirrors, hold, signatures, [include], old format and lux config migrate), mirror list, Flathub, community (AUR)…
- Community packages (AUR): checking and sandbox ENHow lux checks AUR build scripts (fixed rules + LuxAI Lite and Flash consensus, prompt-injection resistant), the measured detection rate, sandbox as default target, system installs only with…
- lux-engine, repositories and signing ENlux-engine (libalpm and tools from Arch's pacman, renamed lux-engine*), paths /etc/lux and /var/lib/lux, the pacman hint, repositories, signing keys and migration from the pacman layout.
- The .lux package format ENLuxOS's own app format: archive layout, lux.json fields, installation into /opt/lux, /var/lib/lux/installed, the .lux repository and lux pack.
- LuxOS Store ENThe graphical app store: sources (AppStream, [luxos-apps], .lux), categories, Get/Open/Remove, Updates page, error messages and the root helper.
- LuxOS Care and Software Update ENAutomatic updates (Carefree/Classic modes, conditions, timers), the Software Update app, previous-kernel fallback, system snapshots with rollback from the boot menu, LuxOS Recovery, self-repair…
- LuxOS Recovery ENLuxOS Recovery in the boot menu: how to open it (Space while starting, menu shown by itself after a failed start), that nothing runs without confirmation, disk check, restore a snapshot, reinstall…
- Anonymous usage count (countme) ENWeekly anonymous count of active LuxOS installs (like Fedora countme): exactly what is sent (version, architecture, channel, install age), when not, never slows updates, what the server stores (no…
- System protection ENRead-only /usr (only lux, Software Update, Store and lux system apply change it), weekly integrity check of system files against the package database with repair from signed repositories, settings…
- Drivers and hardware detection ENluxos-hwdetect (GPU incl. NVIDIA generations, Wi-Fi, audio, cameras, VMs, fingerprint, sensors), the Drivers app, login notification, lux drivers and NVIDIA power management.
- Installing LuxOS ENThe LuxOS installer (GUI and text): steps, disk modes incl. free space, existing partition and manual LVM/LUKS layout, Btrfs defaults, unattended install.conf keys, keyboard layouts, software…
- Podporovaný hardwareHardware podporovaný v LuxOS: x86_64, UEFI a BIOS, grafika Intel, AMD a NVIDIA, Wi-Fi, zvuk, kamery, čtečky otisků, tiskárny a virtuální počítače.
- Secure BootLuxOS startuje se zapnutým Secure Boot: shim podepsaný Microsoftem, jednorázový zápis klíče LuxOS v MokManageru, luxos-secureboot, starší instalace, DKMS.
- Secure Boot: první startKrok za krokem se snímky: první start LuxOS se zapnutým Secure Boot – jednorázový zápis klíče LuxOS v MokManageru, nic se nepíše.
- Boot partition (EFI) space ENWhat is on the EFI/boot partition, why the initramfs is small (luxos-slim), how LuxOS keeps free space (merged and pruned snapshot kernel sets, checks before and after updates), luxos-care…
- The LuxOS Desktop ENTop bar, Control Center, Dock, Launchpad, Search, notifications, light/dark/auto mode, wallpapers, boot splash, login screen, login transition, luxos-hub, multiple monitors and touchpad.
- Scrolling, Mouse and Touchpad ENTouchpad inertia (kinetic scrolling) and smooth mouse-wheel scrolling in GTK 3 apps, Terminal, Firefox and Mail; Settings › Scrolling (luxos-scrolling), scrolling.conf, the luxos-scroll GTK module…
- Top bar options and desktop widgets ENluxos-bar plugin (opaque bar under maximized and full-screen windows, clock in the middle, rounded bottom corners, white text) and desktop widgets luxos-widgets (time and weather, month…
- Login, lock screen and screen saver ENLuxOS login screen (greeter), login transition with spinner, lock screen and unlock dialog, screen savers including LuxOS wallpapers with a clock.
- Keyboard Layouts and Keyboard Shortcuts ENKeyboard Layouts app (system-wide layouts, switching keys, localectl) and Keyboard Shortcuts app with the full list of default LuxOS shortcuts.
- Klávesové zkratkyVšechny klávesové zkratky LuxOS: Hledání, Launchpad, okna, snímky obrazovky, zámek, monitory, LuxAI a Lux Code.
- LuxOS Settings Apps ENDesktop & Dock, Displays (monitor arrangement per set of monitors, main display, mirroring, Super+P, 15 s confirm), Battery & Power, Bluetooth, Fingerprint (PAM), Profile Picture, Screen Saver &…
- Displays ENDisplays settings: monitor arrangement per set of monitors, main display, mirroring, Super+P, resolution, text size and the 15 s confirmation.
- Router app (network administration) ENRouter app (luxos-router): network details, default gateway, router web admin inside the app limited to the home network, self-signed certificates, devices on the LAN with vendor lookup…
- LuxOS Apps ENCommands and features of LuxOS apps: About, Welcome, Tour, What's New, LuxOS News (announcements), Calculator, Calendar, Camera (Wi-Fi QR scan mode), Weather, Wi-Fi QR Code, System Monitor…
- Developing applications for LuxOS ENThe native LSL developer kit: App Studio project templates, build/run and .lux export; Icon Studio layered .luxicon projects and SVG/PNG assets; reusable GTK UI helpers and design guidelines.
- Weather ENWeather app (luxos-weather): current conditions, hourly and 7-day forecast from Open-Meteo, saved places, city search, location only after consent, automatic units with a one-time °C/°F question…
- Maps ENMaps (luxos-maps): OpenStreetMap map, place search, routes by car/bike/walk (OSRM) and public transport (Transitous) with live departures board, nearby places (Overpass), favorites, my location…
- Maps navigation ENTurn-by-turn navigation in Maps (luxos-maps): banner, heading up, phone GPS or GeoClue, smooth arrow, rerouting when off route or going the wrong way (also public transport, missed connection)…
- Maps search and suggestions ENMaps (luxos-maps) search and suggestions while typing in search and route Start/Destination: Photon (photon.komoot.io), favorites, recent places, stops, My Location first; keys, icons, 250 ms…
- Phone (LuxOS Companion) ENLuxOS Companion Android app over Bluetooth (luxos-companion, Settings › Phone): pairing, approving phones, live phone GPS in Maps (with Maps consent), LuxAI requests from the phone, calendar notes…
- Wi-Fi QR codes ENShare the current Wi-Fi as a QR code (luxos-wifi-qr, Control Center) and join a network by scanning a Wi-Fi QR code with the camera (luxos-camera --scan-wifi); WIFI: format, password from…
- Emoji & Symbols ENEmoji picker (luxos-emoji, Super+. and Ctrl+Super+Space): search in the system language and English without diacritics, categories, skin tones, recently used, insertion into the focused app via the…
- Printing and Scanning ENAutomatic driverless printer and scanner setup (luxos-printing), Printers & Scanners and Scanner apps, helper commands and troubleshooting.
- LuxDrop ENSecure local file sharing between LuxOS computers and LocalSend apps: GUI, CLI, verification code, trust, receive modes, background service, ports and firewall.
- Files of another computer (Connect to Computer) ENOpen the shared folders of another LuxOS computer in Files side by side: Share folders, Allow once/Always/Deny, read-only by default, SFTP in a bubblewrap sandbox over LuxDrop TLS, luxdrop…
- Safe – encrypted folder (/safe/<user>) ENluxos-safe: gocryptfs-encrypted /safe/<user> with its own password, threat model, recovery key, scrypt upgrade, signing keys (GnuPG, Android keystore) in the Safe, auto-lock, CLI and limits
- Sandbox – isolated system for untrusted apps (/dev/sandbox/<user>) ENluxos-sandbox: per-user minimal Arch root run with bubblewrap, seccomp, pasta networking and Xephyr; commands, starting sandbox apps (command wrappers at the end of PATH, Launchpad entries…
- Lux Guard – protection against harmful downloaded programs ENluxos-guard: fanotify check of programs from downloads, attachments and USB when started; risky = dialog, critical (wiping disk/home, ransomware, hidden code) = sandbox only; why something was…
- LuxOS Firewall ENLuxOS firewall (on by default, nftables table inet luxos): what is allowed automatically (DHCP, IPv6, mDNS, printers, LuxDrop, Steam, SSH, Tailscale), notifications for blocked programs, Settings >…
- E-mail – Thunderbird ENThunderbird is the e-mail app of LuxOS (installed on new systems with its language pack): installing it on older systems, adding Gmail/Google Workspace and Outlook/Microsoft 365 accounts with…
- LuxOS Mail (preview, staging only) ENPreview, staging channel only (stable LuxOS: Thunderbird, email.md). LuxOS Mail (luxos-mail, LSL): LuxAI mailboxes without a password (OAUTHBEARER/XOAUTH2), IMAP with server discovery…
- LuxOS Mail (preview) – writing, reading and technical notes ENLuxOS Mail: writing and sending (SMTP, XOAUTH2/OAUTHBEARER, drafts, Outbox, reply/forward, shortcuts), reading messages (safe HTML view, clickable links, remote images, attachments, find, print) and…
- Backups – automatic backups to an external or network disk ENluxos-backup: hourly incremental backups of the home folder to a USB, SFTP or SMB disk (btrfs snapshots or rsync hard links), optional LUKS encryption, thinning, excludes, restoring files and…
- Temporary files (/tmp) EN/tmp on disk instead of RAM (Btrfs subvolume @tmp, nodev,nosuid, exec allowed), emptied at every start and after 10 days, excluded from snapshots, automatic switch of existing installs…
- Power, performance and memory ENData Saver, Battery Saver (auto at 20 %), Performance mode with games on the discrete GPU (NVIDIA/AMD hybrid graphics, luxos-gpu), earlyoom, zram, sysctl, I/O schedulers, CPU scheduler scx_lavd…
- Shell: lsh (Lux Shell), aliases and fastfetch ENlsh bash fork: about builtin, LSL lines in the shell, ./script.lsl, pip warning, config files, aliases, pacman hint, fastfetch (Unicode logo, real logo image in Terminal)
- Terminal (luxos-terminal) ENDefault terminal (GTK3 + VTE): tabs, shortcuts, light/dark profiles, find, links, SIXEL images, fastfetch logo, terminal.conf, command-line options, per-tab process and memory limits (fork bomb…
- Text Editor (luxos-text) ENDefault text and code editor since 1.0 (C, GTK3 + GtkSourceView 4, replaces Mousepad): folder sidebar, syntax, outline, counts, encodings and line endings kept on save, find and replace, shortcuts…
- LuxAI account ENShared LuxAI account: luxos-account CLI, account.json, sign-in and registration, account management (username, password, sessions, AI answer style, data export, account deletion), Flash/Lite models…
- LuxAI administrator mode ENHow LuxAI runs agent commands as root: administrator mode since 2.0.2 (password once, remembered ~5 minutes only for the LuxAI process, requests from other programs always confirmed), the removed…
- LuxAI rich answers ENCharts, quizzes (one question per card), calculators, diagrams (Mermaid), typeset formulas, sortable tables, maps, galleries, timelines and checklists in LuxAI answers: what to ask for, saved…
- Where configuration lives ENConfig layers (/etc/xdg/luxos, XDG_CONFIG_DIRS, xfconf channels, dconf), ~/.config/luxos files, system config files and how to reset defaults
- Whole-system configuration in one file (lux system) EN/etc/luxos/system.lsl (LSL, like configuration.nix), written by the installer: packages, services, users, locale, Care, Guard, firewall, kernel, domain; policies in /etc/luxos/system.d (mkForce…
- System configuration: network, printers, power, boot ENGenerated system.lsl (comments in the system language, no passwords) and sections network (NetworkManager, connection in use protected), printers (CUPS), power, boot menu, drivers, formats, console…
- Organization network: Windows domain (lux domain) ENJoin a Microsoft Active Directory or Samba AD domain: lux domain discover/join/leave/status, Settings > Organization Network, domain sign-in, offline 30 days, domain admins (sudo, polkit), SMB…
LSL
- LSL (Lux Simple Lang) overview ENWhat LSL is, the lsl package on LuxOS, running and compiling programs, interactive mode, targets and a map of the LSL reference.
- LSL syntax, variables, operators and output ENLexical rules, comments, blocks with end, variables, multiple assignment, type-constrained declarations, operators and precedence, strings, raw and interpolated l-strings, print/printl/printr/input…
- LSL types and collections ENBuilt-in types, truthiness, conversions, indexing and slicing, List, Dictionary, Tuple, Set, RealArray, IntArray, FloatArray, ByteArray, string methods and comprehensions.
- LSL control flow ENif/elif/else, for loops with unpacking, rang/range, while, loop, break, continue, lock blocks and exit.
- LSL functions and classes ENDefining and calling functions (call), default and named arguments, globals, first-class functions, classes, init, ctype, class attributes, inheritance with origin, and modules in files.
- LSL error handling ENsafe, try/else, Error, check, last_error, what can be caught, uncaught error format, module error types and compiler diagnostic codes.
- LSL modules, libraries and packages ENload syntax and aliases, from ... load, module search order, bundled libraries in 0.10.2, optional registry packages, lsl install/search/update/check/origin and libraries with sudo.
- LSL built-in functions ENAll built-in functions: output, conversion, math, bits, characters, time, threads and atomics, files, file system, process execution and arguments, errors, len and help.
- LSL standard library: core modules ENModules lux, math, bigint, json, lconf, env (.env files), time and random with functions and examples.
- LSL standard library: processes and system administration ENModules os (no shell), process, system (packages, services, users, files), luxos, config/lsl config and sandbox/lsl sandbox.
- LSL standard library: HTTP, servers and AI ENrequests and http clients, httpserver and lsl server, and the ai/aikit OpenAI-compatible chat client with streaming and tool calling.
- LSL standard library: terminal, graphics and low-level I/O ENtui terminal toolkit, fd, unixsock, native, plugin, and optional display, gfx, ui, css and input packages.
- LSL numeric computing: FloatArray kernels, tensor and CUDA ENNative FloatArray kernels, the tensor module, the optional CUDA backend and performance notes.
- LSL command line and tooling ENAll lsl subcommands, compile and targets, help and man, interactive mode, lsl --tui editor, colors, updates, lsl config and lsl sandbox.
- LSL examples ENTested complete LSL programs: hello world, guessing game, word count, JSON configuration, system info, classes, records, HTTP request, threads and a streaming AI chatbot.
- Lux Code and LSL IDE ENLux Code terminal AI coding agent built on Oh My Pi (commands, sign-in, tools, configuration) and the LSL IDE graphical editor with its LuxAI agent.