flea

thisisgmMIT活跃维护

基于 Rust 和 Quickshell 的 Wayland 图形文件管理器,专为 Omarchy/Hyprland 桌面打造,主打极快的启动与操作响应。

The fastest GUI file manager on Omarchy.

v0.4.1发布于 2026-11-08 20:14 UTC1,142star +45 / 7 天122fork同步于 2026-11-10 11:50 UTC

怎么上手

由 README 提炼,执行前请确认
omarchy pkg add flea && flea --default
硬件要求按 README 说明

README 未说明 CPU、内存或 GPU 型号要求;性能测试在 minipc 上完成,并给出常驻 GPU 内存数据,说明需要 GPU 渲染。

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

Omarchy 上最快的 GUI 文件管理器,百万文件也能秒开秒搜

基于 Rust 和 Quickshell 的 Wayland 图形文件管理器,专为 Omarchy/Hyprland 桌面打造,主打极快的启动与操作响应。

核心能力

  • 提供列表、分栏、网格、双窗格四种视图并支持标签页
  • 按空格键用 Quick Look 预览图片、PDF、媒体、压缩包和 3D 模型
  • 支持复制、移动、重命名、回收站、压缩解压及撤销操作
  • 内置按输入实时排序的搜索,百万文件首个结果约 166ms
  • 集成 SMB、SFTP、WebDAV、NFS、Dropbox 等网络与共享协议

容易踩的坑

仅通过 Omarchy 包仓库分发,非 Omarchy 系统需从源码构建;执行 flea --default 需在当前会话的终端里运行,文件对话框才会立即切换;从 AUR 的 flea-bin 或 flea-git 切换到官方包时,pacman 会提示移除旧包,需回答 y。

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本v0.4.1
  1. v0.4.1最新正式版2026-11-08 · 2026-11-08 20:14 UTC

    Flea 0.4.1

    • Send files to nearby Apple devices with the AirDrop plugin, off by default, built on owly by @t4t5, and accept incoming files from a notification; it needs a supported Wi-Fi card and the owly package (#369, @netmojo).
    • Show Properties and Permissions in the file menu, with Show Hidden Files and Hide Code Icons moved to the background menu; a customized menu list is kept, and Settings > Menus brings either row back.
    • Copy paths relative to the listed folder with Relative Path in the Copy As flyout (#296, @root1945).
    • List nearby hosts on Network's + when Settings > Places > List nearby hosts when adding a share is on, off by default (#343, @gdeyoung; #32, @nixfred).
    • Select filename text by dragging while renaming, and select a word with a double-click in every text field (#396, @k-kostin).
    • Open or close every marked folder in place with > and <, and toggle a folder from its mark without moving the cursor or a flicker (#412, @muellan).
    • Name a new folder in the Save chooser before it is made (#417, @MrVoicer; #304, @OldJobobo).
    • Enable Save for the caller's file name when the Save chooser starts in an empty folder (#428, @vitonique).
    • Open the first window faster (#381, @chrispository).
    • Play 4K HDR video previews at full frame rate.
    • Stop waking an idle NVIDIA GPU on hybrid laptops while it drives no display, unless FLEA_VK_KEEP_NVIDIA=1 is set (#376, @neuromante).
    • Keep Trash rows drawn while scrolling, on a refresh and when Trash changes (#422, #423, @Loafer19).
    • Draw Columns rows at the chosen Row density (#388, @brianblakely).
    • Keep TUI folder sizes across tab switches, and walk a folder again only after it changes (#390, @brianblakely).
    • Stop Tab and clicks from focusing an empty TUI preview, so q still quits (#389, @brianblakely).
    • Show Git marks on rows inside folders opened in place (#411, @muellan).
    • Make Highlight today's dates take effect, and refresh it at midnight (#427, @muellan; #408, @filip-spaldon).
    • Reach the Flash image row from the keyboard when Flash opens from a drive, and say why the image chooser failed (#416, #415, @simonhull).
    • Close 0.3.12 windows on their own when updating under a Lua-configured Hyprland session (#414, @simonhull).
    • Act on the highlighted row with one Enter in the Find and Filter lines.
    • Give a copied file or folder its final name only once it is whole, so quitting mid-copy leaves no partial file.
    • Find LocalSend peers, send and cancel reliably, including large sends and many files.
    • Finish office document previews, large spreadsheets included, by converting the first 30 pages for the preview.
    • Keep the item count and bytes in step on the extraction card, and show a time left only when it can be estimated.
    • Close the Compress and Extract password cards and the Settings > Plugins Add and Remove cards with a Cancel click.
    • Answer clicks on the Compress format chips, the Encrypt checkbox and the Compress and Extract fields.
    • Decode large PNGs faster in Quick Look, and keep the shown item until the next one is ready instead of fading.
    • Keep a file drag alive across a workspace switch in List, Columns and Grid.
    • Keep the remembered sort direction when switching back to a tab.
    • Draw a grey list cursor in inactive windows.
    • Keep each tag's own hue on every theme, so red, orange and yellow tags no longer draw green on Hackerman.
    • Translate sidebar place names on a live language switch, the Projects row included.
    • Name vulkan-swrast in the user's language when no graphics driver can open a window, and list each refused adapter on stderr.
    • Restore the copy card's spinner, held still and dimmed while a job waits.
    • Open the sign-in fields when an SMB share lists nothing without credentials.
    • Place the Grid cursor the same way every time a filter clears.
    • Show the half-row cue in a small Copy As menu, and restore the word spacing in the HTML Source header.
    • Use one Russian word for Select in
  2. v0.4.02026-11-03 · 2026-11-03 14:36 UTC
    查看更新说明

    Flea 0.4.0

    • Flea's window is drawn by a new GPU renderer built on GPUI, with every view, card, menu, preview and dialog of 0.3.12 carried over. Machines without a working Vulkan driver fall back to software Vulkan and then OpenGL, and when no renderer can open a window Flea says so and points to flea --tui.
    • Flea follows the system language and includes the 50 languages Omarchy offers, with missing strings falling back to English (#43, @eachann1024).
    • On non-Latin keyboard layouts, digits and letter keys reach their bindings by their position on a US keyboard, while Latin layouts keep the printed key and typed text is unchanged.
    • Theme, font and Window Transparency changes reach an open window at once, and window and card corners follow Hyprland's rounding.
    • Ctrl+G searches the contents of files in the open folder (#252, @passport0819).
    • Name search tolerates typos without listing a near match beside a real hit.
    • Folders expand in place in List view (#113, @muellan).
    • A tab can be dragged into its own window or onto another window, and files drag between panes and windows.
    • A tab change closes the filter, search and Quick Look, and the tab strip exposes its controls to accessibility tools.
    • With Start in set to Last folder, Flea restores tab folders and their order (#353, @dyedfox).
    • X carries selected files to another application without moving the pointer (#57, @jesedv).
    • Open agent here starts Omarchy's agent in the folder being shown (#61, @jesedv).
    • Dragging the window's top bar moves the window, and a user@host:/path location opens as a network share (#32, @nixfred).
    • Text in Markdown, Source and code previews can be selected and copied (#332, @axelfontaine; #358, @avillagran).
    • Clicks used to select text in a JSON preview no longer pass through to the listing (#331, @axelfontaine).
    • Image previews replace the cached thumbnail with an original decoded for the preview frame (#371, @letsfkccp).
    • Quick Look images use the display scale when they are decoded (#336, @gjouret).
    • PDF previews reopen without the image-reader crash reported on 0.3.12 (#347, @FortyTwoFifty).
    • Moving to another video in Quick Look starts a fresh player that plays at once (#364, @jessekalil; #365, @aholbreich).
    • 3D models and toolpaths, including STL, OBJ, PLY, 3MF, STEP and G-code, preview in the preview column and Quick Look.
    • Markdown tables size their columns to their contents.
    • Properties on several items shows their combined size, kinds and counts (#316, @muellan).
    • The filter matches every name in a large folder, and clearing a deep filter restores the listing (#315, @muellan; #318, @itsmunzir; #362, @hegjon).
    • List rows update their hover after a re-read, and each pane keeps its own row details.
    • Folder sizes and size sorting no longer walk into a network or rclone mount (#368, @group6digital).
    • Properties waits for a folder's full size and says unknown when none could be read (#172, @nerdislb).
    • Emptying a large Trash starts as a cancellable job while the window stays responsive (#321, @muellan).
    • Delete on a location without Trash offers permanent deletion (#325, @tko76).
    • Copy and move jobs queue while another transfer is running (#363, @jakovius).
    • Send with rclone uploads a file or folder as a checked job with progress and cancellation (#176, @nerdislb).
    • The extract card shows progress while 7z unpacks (#264, @MISTERNEGATIVE21).
    • Extracting onto an rclone mount falls back to a checked copy when no-replace rename is unsupported (#370, @vitonique).
    • Navigation stays responsive after a rename (#265, @mubshrx).
    • Enter and Open open every selected file with its default application (#288, @murilocb; #350, @OldJobobo).
    • Opening a program on a noexec volume or without its run bit says why it could not run (#330, @jesusalcaladev).
    • Open in terminal uses the selected row's folder and opens Ghostty in a fresh instance (#373, @chrispository).
    • F and B page text, Markdown, PDF and office documents in Quick Lo
  3. v0.3.122026-10-17 · 2026-10-17 03:43 UTC
    查看更新说明

    Flea 0.3.12

    • Stock Transparent draws Flea the way Omarchy draws its own file browser, instead of stacking a second transparency on it (#323, @joebaus).
    • A Window Transparency switch changes an open Flea window without a restart (#323, @joebaus).

    Thanks to @joebaus.

  4. v0.3.112026-10-16 · 2026-10-16 01:46 UTC
    查看更新说明

    Flea 0.3.11

    • Markdown and HTML open rendered in Quick Look and the preview column, and r switches Quick Look to Source and back (#204, @fsrodrig).
    • HTML pages preview as still pictures, with scripts and remote content blocked.
    • CSV and TSV files preview as tables in Quick Look and the preview column, and long files page in as you scroll (requested on X).
    • Camera RAW files preview from their embedded JPEG, and the facts line and Properties show the camera, lens, exposure and capture time.
    • Tall previews fill the column above one facts line, and i switches to the full facts table (#208, @iccodes).
    • Quick Look uses the available height for text, code and PDFs, and keeps portrait images in proportion.
    • PDFs scroll as a continuous stack of pages in the preview column.
    • Code previews use theme colours, including Markdown source and fenced code in List and Columns views (#204, @fsrodrig).
    • Language icons are on by default in List, Grid, Columns and Quick Look, and the menu can turn them off.
    • JSON previews format their contents for reading.
    • GIF previews animate while visible.
    • AppImages show their own icons.
    • Quick Look shows font samples and facts.
    • Compare two files in Quick Look, and press y to copy their unified patch.
    • F and B page text and Markdown previews without moving the file cursor.
    • Drag the preview column edge to resize it, and Flea remembers the width.
    • Media keys control a playing preview, and video playback keeps the screen awake.
    • Downloads, Pictures and Videos open newest first until you choose a sort there.
    • A save dialog starts with the file name focused, so Enter saves into the folder shown (#191, @dyedfox).
    • Columns view keeps matching neighbouring columns drawn during navigation and replaces their rows when the new listing arrives.
    • Drag a file onto Trash in the sidebar to trash it, and Undo restores it (#235, @t1nk333r).
    • A mounted ISO image appears in the sidebar with an eject mark, and ejecting it detaches its loop device (#196, @MISTERNEGATIVE21; #234, @martythedev-tech).
    • Visible thumbnail requests wait their turn when every thumbnail worker is busy (#268, @mrphonk).
    • Grid tiles scrolled into view after the window shrinks draw and take clicks again (#294, @dyedfox).
    • Program files, including PIE executables, show the program icon and offer Run on a double-click (#301, @Heus-Sueh).
    • Trash failures say what happened and what was left in place, with technical detail kept in the log.
    • Compare becomes available when the selected file types finish loading.
    • Cancel stops waiting for a blocked FUSE source read and removes the partial copy (#144, @mfilm77; #247, @itsmunzir).
    • Powering off a removable drive checks every mounted sibling volume, including hidden rows (#232, @MiguelDebruyne).
    • The file picker starts with the saved hidden-file setting and honours a per-request override (#313, @choirib).
    • Glassy mode gives file lists their own background opacity while keeping glass on the sidebar and window chrome.
    • Files can be dropped onto favourites and mounted drives in the sidebar, with Undo for moves and copies.
    • Settings keep the newest saved choice when an older refresh finishes later.

    Known issues

    • Local-list startup uses 0.82-0.91 seconds of CPU, compared with 0.77-0.80 seconds in 0.3.10.
    • Long sessions can retain render resources (#151, @marvreichmann).
    • Some office documents fail to preview inside the sandbox.
    • First previews from network shares, large-copy progress and Dual scrolling still have latency work pending.
    • Physical-phone copying and the original HFS+ remount reports still need hardware verification (#144, @mfilm77; #247, @itsmunzir; #232, @MiguelDebruyne).

    Thanks to @iccodes, @fsrodrig, @dyedfox, @MISTERNEGATIVE21, @martythedev-tech, @t1nk333r, @mrphonk, @Heus-Sueh, @mfilm77, @itsmunzir, @MiguelDebruyne and @choirib.

  5. v0.3.102026-10-13 · 2026-10-13 04:16 UTC
    查看更新说明

    Flea 0.3.10

    • Tags in Omarchy's colours, shared with Dolphin. T tags the selection, 1 to 7 pick a colour, the menus gain a Tags row and flyout, a TAGS section can show in the sidebar (off by default), and search finds files by tag, such as the red tag.
    • Pasting a folder onto one with the same name can merge the two, and undo puts both back as they were.
    • Hovering a drag over a folder can open it (off by default), lists scroll while you drag near their edges, names that a stick's exFAT cannot hold are fixed before the copy, and an image on the clipboard pastes as a file.
    • A run card shows what a script, program or AppImage will run and asks before starting it (#174, @dedeanth; #71, @nate8199).
    • Bulk rename edits every selected name at once in your terminal editor, with swaps, bad lines and undo handled (#183, @muellan).
    • Archives take a password for 7z, refuse to extract onto a drive without room, and open ISO images and package files.
    • Encrypted drives unlock and relock in Flea, and flea --unlock does it from a terminal.
    • A new image flasher writes an ISO or disk image to a USB stick and verifies every byte.
    • An unlocked encrypted volume appears in the sidebar with its eject mark (#200, @akitaonrails).
    • Back and forward return the cursor to the row it was on (#235, @t1nk333r).
    • Listing a phone or network share no longer holds up the rest of Flea (#144, @mfilm77; #247, @itsmunzir).
    • A WebDAV share's breadcrumb shows the name you saved it under (#237, @bthome; #246, @aholbreich).
    • A refused WebDAV sign-in says the server did not accept the password, and a failure is no longer guessed as a TLS handshake failure from the address (#238, @bthome; #241, @GreyforgeLabs).
    • Unmount is offered on every mounted volume, so a mounted NTFS drive can be unmounted from the sidebar (#232, @MiguelDebruyne).
    • NFS and SMB shares that the system mounts appear under NETWORK in the sidebar, beside the shares Flea mounts (#257, @citizen-why).
    • The file picker takes a typed path (#191, @dyedfox; #206, @akitaonrails; #256, @karacas).
    • A drop on the Shelf's edge rail lands even after the rail has opened the card (#255, @liri2006).
    • Flea skips Vulkan drivers for graphics cards the machine does not have (#248, @t1nk333r).
    • Properties shows a folder's size and item count (#172, @nerdislb).
    • A thumbnailer installed outside /usr, such as one under ~/.local, now runs inside Flea's thumbnail sandbox (#171, @matirossi93).
    • Quick Look on an image that cannot decode and has no thumbnail yet waits for the row thumbnail and draws it, instead of showing "This image could not be read." (#263, @kevinbsr).
    • Quick Look works when Flea was started with a relative path (#290, @fishandsheep).
    • A copy or move onto a FAT or exFAT drive goes on past links, special files and names it cannot hold, and names what it skipped (#271, @jotapesse).
    • Moving a folder onto an rclone mount that refuses no-replace renames no longer fails, and the move copies across with progress, cancel and the journal (#282, @protoavatar).
    • Replacing a file on phone storage, where there is no Trash, works and Undo restores the old file (#261, @kosmicus).
    • Copy, move or link follows the keys held at the drop, not at the start of the drag (#259, @muellan).
    • The "/" filter narrows the rows in Columns view too (#260, @demostenex).
    • A Shift range made after a scroll starts at the lone selected row, not at the cursor (#286, @dyedfox).
    • Ctrl+V and Shift+Insert paste the first line of the clipboard into the filter and search lines (#287, @dyedfox).
    • A bare digit switches to that tab (#284, @joebaus).
    • With hidden files sorted last, a click on a file picker column header keeps them last, as every view does (#291, @KelpyShades).
    • Grid view's selection band starts from the margin between tiles (#292, @KelpyShades).
    • Flea can remember the view mode of each folder (#293, @carldx).
    • The file picker remembers its sort (#281, @pedrosatin).
    • The window can fade its background alone, le

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译
    • Four views. List, columns, grid and two panes, with tabs and natural sorting.
    • Quick Look. Space previews images, PDFs, text, media, archives and 3D model thumbnails.
    • File operations. Copy, move, rename, trash, compress and extract, with undo. Rename many files at once.
    • Tags. Seven tags in your theme's colours, set with T then 1 to 7, found with tag:red.
    • Search. Ranked results as you type.
    • Network and sharing. SMB, SFTP, FTPS, WebDAV, NFS, Dropbox and Taildrop.
    • Devices. USB and encrypted drives, phones and cameras, mounted from the sidebar.
    • Disk images. Write an ISO or IMG to a USB drive, even compressed or zipped, and verify every byte.
    • Desktop integration. Default file manager, “Show in folder” and Open/Save dialogs.
    • Your settings. Omarchy text sizes, configurable menus, and Default, Vim, Mac or Windows keys.

    Install

    Flea is available only from the Omarchy Package Repository. Install it and make it your default file manager, file chooser and the app opened by Super+Shift+F:

    omarchy pkg add flea && flea --default
    

    Run flea --default from a terminal in your session so file dialogs switch at once. flea --default off undoes it, and Settings > About has the same switch. To try Flea without changing your defaults, run only omarchy pkg add flea. Updates come with omarchy update.

    On an AUR flea-bin or flea-git install, run this and answer y when pacman asks to remove it:

    sudo pacman -S flea
    

    Use Flea for portal Open/Save dialogs without changing your default file manager:

    flea --picker
    

    To try unreleased changes from main, build Flea from source.

    Before removing Flea, undo its desktop integration, then drop the package:

    flea --default off
    omarchy pkg drop flea
    

    Installation details cover dependencies, desktop integration and removal.

    Views

    List for details, grid for photos and clips, columns for browsing with a preview, and two panes (Ctrl+4) for two folders side by side. Flea can remember the view for each folder.

    Space opens Quick Look in any view. Page through a PDF, play media, zoom an image with + and -, or look inside an archive, ISO image or package.

    The shelf in the Omarchy bar holds files you send to it from any menu. Drag them out into any app, or pin the ones you reuse.

    Dragging moves files within a device and copies them across devices. Hold Ctrl to copy, Shift to move, or both to link. Drop files on Trash in the sidebar to trash them, and z brings them back. Drag a file into a terminal to paste its path.

    Transparency follows Omarchy's Window Transparency (Trigger > Appearance > Window Transparency). To set Flea's own, give a value from 0 to 1 in a theme's shell.toml, or in ~/.config/omarchy/shell.toml for every theme:

    [flea]
    background-alpha = 0.34
    

    Performance

    Measured on 2 November 2026 with the 0.4.0 candidate at 8a7fd82f, before the final release cut. Tables show medians; full observed ranges, versions and methodology are recorded with the data.

    100,000 files

    One folder of empty files on btrfs, three runs per app. Flea and Strata use List; the other apps use their installed icon views.

    File managerVersionFirst windowSettledPSSCPU
    Flea0.4.0319 ms0.75 s63.0 MiB0.53 s
    Dolphin26.08.2791 ms5.25 s235.1 MiB8.18 s
    Nautilus51.1.0931 ms20.33 s337.2 MiB21.67 s
    Nemo6.6.4928 ms22.61 s479.3 MiB26.03 s
    PCManFM1.4.0479 ms35.29 s124.4 MiB24.25 s
    Strata1.1.1835 ms1.80 s159.1 MiB1.83 s
    Thunar4.20.10601 ms19.71 s394.9 MiB19.82 s

    Flea's samples are fresh; unchanged rival measurements were reused after matching the machine, session, versions and fixture. First window means compositor registration; settled means 500 ms of process-tree CPU quiet. Neither measures paint or input readiness.

    Search across one million files

    Thirty measured runs per engine, plus two five-round noise batches.

    Search engineVersionFirst resultBackend PSS after indexing
    Flea0.4.0166 ms75.7 MiB
    nd0.2.11617 ms145.6 MiB
    fff0.11.13172 ms221.2 MiB
    FSearch0.3.04938 ms157.0 MiB

    The clock runs from backend searchopen to the first nonempty current-generation IPC rows. Process creation and initial listing are outside it. These are backend measurements, not GUI-open timings. Flea's mixed typed-first quality still trails nd and fff; the results include those losses.

    Compared with 0.3.12

    Three interleaved cold runs per build on the same minipc.

    Metric0.4.00.3.12
    First window348 ms525 ms
    GUI + backend PSS58.6 MiB88.4 MiB
    Resident GPU memory83.4 MiB142.7 MiB

    The baseline is a frozen copy of the 0.3.12 package. PSS and GPU memory are sampled three seconds after mapping.

    Media

    The 2,000-entry fixture contains 1,800 thumbnailable media files and 200 text controls. Flea's first-window, settled and CPU values have three valid samples. Memory has only two, and its observed use is higher than Thunar's and Nemo's. Incomplete measurements for the other apps prevent a complete media ranking. Recorded values and gaps.

    Data and provenance · Method · Historical results

    Keyboard

    Press ? for the full keymap, or , to change settings.

    ActionKeys
    Move / parent / enterj k / h / l
    Open with the default appEnter
    Quick LookSpace
    Select / extend selectionv / Shift + arrows
    Copy / cut / pastey x p, or Ctrl+C Ctrl+X Ctrl+V
    Rename / trash / undo / redor or F2 / dd or Delete / z / Ctrl+Shift+Z
    Tag the selectionT, then 1 to 7
    New folderCtrl+Shift+N
    Search / filter the listf / /
    Enter a path, or jump to a folder by name: or Ctrl+L, then a path or a name
    List / columns / grid / two panesCtrl+1 / Ctrl+2 / Ctrl+3 / Ctrl+4
    Next / previous areaTab / Shift+Tab
    New tab / close tab / switch tabt / w / 1 to 9
    Open terminal / context menuCtrl+T / m
    Show hidden files.
    Zoom an image in Quick Look / fit+ - / 0

    The Windows preset uses Ctrl+Shift+1/2/3/4 for views and Ctrl+Y for redo. See the full key table for preset bindings and pointer actions.

    Scripts and agents

    Every Flea window is titled Flea. To find which folder each one shows, ask it over IPC by its process id:

    for p in $(hyprctl clients -j | jq -r '.[] | select(.class == "com.thisisgm.flea") | .pid'); do
        echo "$p $(flea ipc --pid "$p" call flea path)"
    done
    

    To open a folder and know when a window shows it, run flea /path/to/folder, then poll flea ipc --pid PID call flea path until it prints that path.

    Build

    Requires Omarchy and Rust. See installation details for runtime and optional dependencies.

    cargo build --locked --release --workspace
    ./target/release/flea --gui
    

    Pass a directory to open it, or --select <path> to reveal a file.

    ./tests/run-all.sh runs the headless suites, and the protocol guide documents the backend.

    See PLUGINS.md to write, validate, install and debug a Flea plugin, with a working example for each kind.

    Support

    If this saved you an afternoon, you can sponsor me on GitHub or buy me a coffee.

    Licence

    MIT.

    The AirDrop plugin is built on owly by Tristan (t4t5), MIT, which Flea runs as a separate program.

    The language marks in ui/js/LangMarkPaths.js use simple-icons geometry (CC0 1.0) and remain their owners' trademarks.