LordOS — a free, fast and secure GNU/Linux distribution based on Debian, with its own desktop environment: display server and Wayland compositor in C, a React UI engine on QuickJS, and private native apps.
Files
apps/files. A browser for the home folder and the user's mounted disks (and, read-only, the rest
of the computer), with the useful parts
of a classic desktop file manager: tabs, four views, Trash, Quick Preview, Get Info, copy/cut/paste, drag and
drop, color tags and search. Disk operations belong to the server (server/src/fsops.c,
lord.fs in js_sys.c); the app only requests them.
Screenshots (VM 116, real lord-server)
![]() |
|
| Icons with real image thumbnails | List: columns, alternating rows and folders that expand in place |
![]() |
![]() |
| Columns (Miller) with the text preview | Gallery: large preview and the strip below |
![]() |
![]() |
| Quick Preview (Space), 1 of 5; the arrows go to the next one | Get Info (❖I): size, location, dates, permissions and «Open with» |
![]() |
![]() |
| Context menu of a file, with tags | «Open with»: the Text Editor or a Linux app that declares the type (FeatherPad) |
![]() |
![]() |
notes.txt opened in FeatherPad (Qt) from «Open with» |
Dragging onto a folder (it gets highlighted); with tabs |
![]() |
![]() |
| Dragging to the Trash in the sidebar | In the Trash: Restore or Delete permanently |
![]() |
![]() |
| Emptying the Trash asks for confirmation | Red tag: the dot on the icon and the filter in the sidebar |
![]() |
![]() |
| Search in «Documents» or in Home, with each result's folder | Recents, by date |
![]() |
![]() |
| Grouped by kind | Applications (LordOS, packages and Linux) |
![]() |
|
| Light theme | List in the light theme |
![]() |
![]() |
| In Arabic: the sidebar moves to the right | Right click on empty space: New Folder, Paste, View, Sort, Group, hidden files |
What's there
Toolbar: back and forward (history per tab), the name of the place, the four views, Group and Sort (⇅), actions (⋯) and search.
Tabs inside the window and new windows (
wm.open('files', { new: true, args: { path } })). A file can be dropped onto a folder's tab.Sidebar:
- Favorites: Recents, Applications and the user's folders (xdg-user-dirs);
- Locations: Home, This Computer (0.8.5:
/, read-only, named after the machine; folders the user can't open, and/proc,/sys,/devand/run, show a lock; opening one says "Permission denied", or that Files doesn't show the system's internal folders), the disks and USB sticks mounted in/media/$USERor/run/media/$USER(checked every 4 s; ⏏ on hover ejects a removable disk withdisk-ejectand unmounts another disk's partition withdisk-unmount), every other disk with a file system that isn't mounted (dimmed; a click mounts it withdisk-mountand opens it; an internal one asks for an administrator, as in Disks; the disk the system runs from is left out) and the Trash; - Color tags (they filter).
Folders and the Trash accept dragged files.
Views (❖1 to ❖4):
- icons (cards, with
flexWrap; thumbnails of PNG/JPEG up to 24 MB); - list (Name, Modified, Size and Kind, sorted by clicking the header);
- columns (the last three folders and the preview);
- gallery.
In searches, Recents and Tags, the Kind column becomes the folder.
- icons (cards, with
Group by kind (folders first), date (today, 7 days, 30 days, this year, older) or size, and sort by name (natural: «2» before «10»), kind, date or size. Folders go first. Recents and the Trash go by date.
Selection: click, ❖/Ctrl+click, ⇧+click (range), ❖A, and typing the start of a name.
Rename in place (Enter): the name is selected and what you type replaces it (
TextInput selectAll, new in the SDK). Tags follow the file.Copy, cut and paste files: it is a clipboard of its own, separate from the text one. Copying into the same place duplicates with a free name («notas 2.txt»).
Copy and move in the background (server threads): with progress in the status bar and a button to cancel. If something fails, no half-made copies are left.
Drag and drop: moves to a folder, to the sidebar, to a tab or to the Trash; with ⌥ it copies. While dragging you see the icon, the count and a «+» when copying. If a file with that name already exists, a free one is chosen (nothing is overwritten).
Trash (freedesktop.org, the same as GNOME and KDE):
- things from the home folder go to
~/.local/share/Trash, and things from a mounted disk to$mount/.Trash-$uid, with their.trashinfo(Path, DeletionDate); - restoring goes to the original location; if another file is already there, it isn't overwritten and you are told;
- emptying asks for confirmation;
- permanent deletion exists only inside the Trash.
- things from the home folder go to
Quick Preview (Space): the image, the text (the first 64 KB, in monospace), the first page of a PDF, a font sample, the contents of an archive, a video frame (if
media.posteris available) or the file's info card. The arrows go to the next one and Space or Esc close it. SeeDOCUMENTS.md.Archives (M9): double-click opens them like a folder; «Extract here» and «Compress» in the context menu, through the sandboxed helper
lord-doc, never leaving the destination folder (DOCUMENTS.md).Get Info (❖I): size (for folders it is computed with a 0.9 s cap), location, link, creation, modification and access dates, permissions and owner, tags and «Open with».
Open with: the Text Editor (text and code), the Store (
.lpk,.deb) and the Linux apps whose.desktopdeclares the type inMimeType. The latter are launched withlord.apps.launchWith(id, path)(see below).Recents: the files in the home folder modified in the last 30 days. It is a bounded walk: 5 levels, 60,000 entries, no hidden files and no
node_modules.Applications: those from
useLauncherApps()(LordOS, packages and Linux); double-click opens them.Tags: red, orange, yellow, green, blue, purple and gray, stored in
~/.local/share/lordos/tags.json(path → colors).Path bar at the bottom, clickable on each segment, and status bar («N items, X available», «N of M selected» or a copy's progress).
App menus in the theme's bar: File, Edit, View and Go (in Lord Classic, since 0.8.5, in a strip under the window's title bar). In a folder the user can't write (This Computer), the menus and the context menu leave out or disable the actions that would change it.
Shortcuts
| Shortcut | What it does |
|---|---|
| ❖N / ❖T / ❖W | New window / new tab / close tab |
| Ctrl+Tab, ⇧Ctrl+Tab | Next / previous tab |
| ❖1 ❖2 ❖3 ❖4 | Icons / list / columns / gallery |
| ❖[ / ❖] / ❖↑ | Back / forward / enclosing folder |
| ❖↓ or double click | Open |
| Enter | Rename |
| ❖⇧N | New folder |
| ❖D | Duplicate |
| ❖C / ❖X / Ctrl+V | Copy / cut / paste files (also with Ctrl) |
| ❖⌫ or Del | Move to Trash (in the Trash: delete permanently, with confirmation) |
| ❖I | Get Info |
| Space | Quick Preview |
| ❖⇧. | Show hidden files |
| ❖A | Select all |
| Arrows, Home, End | Move the selection (in the list, → and ← expand and collapse) |
API (lord.fs, sdk/fs.js)
copy(from, to), move(from, to) |
A job on a server thread; returns its id. Recursive, keeps permissions and dates, doesn't overwrite (O_EXCL) and copies links as links. Moving on the same disk is an instant rename; across disks, it copies and then deletes the original. |
jobs(), cancelJob(id), forgetJob(id) |
Progress: [{ id, src, dst, move, done, failed, error, bytes, total, files }]. The app polls it every 250 ms while there are jobs. |
trash(path), trashList(), restore(id), removeFromTrash(id), emptyTrash() |
freedesktop Trash (id = path inside …/Trash/files). |
stat(path) |
{ name, path, dir, link, target, size, mode, user, group, mtime, atime, ctime, btime, writable } (statx, without following the link) |
du(path, ms) |
{ size, files, dirs, complete }; stops after ms (max. 3000) |
free(path) |
{ total, free } of the disk |
search(folder, text, { limit, depth }) |
By name, case-insensitive and without hidden files; bounded (up to 1000 results, 16 levels and 100,000 entries) |
recent(limit, days) |
What was recently modified in the home folder |
volumes() |
[{ path, name, fs, total, free }] from /proc/mounts, only /media/$USER/… and /run/media/$USER/… |
Security:
- Changing things goes through
resolve_target(js_sys.c) andfsops_allowed: only the home folder and the user's mounts. - Reading (
list,read,stat,du,free,search; 0.8.5, This Computer) goes throughresolve_readableandfsops_readable: the whole tree as the session user, so the system's own permissions decide what can be opened, except/proc,/sys,/devand/run(this process's memory, environment and open files, devices, and the session's sockets;/run/media/$USERstays). Paths are resolved withrealpathfirst, so a link into those is refused too;listrefuses them withfs.systemFolder(notfs.outsideHome).statoutside the writable roots answerswritable: false, and Files then leaves out the actions that change the folder (new folder, paste, rename, duplicate, Trash, cut, compress, extract). There is no root mode. Isolated.lpkapps don't get this: their broker only reaches their own data folder. «Open with» and the helpers keep the home folder and the user's mounts. - Writing, copying to, moving and sending to the Trash reject the protected folders
(
fsops_protected:~/.local/share/applications,~/.config/autostart,~/.local/share/lordos/apps,~/.config/lordos/settings.json, the permission and firewall decisionspermisos.jsonandfirewall.json, the blocklists (0.8.5),backup.json, the Mail accounts and cache, and the Passwords vaults). Copying from them is allowed. - There is no general
remove.
«Open with» a Linux app: lord.apps.launchWith(id, path)
It is the same approved launcher exception (server/src/apps.c, see WAYLAND.md), with one
file:
- only apps whose
.desktophasMimeType(those that declare they open files); - the path is resolved with
realpathand must be in the home folder or in one of the user's mounts; - it goes as a single argument in the first
%f/%Fof itsExec, or in%u/%Uasfile://…(encoded); - if the
Exechas no file field code, nothing is launched; - no shell, as always.
Tests
make -C server build/fsops-test && build/fsops-teston a temporary home folder: 49/49. It covers:- roots, the read-only tree (
fsops_readable:/,/etc, the user's mounts; not/proc,/sys,/dev,/run, another user's mounts or a relative path) and protected folders; - recursive copy with a link and permissions, and that it neither overwrites nor copies into itself;
- move;
- Trash: repeated names, restore without overwriting, delete only inside, and empty;
- size, search and recents.
- roots, the read-only tree (
- On VM 116 (screenshots above): new folder and rename, copy and paste (with a 600 MB file in the
background, without freezing the UI), duplicate, move by dragging onto a folder, to the Trash
(with a valid
.trashinfo), restore, empty with confirmation, Quick Preview with arrows, Get Info, the four views, tabs, search, tags, Recents, Applications, «Open with» the Editor and FeatherPad, light and dark theme, and Arabic.
Pending
- Ask «Replace?» when pasting or dropping onto a name that already exists: today a free name is chosen.
- Selection rectangle by dragging on empty space.
- PDF, video and SVG thumbnails in the icon view (PDF already shows in Quick Preview); app icons per file type.
- Watching folders with inotify: today the view reloads on re-entering or after one of its own operations.
- The status bar and the path bar end up behind the Dock with the window maximized, as on other desktop systems when the Dock doesn't hide.
- On the VM, ❖C opened Settings, because some ❖ shortcut of the theme or another part of the system grabbed it. Ctrl+C/Ctrl+V works.



















