Skip to content
0xErwin1Public

About

A fast GPUI file manager for Linux, written in Rust

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Fileflux

A fast GPUI file manager for Linux, written in Rust. Fileflux is part of the Bolt family, built on the same GPUI stack and design system as DBFlux and ReqFlux. It browses, organizes and manages files, and it is careful with them: nothing is deleted or overwritten silently.

Features

  • Tabs, grid and list views, breadcrumbs and an editable path field, with every tab's folder kept live: User guide.
  • Dual pane (F3): two folders side by side, each with its own tabs, and F5 / Shift+F5 to copy or move to the other pane: Dual pane.
  • Sort and filter by type, date, size, name and hidden files: Sort and filter.
  • Search file names in a folder and all its subfolders, with results streaming in and Escape to stop: Search in subfolders.
  • Create, rename, copy, cut, paste and drag and drop, with progress, conflict handling and Undo: File operations.
  • Del moves to the freedesktop Trash; permanent delete always asks first: Trash.
  • Favorites are your GTK bookmarks, shared with Nautilus and Thunar: Favorites.
  • Mount, unmount and eject drives, and browse phones (MTP) and network shares (gvfs): Devices.
  • Open with…, Open in terminal, and a built-in image viewer: Open and terminal, Image viewer.
  • Preferences and open tabs are restored at the next launch: Settings and files.

Install

Fileflux is Linux-only and has no stable release yet.

Prebuilt nightly, with Nix (x86_64-linux; installs the binary as fileflux-nightly):

nix run github:0xErwin1/fileflux/nightly#fileflux-nightly

Use the nightly ref: the hashes of the prebuilt binary are only valid there, not on main. The flake also offers an overlay (overlays.default) that provides pkgs.fileflux, pkgs.fileflux-source and pkgs.fileflux-nightly.

From source, with Nix:

nix build github:0xErwin1/fileflux#fileflux

Known issue: this build currently fails while vendoring the gpui-component git dependency (ReqFlux's source build fails the same way). Until that is fixed, use the nightly package or build with Cargo.

From source, with Cargo inside the Nix dev shell, which provides the pinned toolchain and native libraries:

git clone https://github.com/0xErwin1/fileflux
cd fileflux
nix develop --command cargo build --release --locked
./target/release/fileflux

The repository owner 0xErwin1 is an assumption carried by the flake and the workflows; update it if the repository lives elsewhere. See Development for the direnv setup, checks and scratch-folder practice.

Usage

fileflux [PATH]    open a folder (default: the saved tabs, or your home folder)
fileflux IMAGE     open the image viewer on a picture and its folder

Every option and exit status is in the command line reference. To make Fileflux your default image viewer, see Making Fileflux your default image viewer.

Key shortcuts

Key Action
Ctrl+T / Ctrl+W New / close tab
F3 / F6 Split into two panes / switch pane
F5 / Shift+F5 Copy / move to the other pane
Ctrl+L Edit the path
Ctrl+F Search file names
Ctrl+Shift+F Search in subfolders
Ctrl+H Show or hide hidden files
Alt+← / Alt+→ / Alt+↑ Back / forward / up
F2 Rename
Del / Shift+Del Move to Trash / delete permanently
Ctrl+C / Ctrl+X / Ctrl+V Copy / cut / paste
Ctrl+Z Undo
Ctrl+I Toggle the details panel

All of them, including the image viewer's: Keyboard shortcuts.

Documentation

The documentation index links the user guide, keyboard shortcuts, settings and files, devices, architecture and development. Changes are listed in the changelog.

Contributing

Fileflux moves and deletes people's files, so correctness and safety come first. Read CONTRIBUTING.md for setup, checks and commit conventions.

License

Apache-2.0. See LICENSE.

About

A fast GPUI file manager for Linux, written in Rust

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages