Omafilev1.4.13service · bar-widget · panel
A file manager that lives in the shell.
Omafile opens as a real window with tabs and dual panes, four views you can zoom, quick preview on Space, a built in text editor, a duplicate finder, archives and transcoding, live directory watching and background transfers, and puts places, drives, transfers and trash in the bar. It can stand in for the GTK file chooser, so browser uploads open Omafile. It follows GNOME Files conventions, so the shortcuts you already know work.
Install
omarchy plugin add https://github.com/chr0nzz/omarchy-omafile.git --enable --yesUpdate with omarchy plugin update xyzlab.omafile, remove with omarchy plugin remove xyzlab.omafile.
Needs
- Omarchy 4
- Python 3, included with Omarchy
- util-linux lsblk and findmnt
- Optional udisksctl for mounting, unlocking and ejecting drives
- Optional gvfs and gvfs-smb for network servers
- Optional PyGObject, shipped with Omarchy, for Show in folder and the file picker
- Optional qt6-multimedia and ffmpeg, installed by Omarchy, for playing audio in the preview
- Optional ImageMagick and ffmpeg, installed by Omarchy, for Transcode
Then set it up
What to do once it is installed. Anything marked optional can wait.
Bind a key
Super+E toggles the window. If it is already open it comes to the front.
In
~/.config/hypr/bindings.luao.bind("SUPER + E", "Omafile", "omarchy-shell shell toggle xyzlab.omafile '{}'")Give the window a rule
Without this the window tiles like anything else. This floats it at a sensible size, centred.
In
~/.config/hypr/windows.luao.window({ class = "^org.quickshell$", title = "^Omafile( [0-9]+)?$" }, { float = true, size = { 1100, 720 }, center = true })Make it solid
optionalOmarchy makes every window slightly transparent, so the wallpaper shows faintly through. Opt Omafile out of that rule if you would rather it were solid.
In
~/.config/hypr/windows.luao.window({ class = "^org.quickshell$", title = "^Omafile( [0-9]+)?$" }, { tag = "-default-opacity", opacity = "1 1" })Open a new window each time
optionalSuper+E brings the open window to the front. To get another window instead, bind newwindow. Extra windows are titled Omafile 2, Omafile 3 and so on, and each opens a little down and to the right of the first.
In
~/.config/hypr/bindings.luahl.unbind("SUPER + E")o.bind("SUPER + E", "Omafile (new window)", "omarchy-shell omafile newwindow")Become the default file manager
optionalTurn on Default file manager in Settings, Ctrl+Comma. Folders opened from anywhere else then land in Omafile, and Show in folder opens the containing folder with the file selected. It also puts Omafile in your application launcher. Turning it off restores the handler you had before.
Pick files for other apps
optionalTurn on Pick files for other apps in Settings, under Opening. Upload file and Save as in your browser then open Omafile instead of the GTK chooser. It asks for your password once, to install a single portal file in /usr/share. Nothing else outside your home directory changes.
Put a trash can in the bar
optionalTurn on Trash can in the bar in Settings. It becomes its own widget, so you can drag it anywhere from the Omarchy bar settings, including the far side of the bar from the file manager icon.
In Tokyo Night
Every shot was taken on a real Omarchy desktop with that theme applied. Pick another and they follow.
The window, floating over the desktop with the wallpaper showing through.
What it does
A real window
Resizable, tabbed, floating or tiled, or a popup panel centred over the desktop that closes when you click away. Switch between the two from Settings or the command line, even while it is open, and open as many windows as you like.
Four views, any size
List, compact, grid and gallery, on Ctrl+1 to Ctrl+4 or the View menu. Zoom from 50 to 300 percent with Ctrl and the scroll wheel. Each folder remembers the view you last picked in it, and grid view can show size, type, modified and permissions under each name.
Preview on Space
Space shows the file under the cursor without opening another app. Pictures zoom and pan, sharp up to 7680 px. Text files show as text, and audio plays with a seek bar, cover art and volume. Arrows move to the next file while the preview stays open.
Built in text editor
Ctrl+E edits config files, notes and scripts up to 1 MB inside Omafile, with find, undo, indenting, line wrap and optional auto save. Saving swaps in a new copy, so a crash never leaves half a file.
Duplicate finder
Find other copies of a file, or every duplicate in a folder, matched byte for byte. Two copies show side by side with previews, and anything you remove goes to the trash.
Archives
Extract here unpacks zip, tar, 7z and rar next to the archive. Compress makes zip, tar.xz, tar.gz or 7z. Both show progress and a cancel button, and neither overwrites anything.
Transcode
Make a copy of a picture or video to share. JPG, PNG, WebP, AVIF or JPEG XL, MP4 or GIF, at the size you pick and without metadata such as where a photo was taken.
Dual panes
F6 splits the window. Tab hops between panes, Ctrl+Shift+C and Ctrl+Shift+M copy and move to the other side with one key.
One View menu
Layout, zoom, sorting and hidden files in one place. Sort A to Z, Z to A, last modified, first modified, largest, smallest or type, in every view. In list view the column headers still work, and clicking one again reverses it.
Pick files for other apps
Register Omafile with the desktop portal and Upload file in your browser opens Omafile instead of the GTK chooser, with the app's filters and a name box when saving.
Live directories
External changes appear the moment they happen. No refresh, no stale listings.
Background transfers
Copies and moves run in a helper process. Anything slow opens a Transfers panel with progress, speed and time left, which minimizes into the status bar. When a name already exists choose replace, keep both, skip or merge, once or for the whole job.
Clipboard and drag and drop
Files move through the system clipboard and by drag and drop, in and out of other apps. Paste an image from the clipboard to save it as a new file.
Trash that counts
Freedesktop trash compatible with GNOME Files, with undo for trash, rename, move, copy and new items. An optional trash can in the bar shows a live count across every trash directory on the system.
Search and filter
Just type to filter the folder you are in. Ctrl+F searches everything inside it, and Ctrl+Shift+F searches your whole home folder.
Thumbnails for everything
Images, videos, PDFs, office files and anything else your system has a thumbnailer for, in every view, sharing a cache with GNOME Files.
Drives
Mount, unmount and eject from the sidebar. Locked LUKS drives unlock with their passphrase, which is never stored, and lock again when you unmount them.
Network drives
Connect to SMB, SFTP, FTP and WebDAV through GVFS. Servers you have used before reconnect in one click, and advertised servers appear alongside them.
A sidebar you can arrange
Drag rows and sections into the order you want. Bookmarks are shared with GNOME Files and the GTK file chooser.
Terminal, editor and agent
Open a terminal in any folder with Ctrl+., send files to the editor you choose, or start your Omarchy default coding agent right there.
Properties
Ctrl+I shows the type, the app that opens it, size, size on disk and times, with an editable read, write and execute grid when you own the file.
Places in the bar
The bar widget opens the file manager, jumps to a place or a drive, watches transfers and empties the trash.
Default file manager
One switch makes folders opened from other apps land in Omafile, and Show in folder opens the containing folder with the file selected. If something takes the folder handler back, Omafile claims it again the next time the shell starts.
Keys
| Keys | Action |
|---|---|
| Enter | Open the selected items |
| Backspace / Alt+Up | Go to the parent folder |
| Alt+Left / Alt+Right | Back and forward, or the mouse side buttons |
| Alt+Home | Go to your home folder |
| Ctrl+L, / or ~ | Type a path |
| F5 / Ctrl+R | Refresh |
| Ctrl+T / Ctrl+W | New tab and close tab |
| Ctrl+Shift+T | Reopen the last closed tab |
| Ctrl+Tab / Ctrl+Shift+Tab | Next and previous tab |
| Alt+1 to Alt+9 | Go to that tab |
| F6 | Split into two panes |
| Tab | Sidebar, or the other pane when split |
| Ctrl+Shift+C / Ctrl+Shift+M | Copy and move to the other pane |
| Ctrl+1 to Ctrl+4 | List, grid, compact and gallery |
| Ctrl+Plus / Ctrl+Minus / Ctrl+0 | Zoom in, zoom out and reset |
| Space | Preview the item under the cursor |
| F9 / Ctrl+B | Show or hide the sidebar |
| Ctrl+H | Show hidden files |
| Ctrl+F, or just type | Search in this folder |
| Ctrl+Shift+F | Search your whole home folder |
| Ctrl+C / Ctrl+X / Ctrl+V | Copy, cut and paste |
| Ctrl+Z / Ctrl+Shift+Z | Undo and redo |
| F2 | Rename |
| Ctrl+E | Edit a text file in Omafile |
| Ctrl+Shift+N / Ctrl+N | New folder, new file |
| Delete / Shift+Delete | Move to trash, delete permanently |
| Ctrl+I / Alt+Enter | Properties |
| Ctrl+D | Bookmark this folder |
| Ctrl+. | Open a terminal in this folder |
| Shift+F10 / F10 | Menu for the current item, or for the folder |
| Ctrl+Comma | Settings |
| F1 | The shortcut list |
| Ctrl+Q | Close the window. Escape closes the popup |
Settings
Change any of these from the bar settings, the plugin's own settings editor, or omarchy bar set xyzlab.omafile <key> <value>.
| Key | Purpose |
|---|---|
| homePath | Default directory when opening Omafile |
| showHidden | Show hidden files and folders by default |
| sortBy | Sort by name, size, modified or type |
| sortDirsFirst | List directories before files |
| confirmDelete | Prompt before deleting items |
| confirmTrash | Prompt before moving items to trash |
| useTrash | Send deleted items to trash instead of deleting |
| dropAction | Drag and drop: auto, ask, copy or move |
| defaultView | Start in list, compact, grid or gallery view |
| rememberFolderViews | Open each folder in the view last picked there |
| viewScale | View size multiplier for rows, icons and grid cells |
| gridCaption1, 2, 3 | Grid captions: none, size, type, modified or permissions |
| editorAutoSave | The text editor saves a second after you stop typing |
| extractOnOpen | Double click and Enter extract archives instead of opening them |
| terminal | Terminal command to open in the current directory |
| editorChoice | Open in editor: empty to ask, omarchy, omafile or own |
| editor | Editor command, used when editorChoice is own |
| agent | Agent command, empty for your Omarchy default agent |
| showTransferBadge | Progress ring on the bar icon while a transfer runs |
| showDrives | Show the Drives section in the sidebar |
| thumbnails | Show image previews and thumbnails |
| previewSize | Space preview size: auto, 1024, 2048, 4096 or 7680 |
| windowMode | Open as a window or a popup |
| mode | files for the file manager icon, trash for a trash can |
| trashConfirm | Ask before a right click empties the trash |
| glyph | Custom icon for the bar widget |