The file manager your rice deserves.

Fast, keyboard-first and Wayland-native. Miller columns, a preview for every file, and ten themes that reload the moment you save.

yay -S hyprfm-git

Flatpak setup, AppImage download and building from source ↓

Miller columns aurora-from-orbit.jpg

Your arrow keys and Space work here, or tap:

Every frame is a recording of the real app on a headless Wayland session. Nothing here is a mock-up.

Launch to window: 180 ms
Bundled themes: 10
Rebindable shortcuts: 45
Licence: MIT

Watch the tour · 89 seconds

A field study of the Hyprland ricer, and the file manager that finally matches.

Previews for code, Markdown, PDFs, archives and fonts. Space to inspect anything, EXIF included. Split panes, bulk rename, undo, ten live themes, all from the keyboard. Every frame is the real app.

Quick preview

Space peeks at anything.

Select a file, press Space. A full overlay opens with the file and its metadata side by side, and the arrow keys walk the folder while it stays open. Space or Esc closes it.

Quick preview: Photo + EXIF, code-reviewer.jpg

Quick preview: Photo, my-first-rice-1946.jpg

Quick preview: Image info, my-setup-from-orbit.jpg

Quick preview: Music tags, lofi-beats-to-rice-to.mp3

Quick preview: Video, launching-hyprfm.mp4

Quick preview: PDF, thesis-final-FINAL-v3.pdf

Quick preview: PDF, page 3, thesis-final-FINAL-v3.pdf

Photo + EXIF Photos show their camera EXIF: make, model, exposure, aperture, ISO. file: code-reviewer.jpg

Three views · one folder

Same files, three ways to read them.

Switch with Ctrl+1, Ctrl+2 and Ctrl+3 in the app. Here, press 1, 2 or 3. New tabs open in whichever view you were using.

The Wallpapers folder in HyprFM's Grid view

The Wallpapers folder in HyprFM's Miller view

The Wallpapers folder in HyprFM's Detailed view

Thumbnails for images, video and PDFs. Ctrl+scroll resizes from two columns to twelve.

Keyboard first

Leave the mouse where it is.

Everything below was recorded with key presses only: the session it ran in had no pointer at all. Start typing a name and the selection jumps to it.

F3Ctrl+Alt+→Ctrl+CCtrl+V

Two panes, one keyboard.

F3 splits the window. Move focus between panes, copy on one side, paste on the other. Copies run in the background with speed, ETA and a pause button.

DeleteCtrl+Z

Deleted the thesis?

Trash it, then Ctrl+Z puts it back where it was. Undo and redo cover moves, renames and copies, fifty steps deep.

Bulk rename, previewed.

Select several files and press F2. Find and replace (regex included), add text, or number a sequence, and watch the new names before you commit.

Ctrl+L

Paths, with suggestions.

Type a path and pick from what exists. Enter goes there.

Ctrl+TCtrl+Tab

Tabs with their own history.

Back and forward per tab. Ctrl+Shift+T reopens the one you closed.

Ctrl+F

Search as you type.

Recursive search that keeps the window responsive. Uses fd when it is installed.

Ten themes · live reload

Change one line. Watch it repaint.

Themes are small TOML files. Point theme at one in config.toml, save, and HyprFM recolours while you watch. This page uses the same ten palettes: pick one and the whole site switches.

# ~/.config/hyprfm/config.toml
[general]
theme = "catppuccin-mocha"

Plain-text config

Make it yours, in TOML.

One config.toml holds everything: view, sidebar, radii, transparency, every shortcut, and your own right-click actions. It reloads on save. Ctrl+Shift+, opens it in your editor.

# Your own entries in the right-click menu,
# each with an optional shortcut of its own.
[[context_menu.actions]]
name     = "Rate my rice"
command  = "notify-send 'rice level' 'over 9000'"
types    = ["dir", "image/*"]
shortcut = "Ctrl+R"

[[context_menu.actions]]
name    = "Set as wallpaper (swww)"
command = "swww img %f"
types   = ["image/*"]

# Rebind anything. Delete the line to get the default back.
[shortcuts]
quick_preview = "Space"
split_view    = "F3"

Types can be a folder, an extension, or a MIME pattern. %f is the selected file.

HyprFM's context menu on an image, ending with the custom actions Rate my rice and Set as wallpaper — The two actions above, in the real menu. Shift+F10 opens it from the keyboard.

HyprFM's settings: dark mode, theme pickers, font, transparency and corner radius sliders — Prefer sliders? Ctrl+, opens settings for theme, font, transparency and corner radii, and writes the same file. Ctrl+? lists every shortcut and records new keys.

Measured, not claimed

Fast where you feel it.

One process serves every window, previews build on worker threads, and stale previews are dropped when you arrow past them. Opening a folder of 10,000 files takes about 40 ms. Here is how the launch compares, warts included.

Launch to first windowms, lower is better

Second window, app already runningms, lower is better

Memory after opening ~ (PSS)MB, lower is better

Medians of seven runs per app, measured in one session on the author’s laptop (2026-09-20). Since then HyprFM’s launch is down to 163 ms. Method and raw numbers: performance-history.md.

45 defaults · all rebindable

The whole keyboard, on one page.

The same list as HyprFM’s own Ctrl+? dialog.

Navigate

Open Return
Back Alt+Left
Forward Alt+Right
Go to Parent Alt+Up
Home Alt+Home
Refresh F5
Focus Path Bar Ctrl+L
Search Ctrl+F

Tabs & windows

New Tab Ctrl+T
Close Tab Ctrl+W
Next Tab Ctrl+Tab
Previous Tab Ctrl+Shift+Tab
Reopen Closed Tab Ctrl+Shift+T
Open in New Tab Ctrl+Return
New Window Ctrl+Alt+N

Files

Copy Ctrl+C
Cut Ctrl+X
Paste Ctrl+V
Rename F2
New Folder Ctrl+Shift+N
New File Ctrl+N
Move to Trash Delete
Permanent Delete Shift+Delete
Select All Ctrl+A
Undo Ctrl+Z
Redo Ctrl+Shift+Z

View

Quick Preview Space
Grid View Ctrl+1
Miller View Ctrl+2
Detailed View Ctrl+3
Toggle Hidden Files Ctrl+H
Toggle Sidebar F9
Toggle Transparency Ctrl+Shift+B

Split view

Toggle Split View F3
Open in Split View Ctrl+Shift+Return
Focus Next Pane F6
Focus Previous Pane Shift+F6
Focus Left Pane Ctrl+Alt+Left
Focus Right Pane Ctrl+Alt+Right

Tools

Show Context Menu Shift+F10
Open in Terminal Ctrl+Alt+T
Properties Alt+Return
Open Settings Ctrl+,
Edit config.toml Ctrl+Shift+,
Open Keyboard Shortcuts Ctrl+?

Get HyprFM · v0.6.1

Ready when your desktop is.

HyprFM needs a Wayland session. It is built for Hyprland and runs on GNOME and KDE Plasma too. Release notes ↗

Builds the current development version.

yay -S hyprfm-git

Recommended outside Arch. Signed repository; the KDE runtime comes from Flathub at user scope.

flatpak remote-add --user --if-not-exists flathub \
  https://dl.flathub.org/repo/flathub.flatpakrepo
flatpak remote-add --user --if-not-exists hyprfm \
  https://flatpak.hyprfm.soyebjim.me/hyprfm.flatpakrepo
flatpak install --user hyprfm io.github.soyeb_jim285.HyprFM

Self-contained x86_64 build of v0.6.1. No system Qt needed.

curl -LO https://github.com/soyeb-jim285/hyprfm/releases/latest/download/HyprFM-v0.6.1-x86_64.AppImage
chmod +x HyprFM-*.AppImage
./HyprFM-*.AppImage

Run straight from the flake, or add it as an input and use hyprfm.packages.<system>.default. On NixOS, enable services.gvfs for network locations.

nix run github:soyeb-jim285/hyprfm

# flake.nix
inputs.hyprfm.url = "github:soyeb-jim285/hyprfm";

Needs cmake, ninja, qt6-base, qt6-declarative and qt6-svg. Keep --recursive: the UI library is a submodule.

git clone --recursive https://github.com/soyeb-jim285/hyprfm.git
cd hyprfm
cmake -B build -G Ninja -DCMAKE_BUILD_TYPE=Release -DBUILD_TESTS=OFF
cmake --build build --parallel
./build/src/hyprfm

Optional, and picked up automatically when installed

batsyntax-highlighted previews
md4crendered Markdown
popplerPDF pages
ffmpegvideo posters and media info
exiftoolphoto metadata
fdfaster search
gvfsSFTP, SMB and MTP
udisks2mounting drives

The Flatpak, AppImage and Nix builds bundle these already.