mrkeyoor.com_
Mon 28 Sept 07:43 UTC
Dev Toolsevaluationupdated 28 Sept 2026

flea review

Flea is a keyboard-first graphical file manager built specifically for the Omarchy Linux desktop, with a Rust backend and Quickshell interface. It combines list, grid, and column views with previews, file operations, remote shares, connected devices, and an optional XDG file chooser.

Verdict

Our Flea build finished in 15 seconds, but the test run exited 101 with 1,744 of 1,748 tests passing, so commit f304c38 is promising rather than clean. Omarchy users who want a fast, keyboard-led GUI should try the reversible package setup on non-critical files. Wait if you use another desktop, depend on huge archive extraction, or require every filesystem ownership test to pass in a fresh container.

We ran it

Lab card: what happened when we ran fleaScreenshot of flea (omarchy.org)
Install✓ · 7s1 packages
Build✓ · 15s
Tests✗ · 39s1744 passed · 4 failed of 1748 (cargo test)
Repo667 files~96,136 lines of source · 17.7 MB · 1 CI workflows · tests dir

Answers from our run

Does flea build from source?

Dependencies installed in 7 seconds (1 packages), and the build succeeded in 15 seconds. We cloned commit f304c38 into a clean Debian container with 3 CPUs and no project-specific setup.

Do flea's tests pass?

Not all of them: 1744 of 1748 passed and 4 failed when we ran the project's own test command (cargo test). Some failures need services or credentials a bare container does not have.

Who should not use flea?

Plain Arch or other Linux desktops: the installation guide says Omarchy and Quickshell are hard dependencies and that Flea will not install on a plain Arch box.

What are the alternatives to flea?

Nautilus, Dolphin, Thunar. Our Flea build finished in 15 seconds, but the test run exited 101 with 1,744 of 1,748 tests passing, so commit f304c38 is promising rather than clean.

Setup3/5Fast Rust build, but Omarchy and desktop services are required
Docs5/5Install, undo, integrations, benchmarks, and limits are explicit
Community3/5580 stars and active September work, with 66 issues and PRs
Maturity2/5Young v0.3.5 release and four sandbox test failures

Who it’s for

Omarchy users who want Vim-style navigation in a graphical file manager.
People who browse large folders and want rows and thumbnails loaded on demand.
Users who want one interface for local files, SMB or SFTP shares, phones, and cameras.
Developers willing to test a young Rust and Quickshell desktop application against their own files.

Who it’s NOT for

Plain Arch or other Linux desktops: the installation guide says Omarchy and Quickshell are hard dependencies and that Flea will not install on a plain Arch box.
Terminal-only users: the README says the terminal interface is not implemented yet.
Anyone who must drag files across a Hyprland workspace switch: the documented behavior says the drag ends when the workspace changes.
Users extracting very large archives inside the app: issue 211 reports a 30-second CPU limit killing a valid 55 GiB Zip64 extraction.
Teams requiring a clean test suite before rollout: our sandbox recorded 4 failures among 1,748 tests.
SMB users who cannot tolerate listing errors after a successful mount: issue 194 reports that behavior when the share username matches the desktop login.

Setup reality

Our commit f304c38 checkout had 667 files, about 96,136 source lines, and occupied 17.7 MB. The Rust install succeeded in 7 seconds with 1 package, and the build passed in 15 seconds. Tests failed with exit 101 after 39 seconds: 1,744 passed and 4 failed out of 1,748.

The intended binary package needs Omarchy and Quickshell 0.3.1 or newer. Building from source also needs Rust; the package route uses makepkg, pacman, Omarchy UI paths, D-Bus services, and XDG portal files. Network shares, phone access, previews, and archive handling each rely on optional system packages.

Making Flea the default changes per-user MIME, D-Bus, Hyprland, and portal configuration. The project provides flea --default off and flea --picker off, which should run before package removal. Source builds use the checkout directly, so uncommitted files become part of the package.

Three views and one device rail target Omarchy users

Flea combines a Rust file backend with a Quickshell interface that follows the current Omarchy theme. List, grid, and column views sit alongside tabs, natural filename sorting, and Quick Look for images, PDF pages, text, media, and archives. The device rail can expose USB drives, phones, cameras, and network locations. This is a graphical file manager with keyboard habits, not a terminal browser wearing a window.

The project is unusually direct about its home turf. Omarchy and Quickshell are hard dependencies, and the installation guide says it will not install on plain Arch. Our checkout reinforces the size of the commitment: commit f304c38 contained 667 files and roughly 96,136 source lines. Flea also integrates with Hyprland bindings, D-Bus, MIME handlers, and XDG portals, so porting it to another desktop would be real engineering work.

The 15-second build passed, while 4 tests did not

Our sandbox installed the Rust project in 7 seconds with 1 package, then completed the build in 15 seconds. The checkout occupied 17.7 MB before that work. Those are encouraging numbers for a desktop application with file operations, previews, network mounts, device support, and a portal backend. The repository also has a tests directory and one CI workflow file, though it has no Dockerfile.

The test command failed with exit code 101 after 39 seconds. Across the run, 1,744 tests passed and 4 failed out of 1,748. The tail names a_file_carries_its_owner_and_the_line_puts_it_on_the_wire_escaped and a_path_resolves_through_its_own_uid_and_a_missing_path_resolves_to_nothing; one binary summary shows 872 passed and 2 failed. The log does not establish why all 4 failed, so we cannot label them as container quirks or product defects.

What happened when we ran it

We ran commit f304c38 in a fresh, unprivileged container with 3 CPUs and 12 GB of RAM. Installation succeeded in 7 seconds, the build succeeded in 15 seconds, and the suite ended unsuccessfully after 39 seconds. A 99.8% pass rate still leaves a red test command, especially when the named cases touch ownership and path resolution inside a file manager.

The passing tail included cases for copying a socket tree, handling vanished metadata rows, continuing a batch after one item fails, and returning nothing for a missing search root. That breadth suggests the backend tests unhappy paths rather than only button clicks. Still, our lab did not open the Quickshell interface, mount a phone, browse SMB, or exercise the XDG chooser. The 1,748-test result measures the code path the repository exposed, not the complete desktop experience.

Default mode changes four areas of user configuration

The recommended flea-bin package is prebuilt for x86_64 and aarch64. A slower repository package lets Omarchy review, build, and sign the same release, while flea-git follows the main branch. The docs tell users to install only one because all variants own /usr/bin/flea. Source packaging reads the current checkout directly, which makes a clean worktree important before makepkg -si.

Running flea --default can modify the user's MIME association, a D-Bus service entry, Hyprland bindings, and XDG portal preference. That is how folders, “Show in folder,” a keyboard shortcut, and file dialogs reach Flea. Removal through pacman cannot clean those home-directory choices. Run flea --default off and flea --picker off before uninstalling, or follow the documented manual cleanup for the leftover files.

Large archives and some SMB mounts remain sharp edges

Issue 211 describes a 55 GiB Zip64 archive that extracts with 7z but dies inside Flea. The report traces it to a 30-second CPU limit shared with thumbnail jobs and says the same limit affects either archive tool. The app then shows a generic failure because the killed process leaves empty standard error. Anyone handling backup-sized archives should use an external extractor until that path changes.

Issue 194 concerns a mounted, writable SMB share that Flea still says cannot be read when the share username matches the desktop login. The report shows command-line SMB and GIO access working outside Flea. Another documented constraint is drag and drop across Hyprland workspaces: changing workspace ends the drag, so the target must already be visible. These are specific workflow limits, not reasons to dismiss local browsing.

v0.3.5 is moving quickly for a September project

GitHub showed 580 stars, 66 open issues and pull requests, and a last push on September 25, 2026. Release v0.3.5 shipped that day with changes to menu speed, Quick Look, trash behavior, failed-copy undo, PDF paging, and tap handling. The release notes also name a Chromium New Tab Page drop refusal as a known issue. Active pull requests continued through September 27.

Flea is already more considered than its v0.3.5 label suggests, particularly in its reversible desktop setup and unusually detailed installation notes. The failed 39-second suite prevents a blanket recommendation. If you live in Omarchy, its keyboard model and lazy directory work are worth testing. Keep Nautilus, Dolphin, or Thunar available until Flea passes your ownership, network-share, archive, and portal cases.

Alternatives

ProjectWhat it isPick it when
NautilusGNOME's established graphical file manager and the stock directory handler on many desktops.pick this instead when broad desktop integration matters more than Omarchy styling and keyboard-first control.
DolphinKDE's feature-rich file manager with mature split views and desktop integration.pick this instead when you want a configurable general Linux file manager outside Omarchy.
ThunarXfce's lightweight graphical file manager with a long maintenance history.pick this instead when low complexity and wider desktop compatibility matter more than Flea's previews and device rail.

What people are saying

  1. [velocity-scout] thisisgm/flea

Sources

  1. Flea README
  2. Flea installation guide
  3. Flea v0.3.5 release
  4. Issue 211: large archive CPU limit
  5. Issue 194: SMB listing error

More dev tools reviews

kitter · sonicloud_opensdk · cn · GSYVideoPlayer · fyne · agent-manager · the whole board →