v0.4.25 available

HyprFM

A fast, keyboard-driven file manager for Hyprland and other Wayland compositors.

Get HyprFM Source code
  • Wayland-native
  • Keyboard-first
  • MIT licensed
~/Pictures — hyprfm
HyprFM grid view showing image thumbnails and a sidebar with bookmarks
Features

Built for power users who live in the terminal.

Keyboard-first navigation, async file operations, rich previews, and a theme system that respects your Wayland desktop. No bloat, no telemetry.

Three views

Grid, detailed columns, and Miller columns with live previews. Switch with Ctrl+1/2/3 without reaching for a mouse.

Quick preview

Space bar opens a full-screen overlay for images, video, PDFs, text, and audio, with metadata on the side.

Tabs and split pane

Per-tab history and a side-by-side pane for working in two directories at once. Drag between them.

fd-powered search

Full-path search with glob and fixed-string matching, powered by fd. Falls back to a Qt iterator if fd is missing.

UDisks2 devices

Mount and unmount removable drives from the sidebar, directly over DBus — no shell-out to udisksctl.

TOML themes

Live-reloaded TOML themes with Catppuccin Mocha and Latte out of the box, plus configurable radius and fonts.

Screenshots

See it in action.

Grid view of a Pictures folder with image thumbnails
Grid view. Ctrl+Scroll to zoom icon size.
Miller column view showing parent, current, and preview columns
Miller columns. The macOS Finder favorite, keyboard-driven.
Quick preview overlay showing an image with a metadata sidebar
Space bar opens a full preview with metadata.
Settings panel with theme, font, and shortcut controls
Live-reloading settings panel. Themes, fonts, shortcuts.
Install

Pick your distribution.

Four supported install paths. Flatpak is the recommended option for non-Arch systems — it ships everything HyprFM needs in a single sandboxed package.

Signed repository at hyprfm.soyebjim.me. Updates via flatpak update. Requires the Flathub remote at the same (--user) scope so the KDE runtime can be pulled.

# Flathub must exist at the --user scope to provide org.kde.Platform
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