A dual-pane desktop file manager written in Rust, inspired by muCommander. Browse local files and archives, manage transfers, and work in an embedded terminal from one window. The interface uses Slint and runs without a JVM or browser engine.
Rust Commander is an independent project and is not affiliated with or endorsed by the Rust Project or Rust Foundation.
Development preview. This is an independent implementation with full upstream compatibility still in progress. Apple Silicon macOS has been validated interactively; Windows/Linux desktop integration still needs testing. See the parity checklist and validation record for the current scope.
- Downloads and releases
- Features
- Getting started
- Usage
- Desktop appearance
- Keyboard shortcuts
- Remote connections
- Configuration
- Development
- Roadmap
- Contributing
- License
Versioned installers and portable downloads are published on the GitHub Releases page. Each completed release contains separate Apple Silicon/Intel DMGs, a Windows installer and ZIP, a Linux AppImage and DEB, and SHA-256 checksums. The Mac DMGs show first-launch instructions for the current unnotarized builds.
Maintainers: follow Releasing Rust Commander for the one-time setup, manual version input, draft review, publication, and retry procedure. The guide also covers installation and the initial unnotarized Mac and unsigned Windows packages. Draft releases are visible to maintainers until published.
- Dual-pane navigation: an expandable directory tree, tabs, history, editable locations, bookmarks, Unicode type-ahead search, wildcard selection, locked/named tabs, filtering, metadata sorting, stacked panes, adjustable dividers, and single-pane mode.
- Local file operations: copy, native moves/renames where possible, create, Trash, and permanent deletion, with skip, keep-both, recoverable replacement, and folder merging.
- Archive support: create, browse, and extract ZIP, TAR variants, 7z, and compressed streams; edit local ZIP/TAR/7z containers, create/unlock encrypted ZIP and 7z, and browse nested or remote archives. Read additional formats through libarchive.
- Recovery and transfers: guarded local Undo/Redo, storage retention controls, persistent history/queue, verified local file resume, and per-file conflict choices.
- Desktop integration: system file clipboard, mounted drives, clickable breadcrumbs, native file actions, configurable columns/toolbar, and drag and drop for local, archive, and remote entries, with native file drags and deferred remote/archive exports on macOS, Windows, X11, and Wayland, plus unprepared virtual selections between windows in the same process.
- Languages: system language, English, German, and Spanish.
- File tools: batch rename with preview, streaming literal/regex content search with size/date/exclusion filters, local/remote folder comparison with optional quick metadata mode and read-only text diffs, shared comparison/sync presets, checksums, properties, permissions, and split/combine.
- Built-in viewers: UTF-8, UTF-16 and legacy text editing, bounded local large-file paging, images, hex, PDF page navigation, encrypted PDF unlock/rotation/fit-width, streaming text/hex search, a persistent preview pane, and macOS Quick Look.
- Synchronization and workspaces: reviewable local/remote folder synchronization and named sets of pane locations, tabs and layout.
- Multiple windows: restore all window sessions and independent tabs with a shared transfer queue, recovery history and preferences, guarded application-wide quit and a bring-all-forward command.
- Desktop commands: a bookmark explorer, reviewed file attachments over encrypted SMTP, documentation/community/website/donation links and a bounded application event console. See desktop commands.
- Migration: preview and merge supported muCommander XML bookmarks, shortcuts, commands and preferences, with a backup before applying.
- Embedded terminal: a PTY-backed shell in the active local folder; hiding the terminal preserves its session.
- Desktop appearance: macOS, Windows, Ubuntu, and GNOME profiles, installed system fonts, light/dark mode, and native macOS menus and window controls.
- Editor integration: installed-application choices, remembered filename rules, and reviewed external-editor save-back for local/remote files and local archive entries.
- Transfer controls: active pause/resume, live bandwidth limits, bounded automatic retries and durable copy recovery with fixed merge/conflict decisions and replacement originals.
- Remote adapters: checkpointed copies, recursive folder conflicts, saved connection profiles and streaming transfers for SMB2/3, SFTP, FTP, WebDAV, S3, and several cloud services. Validation is limited; see Remote connections.
See advanced search and folder tools for filters, presets, text differences and their limits. See stabilization and integration testing for cross-platform checks and disposable protocol servers. See the next twelve-feature guide for the new workflows and limits, the 0.7 twelve-feature guide for the preceding additions, and the Slint desktop guide for the interface, the 0.5 twelve-feature guide for usage and limits, the 0.4 guide for earlier workflows, and file operations and format support for recovery and archive details. Windows/Linux desktop interactions and live cloud services still need validation.
- Rust 1.92 or newer, including Cargo.
- Native build tools for your operating system.
- libarchive, with
pkg-configon macOS/Linux or vcpkg on Windows.
macOS
Install the Xcode Command Line Tools if needed:
xcode-select --installInstall pkg-config, for example with Homebrew:
brew install pkg-configThe project helper script can use macOS's system libarchive. A Homebrew libarchive installation also works.
Ubuntu / Debian
Install the native dependencies:
sudo apt-get update
sudo apt-get install -y \
build-essential pkg-config libarchive-dev libdbus-1-dev libgtk-4-dev libfontconfig1-dev \
libx11-dev libxfixes-dev libxi-dev libxrandr-dev libxcursor-dev libxinerama-dev \
libgl1-mesa-dev libxkbcommon-dev libxkbcommon-x11-dev libwayland-devOther distributions need the equivalent development packages. Opening and emptying
the desktop Trash also requires gio and a working GVfs Trash backend (on
Ubuntu/Debian: libglib2.0-bin gvfs-backends).
Windows
Install the Visual Studio C++ build tools and Windows SDK for your architecture,
plus vcpkg, and use Rust's MSVC toolchain. For an ARM64 Rust host
(aarch64-pc-windows-msvc in rustc -vV), include the ARM64 C++ build tools
and use the arm64-windows-static-md triplet in both commands below. From a
PowerShell session with the build tools available, set the path to your vcpkg
checkout and install libarchive:
$env:VCPKG_ROOT = "C:\path\to\vcpkg"
$env:VCPKGRS_TRIPLET = "x64-windows-static-md"
& "$env:VCPKG_ROOT\vcpkg.exe" install libarchive:x64-windows-static-mdKeep these environment variables set when running Cargo. In Git Bash, use
./scripts/run.sh to prevent Git Bash's link.exe from shadowing the MSVC linker.
Clone the repository:
git clone https://github.com/ghillert/rust-commander.git
cd rust-commanderOn macOS or Linux:
./scripts/cargo-local.sh run --locked --releaseOn Windows:
cargo run --locked --releaseThe helper script uses a project-local Rust toolchain in .tools/ when one is
present; otherwise it uses your installed toolchain. A fresh clone does not
include a toolchain or build output.
./scripts/cargo-local.sh install cargo-packager --version 0.11.8 --locked --root .tools/packager
./scripts/package-macos.sh
open "target/release/Rust Commander.app"The bundle targets macOS 15+, includes required non-system libraries, and uses an ad hoc signature. DMG creation and the future notarization setup are described in the release guide.
The executable accepts up to two starting directories:
rust-commander [LEFT_DIRECTORY] [RIGHT_DIRECTORY]
Pass them after -- when launching through Cargo. For example, on macOS/Linux:
./scripts/cargo-local.sh run --locked --release -- /path/to/left /path/to/rightDouble-click folders and supported archives to browse them. Double-click a file to open its built-in viewer, or choose Open externally for other formats. Use F5 to copy marked files to the other pane and F6 to move them. The transfer progress bar shows a byte-based percentage for the complete selection, including folders and resumed copies. Unknown sizes use an animated bar. Progress stays below 100% while the operation is still flushing, publishing or verifying. During transfers, the progress area shows the byte count and a live recent speed in B/s, KiB/s, or MiB/s. Resuming a transfer excludes previously copied bytes from the speed measurement. Right-click marked local, remote or archive files and choose Pack files… (also in Operations) to select ZIP, 7z or TAR variants and compression levels, add a ZIP comment, review the selected files, and run packing in the foreground or background. See archive options.
File → Open As… overrides extensions for text, hex, image, PDF or archive viewing without renaming files. Source files support syntax highlighting in the viewer and preview pane, optional JSON/XML pretty views, and an always-available Plain original view. Formatting only changes the display. PDFs support text selection/copying and document search with previous/next matches. See viewer tools. F5 extracts archive entries into new or existing folders with conflict choices. Tools → Archive tools… edits local ZIP/TAR/7z containers or creates/unlocks encrypted ZIP and 7z archives. Nested and remote ZIP/TAR/7z archives support guarded save-back; HTTP and Open As overrides stay read-only. Mod+Z / Mod+Shift+Z undo/redo eligible local operations and Mod+J opens the queue and history. Mod+P toggles preview. Menus follow a task-based order: File, Edit, Mark, View, Go, Bookmarks, Tools, Window, and Help. Dividers separate related groups. Use File for actions on files, Edit for clipboard and undo, Mark for selection, and Go for locations and connections. Window contains tabs, windows, and workspaces; Tools contains search, comparison, archives, and recovery. Settings live in the application menu on macOS and Edit on Windows/Linux.
The interface uses Slint's Cupertino style on macOS, Fluent on Windows, and Cosmic on Linux. macOS keeps its native traffic-light window controls and AppKit menu bar. Windows and Linux keep their desktop window decorations. Slint discovers installed system fonts at runtime. The compact icon toolbar shares the macOS title bar, keeping the native window controls. Breadcrumbs are the normal location display; Mod+L or the pencil button opens the full path for editing. Toolbar actions have hover hints and accessible labels.
Settings → Appearance → Theme and icons → File icons offers System with built-in fallback (default) or Built-in icons only. Native icons load in the background; confirmed generic document icons yield to a specific built-in match. This includes macOS's stock white document templates for PDFs, images, and other types; custom and application-provided artwork is preserved. Remote/archive entries and failed lookups use the curated Material Icon Theme catalog. Fluent regular controls and a colorful Fluent sidebar provide consistent application icons. See the icon guide for coverage, configuration, and asset provenance. File-list thumbnails remain separate from previews.
Open Settings → Appearance → Theme and icons to choose the colors and layout profile. Automatic detects the platform, including Ubuntu's orange accent. Color scheme → Follow system follows the desktop's light/dark preference; Light and Dark overrides are available.
Slint renders the controls in the selected platform style. Widget styles are chosen at build time; the runtime appearance profiles control colors, font size and layout. Cosmic does not reproduce every Ubuntu/GNOME theme. See the Slint guide for style overrides and desktop integration details. Windows/Linux native interactions still need validation on those desktops.
The sidebar button beside Refresh hides or restores the full navigation area, including the optional folder tree, so the file panes gain its width. The same command is available from View → Toggle sidebar and remains available when the toolbar is hidden.
The function-key command bar is visible by default. Change its visibility under Settings → General and its buttons under Appearance → Command bar.
Mod means Cmd on macOS and Ctrl on Windows/Linux. Function keys may require Fn. Command and navigation bindings, including alternate shortcuts, can be changed in Settings → Shortcuts. Search by command name to find a binding.
| Shortcut | Action |
|---|---|
| Tab | Switch pane |
| Arrows / Page Up / Page Down / Home / End | Navigate |
| Enter / Backspace | Open / parent folder |
| Space / Insert | Mark or unmark, then advance one row |
| Shift + arrows or click | Extend selection |
| Mod + click | Toggle an item |
| F1 / F2 / F3 / F4 | Help / rename / view / edit |
| F5 / F6 / F7 / F8 | Copy / move / new folder / Trash |
| Mod + L / F | Focus location / filter |
| Mod + Shift + F | Recursive search |
| Mod + T / W | New tab / close tab |
| Mod + N / Mod + Shift + W | New window / close window |
| Mod + Shift + L | Searchable quick lists |
| Mod + G / Mod + Shift + G | Next / previous quick-find match |
| Mod + A / D / R | Mark all / bookmark / refresh |
| Cmd + Shift + . (macOS) / Ctrl + H (Windows/Linux) | Show hidden files |
| Mod + , | Settings |
| Cmd + Delete (macOS) | Move to Trash |
| Mod + C / X / V | System file copy / cut / paste |
| Mod + Z / Mod + Shift + Z | Undo / Redo |
| Mod + J | Persistent queue and history |
| Mod + P / Mod + Shift + P | Preview pane / macOS Quick Look |
| Drag a selection | Copy/move to panes, folders, tabs, tree, sidebar, or another application |
| Mod + S | Save text |
| Alt + Left / Right | Back / forward |
| Escape | Clear marks/filter or close dialog |
Open File → Connections to configure SMB2/3, SFTP, FTP, WebDAV, S3, HTTP, Dropbox, Google Drive, OneDrive, GCS, or WebHDFS. You can also paste HTTP(S), SFTP, FTP, FTPS, file, SMB, S3 and GCS URIs directly into the location bar. HTTP directory indexes are browsable, SFTP works on all desktop platforms, and FTPS supports both TLS styles. Use Save connection… to add a named sidebar connection. Secrets can be kept in memory or stored in the operating system's credential store. Google Drive, Dropbox and OneDrive support browser OAuth login with PKCE and automatic token refresh, using your own registered client. See OAuth setup; live account validation is still pending.
Remote tests use disposable HTTP, FTP/FTPS, SFTP, WebDAV and SMB servers, including portable native transport fixtures in CI. Private cloud accounts remain untested. Read the connection guide for authentication requirements, service-specific behavior, and transfer limits.
Tab titles and locks, named workspaces, bookmarks, recent locations/files, connection profiles, and preferences are saved in
settings.json in the operating system's application configuration folder.
Invalid settings are reported and preserved. Undo snapshots and operation
records are stored in a sibling history/ directory; full recovery copies can
grow substantially. Retention targets and optional automatic cleanup are available.
Queue recipes are saved separately; passwords and editor drafts are excluded. See the
recovery and queue guide.
Use File → Import muCommander settings… to preview an upstream configuration directory before merging supported XML content. Existing custom settings are preserved; unsupported content is reported. See the migration guide.
Use RUST_COMMANDER_CONFIG_DIR for an isolated configuration. On macOS/Linux:
RUST_COMMANDER_CONFIG_DIR="$PWD/.runtime/config" ./scripts/run.shOn Windows, set $env:RUST_COMMANDER_CONFIG_DIR before running Cargo.
Settings from the earlier muCommander Rust preview are read when the new
configuration file does not yet exist, then saved under Rust Commander's
configuration directory. The original settings are preserved. The old
MUCOMMANDER_CONFIG_DIR variable remains a fallback; RUST_COMMANDER_CONFIG_DIR
takes precedence. Previously saved credentials remain accessible through their
legacy credential-store entries; new credentials use the rust-commander service.
Use debug builds for everyday editing and testing:
./scripts/run.sh
# Optional starting directories:
./scripts/run.sh /path/to/left /path/to/rightOn macOS this creates and runs target/debug/Rust Commander Dev.app, with the
app icon, native menus, and an ad hoc signature. Terminal logs and environment
overrides are retained. To build the bundle without opening a window, use
./scripts/run.sh --build-only. It uses local development libraries; use the
release packaging workflow for an app you intend to distribute.
Compression codecs are optimized even in the development app; application code
keeps normal debugging and quick rebuilds. After pulling changes to compression
profiles, rebuild and restart with ./scripts/run.sh so the running dev bundle
uses the new codecs. See packing performance for
measurements and a repeatable benchmark.
During iteration, run the tests relevant to the change. Run the full tests, Clippy and formatting checks when the feature is ready:
./scripts/cargo-local.sh test --locked --lib test_name
./scripts/cargo-local.sh fmt --all -- --check
./scripts/cargo-local.sh clippy --locked --all-targets --all-features -- -D warnings
./scripts/cargo-local.sh test --locked --all-targets --all-featuresRun ./scripts/cargo-local.sh build --locked --release for releases, executable
size measurements, and optimization/packaging checks. The release profile keeps
its size optimizations. Keep feature flags and build environment overrides
consistent while iterating so Cargo can reuse cached artifacts.
On Windows, use cargo run --locked for development and replace
./scripts/cargo-local.sh with cargo in the checks above.
Release size measurements, compiler settings, and the dependency feature audit are documented in the release size guide.
The Slint UI is compiled from ui/commander.slint by build.rs. SVG assets are
embedded in the executable. See the Slint guide for platform
styles, source layout, input integration and reproducible screenshots.
The CI workflow runs on pushes, pull requests, and
manual dispatch. It checks formatting, then runs Clippy, tests, and release
builds on Ubuntu, macOS, and Windows. Successful platform jobs upload build
artifacts to the workflow run's summary page for 7 days, including an ad hoc
signed macOS app bundle. These are CI builds, not release installers; native
runtime dependencies still apply. The badge above shows the main branch.
The separate Release workflow uses the same
checks, then packages four native targets and assembles a draft GitHub release
with JReleaser. See Releasing Rust Commander.
Local validation is recorded in parity/VALIDATION.md.
The macOS/Windows drag dependency is a small vendored subset of drag 2.1.1.
Its provenance and update instructions explain why the
unused GTK3 backend is excluded. Linux uses native X11/Wayland adapters on the Slint window;
Wayland adapter provenance and licenses are included.
Tests use temporary directories and generated archive/PDF fixtures. The WebDAV integration test opens a loopback-only server; it requires permission to bind a local port but no live service credentials or user files.
Build artifacts in target/, the optional toolchain/cache in .tools/, and
local test state in .runtime/ are ignored by Git. Build output can grow to
several gigabytes; cargo clean removes it, including packaged apps under
target/, and the next build recompiles dependencies.
See recovery, archive save-back and desktop conveniences for the recovery manager, nested/remote edits, parent-row/window shortcuts, manual updates and diagnostics.
The upstream parity checklist tracks 166 actions and 34 protocol, archive, and viewer modules against a pinned muCommander revision. Entries marked partial have working behavior with gaps in functionality, compatibility, or validation.
- Direct SMB2/3, FTP with both FTPS modes, and native SFTP with OpenSSH aliases and host-key review. Cloud adapters, checkpointed copies, and remote folder synchronization are also available. See remote connections.
- Read-only NFSv3 export and Android device browsing. File → Connections can find authorized Android devices and discover SMB, SFTP, FTP, and NFS services via Bonjour. See network and device browsing.
- Packing from local, remote, and archive sources to local or configured remote destinations. Remote output uses local staging and a verified upload. Writable nested and remote ZIP/TAR/7z archives support guarded save-back. See archive operations.
- Read-only text and hex paging and search for local, remote, and archive files, source highlighting in the viewer, editor draft recovery, and local owner/group and ACL editing. Manual update checks, diagnostics, reviewable bug reports, and the application event console are available. See viewers and recovery and support.
- Filesystems and discovery. Windows Registry browsing, oVirt, vSphere, LST virtual archives, and guest disk browsing via libguestfs remain missing. NFS and Android access are read-only, with NFSv3 over TCP and a local ADB server respectively. WebHDFS covers part of Hadoop support. SFTP still lacks SSH jump hosts and proxy commands, certificates, and keyboard-interactive authentication.
- Archives and transfers. HTTP and format-override archives remain read-only. Formats such as RAR and ISO support browsing and extraction only. Archive links and special files have limited support, and folder comparison excludes archive roots. Undo/Redo is limited to journaled local operations.
- Editing and metadata. The built-in editor is plain text and limited to 16 MiB. Reviewed external editing supports files up to 2 GiB. Additional text encodings, image animation, and remote ownership and ACL editing remain open.
- Customization and migration. Additional languages and broader theme, preference, and shortcut coverage remain open. The XML importer handles a subset of upstream bookmarks, keymaps, commands, and preferences. See import limits.
- Real-account OAuth, credential-store prompts, broader NAS and server coverage, live Android and NFS interoperability, and provider-specific transfer recovery and synchronization.
- Explorer drag-and-drop and broader Wayland, screen-reader, mixed-DPI, and terminal compatibility. Nautilus and Dolphin copy drags already have recorded X11 coverage. See the drag-and-drop review and validation record.
- Broader archive format, metadata, encryption, and PDF compatibility fixtures.
Update parity/status.json and parity/OVERVIEW.md, then regenerate the page
without changing its pinned upstream baseline:
python3 scripts/audit-upstream.py --render-onlyTo refresh the upstream inventory from another checkout while preserving recorded
statuses, run python3 scripts/audit-upstream.py /path/to/upstream.
Check the completion gate with python3 scripts/check-parity.py. It currently
returns a nonzero exit status because full parity has not been achieved.
Bug reports, documentation fixes, tests, and pull requests are welcome. Before starting a larger change, open an issue to discuss its scope. Check the parity checklist for existing gaps and include the relevant upstream behavior when proposing compatibility work.
For bug reports, include the operating system, app version, reproduction steps, and expected versus observed behavior. Use disposable sample files where possible, and remove credentials from logs or screenshots. For code changes, run formatting, Clippy, and the relevant tests, and describe the validation performed in your pull request.
Distributed under GPL-3.0-only. See LICENSE for the terms and NOTICE for upstream attribution, third-party licenses and test-fixture notices. Dependencies retain their own licenses.
This project is an independent Rust implementation inspired by muCommander; it is not an official muCommander release.