A keyboard-first file explorer.
Written in Rust with egui. One TOML file configures everything.
Website · Download · User guide · Keyboard · Config reference · Build
Soyuz is a file manager built around one promise: the window never stops responding. Every copy, move, delete, extract or checksum runs as a background job with real progress, pause / resume / cancel, conflict handling, history and undo. Listings stream in, folders with 100 000 entries scroll smoothly, and a dead network share cannot hang the window.
- Keyboard first. Every action is in the command palette (
Ctrl+K) and can be bound to any key, chord or sequence. Presets for Explorer, Commander, Finder and Vim habits. - Never blocks. All disk, network and archive work happens on worker threads; the UI thread only draws, and draws nothing while idle.
- Every operation is a job. Queued per device, pausable, cancellable, journaled so it can resume after a crash, and undoable.
- Safe by default. Destructive actions go to the trash first or can be undone; conflicts are always your call.
- No shell backend. Soyuz does not use
shell32,IFileOperation,ShellExecuteor any COM shell API. File-system work goes straight to the kernel (kernel32/ntdll/advapi32on Windows,rustix/libcon Unix), so behaviour is predictable, cancellable and the same on every machine. CI fails the build if a shell API sneaks in. - Fully configurable. Every behaviour has a setting, in the settings window and in a
hot-reloaded
config.tomlthat keeps your comments. - Private. No telemetry. Once a day Soyuz asks GitHub's public release API whether a newer release exists: one request with no identifiers, and a switch in Settings turns it off. Nothing is downloaded or installed until you click.
Browsing
- Details, list, grid (thumbnails, folder mosaics), gallery and Miller-column views, remembered per folder
- Tabs with groups, pinning and tear-off into windows; dual and quad (2×2) panes; saved workspaces
- Breadcrumb omnibar with path editing and completion, live filter, type-ahead, navigation history graph, timeline of recent changes
- Sidebar with favorites, drives, a Portal for pinned folders (drop folders on it), tags, network places, cloud folders, smart folders, and a full-height disk tree
- Archives browse like folders: zip, 7z, tar.*, RAR, ISO / UDF, CAB, deb / rpm (zip can be edited in place)
- Remote locations: SFTP, WebDAV, FTP / FTPS, S3-compatible storage and
\\servershares
File operations
- Background jobs: per-device queueing, priorities, pause / resume / cancel, speed graph and ETA, crash-safe journal
- Conflict dialog with side-by-side comparison, "apply to all", keep both / replace / skip
- Undo / redo for copy, move, rename, trash, new items, archive edits and metadata changes
- Trash, secure wipe, batch rename with live preview, bulk attributes, links and junctions, verified copies
- Drag and drop between panes, tabs, the sidebar and other apps; OS clipboard interop
Tools
- Integrated terminal that follows the current folder
- Preview pane and Quick Look (
Space): code with syntax highlighting, images, Markdown, PDF, Office documents, EPUB, fonts, 3D models, audio waveform and playback, video posters, two-file diff - Built-in text, hex and image editors
- Search by name and content; a background index (SQLite FTS5 + NTFS change journal) with a query language and live smart folders
- System monitor in a tab, in the window and the terminal UI: processes as list or tree with custom columns and text, regex and column filters; CPU, memory, disk, network, GPU and sensor graphs; sockets, services and startup programs; recorded history, snapshots and comparisons; alerts (Windows and Linux; macOS is less tested)
- Disk-usage treemap, folder compare and two-way sync with scheduled profiles, previous versions, duplicate finder, split / join, checksums
- Git status column, renameable color tags, folder colors, drop shelf, recent places
- Automation: sandboxed Rhai scripts, watcher-driven rules, and a
soyuz cp|mv|rm …CLI that queues jobs in the running window - Terminal UI (screenshot):
soyuz-tui [folder]runs inside the terminal you start it from (alsosoyuz --tui) with the same settings, keys, jobs and undo: file operations and their dialogs, the jobs panel, context menus, the preview pane, Quick Look, grid and gallery views with images (kitty, sixel, iTerm2 or half-blocks), the text / hex / image editors, the search bar, smart folders, archives and remote locations, an embedded terminal pane (or suspend to your shell), folder compare and sync with profiles, the AI assistant panel, a settings editor with key bindings and table editing (or$EDITOR), workspaces and the tab history, the shelf, split / join and previous versions, the disk usage treemap and the duplicate finder (full-screen views), device mounting and unlocking in the sidebar (Linux), About, OSC 52 copy over SSH, and a screen-reader mode (plain lines, one pane, the cursor on the focused item)
Optional AI assistant (off by default)
- Works with Anthropic, OpenAI, Gemini or local OpenAI-compatible models (Ollama, LM Studio, llama.cpp, vLLM); bring your own key
- Every change is a dry-run plan you approve; it then runs as a normal, undoable job. Per-folder permissions, redaction, budgets and an audit log
- An MCP server (
soyuz --mcp) so other assistants can drive Soyuz under the same approval rules, and an MCP client for external tools - API keys live in the operating system's credential store, never in
config.toml
Make it yours
- Five color themes with dark and light variants, user theme files, the Windows accent color, Mica / Acrylic backdrops
- English and Turkish UI with locale-aware dates, sizes and sorting; switches live
- Can register itself as the default folder handler for your account (Settings → General), with an exact restore
Accessibility
- Screen-reader support through AccessKit — see docs/ACCESSIBILITY.md
- High-contrast theme, reduced motion, touch density with large targets
- Interface zoom (
Ctrl+=/Ctrl+-/Ctrl+0), visible focus rings, keyboard access everywhere
A few defaults of the Explorer preset. The full list for every preset is in docs/KEYBOARD.md, with a printable one-page version. Every binding can be changed in Settings → Keyboard.
| Action | Shortcut | Action | Shortcut |
|---|---|---|---|
| Command palette | Ctrl+K / Ctrl+Shift+P |
Go to folder | Ctrl+P |
| Back / Forward / Up | Alt+← / Alt+→ / Alt+↑ |
Edit path | Ctrl+L |
| New tab / Close tab | Ctrl+T / Ctrl+W |
Dual pane / Quad | F9 / Shift+F9 |
| Copy / Cut / Paste | Ctrl+C / Ctrl+X / Ctrl+V |
Copy / move to other pane | F5 / F6 |
| Rename / Batch rename | F2 / Ctrl+Shift+R |
Move to trash / Delete | Del / Shift+Del |
| Undo / Redo | Ctrl+Z / Ctrl+Y |
Quick Look | Space |
| Terminal | Ctrl+` |
Activity panel | Ctrl+Shift+J |
| AI assistant | Ctrl+I |
Settings | Ctrl+, |
Download from GitHub Releases. Every file
has a .sha256, and SHA256SUMS-<os>.txt lists them all.
| Package | How |
|---|---|
soyuz-<version>-windows-x64.msi |
Per-user install to %LOCALAPPDATA%\Programs\Soyuz, no admin rights. Optional "Open in Soyuz" folder context-menu entry and PATH entry. |
soyuz-<version>-windows-x64.zip |
Unzip anywhere and run soyuz.exe. Settings go to %APPDATA%\soyuz. |
soyuz-<version>-windows-x64-portable.zip |
Same, plus an empty portable file next to the exe: settings stay in portable-data\ beside it. |
soyuz-<version>-linux-x64.tar.gz |
Unpack anywhere and run soyuz. |
soyuz-<version>-macos-arm64.dmg |
Apple silicon, macOS 11 or later. Open it and drag Soyuz to Applications. Signed with an Apple Developer ID and notarized, so it opens without a warning. Update and restart replaces the app with the next notarized release (when your account can write to its folder). |
soyuz-<version>-macos-arm64.tar.gz |
Apple silicon. Unpack and run soyuz from a terminal; unsigned (right-click → Open the first time). |
Every package also contains soyuz-tui (soyuz-tui.exe on Windows), the terminal UI as a
console program: run soyuz-tui [folder] in a terminal.
Platforms. Soyuz is fully supported on Windows 10 and 11, macOS (Apple silicon) and Linux (x64, Wayland and X11), with native integration on each. Release builds are not code-signed yet.
PDF page rendering needs pdfium.dll next to soyuz.exe or in the config folder (Soyuz
never downloads it; without it PDFs preview as text). Video posters use an ffmpeg found
on PATH.
Everything lives in one file, config.toml:
| OS | Location |
|---|---|
| Windows | %APPDATA%\soyuz\config\config.toml |
| Linux | ~/.config/soyuz/config.toml |
| macOS | ~/Library/Application Support/soyuz/config.toml |
| Portable | portable-data\config.toml next to the executable when an empty file named portable sits beside it |
Edits made in a text editor apply within a second; a parse error is shown with its line
and column and the previous settings stay active. The settings window writes the file back
with toml_edit, so your comments and ordering are preserved.
docs/CONFIG.md lists every key with its type, default and meaning;
docs/config.example.toml is an annotated sample.
Requirements: the Rust toolchain pinned in rust-toolchain.toml (rustup installs it
automatically).
cargo run --release -p soyuz-app # build and start
cargo build --release -p soyuz-app # binary: target/release/soyuz(.exe)
cargo test --workspace # all tests
cargo clippy --workspace --all-targets -- -D warningsWindows — MSVC toolchain. The Windows SDK resource compiler (rc.exe) embeds the app
icon; without it the build still succeeds. Packaging:
./scripts/package.ps1 # dist/soyuz-<version>-windows-x64.zip
./scripts/package.ps1 -Portable # ...-portable.zip
./scripts/package.ps1 -Msi # + .msi (needs WiX v5: dotnet tool install --global wix --version 5.0.2)
./installer/msix/build-msix.ps1 # unsigned MSIX via makeappxLinux — install the windowing, audio and font headers first:
sudo apt-get install pkg-config libasound2-dev libxkbcommon-dev libwayland-dev libx11-dev \
libxcursor-dev libxrandr-dev libxi-dev libgl1-mesa-dev libfontconfig1-devmacOS — Xcode command-line tools. Packaging (Apple silicon only):
./scripts/package-macos.sh # dist/soyuz-<version>-macos-arm64.dmg (+ dist/Soyuz.app)
./scripts/package-macos.sh --ffmpeg-dir ffmpeg-rt # with the FFmpeg runtime in Contents/FrameworksIt builds aarch64-apple-darwin, assembles Soyuz.app (icon, installer/macos/Info.plist),
signs it ad-hoc (or with MACOS_SIGN_IDENTITY, plus notarization with MACOS_NOTARIZE=1)
and writes a compressed disk image with an Applications link; --help lists the options.
A Cargo workspace of thirteen crates with an acyclic dependency graph. Only soyuz-app and
soyuz-term (its optional egui widget) depend on egui; everything else is plain Rust and
unit-tested in isolation.
| Crate | Role |
|---|---|
soyuz-core |
Shared vocabulary: entries, locations, errors, sorting, filtering, locale formatting, cancellation, the config schema, actions and key maps. |
soyuz-fs |
Platform layer over raw OS calls: streaming listings, copy with progress / reflink / sparse, move, delete, trash, links, attributes, ACLs, volumes, watching, launching, shadow copies, USN journal. |
soyuz-jobs |
The operation engine: queue and scheduler, planning, conflict / error prompts, progress snapshots, crash journal, history, undo / redo. |
soyuz-archive |
Archive readers and writers with an indexed virtual file system. |
soyuz-search |
Parallel name / content search, folder sizes, size trees, duplicate detection, folder compare. |
soyuz-index |
Background index (SQLite + FTS5), query language, smart-folder queries. |
soyuz-sysmon |
System monitor logic: rates, history, snapshots, compare, process filter and tree, alerts, the sampler. |
soyuz-vfs |
Remote providers (SFTP, WebDAV, FTP / FTPS, S3) and resumable cross-provider transfers. |
soyuz-term |
Embedded terminal widget (alacritty_terminal + ConPTY / PTY). |
soyuz-ai |
AI providers, credential store, tool catalog with risk classes and dry-run plans, audit log. |
soyuz-mcp |
MCP server (stdio, named-pipe attach, localhost HTTP) with a client trust model, and an MCP client. |
soyuz-script |
Sandboxed Rhai scripting for actions, menus, columns, previewers and automation rules. |
soyuz-appcore |
The frontend-agnostic application core: state, models, commands and actions, services, editors' documents, localization. No GUI toolkit (checked by a test). |
soyuz-app |
The soyuz binary: the egui frontend over soyuz-appcore — shell, views, dialogs, palette, settings and the design system. |
Widgets never mutate state directly: they push commands, one dispatcher applies them, and the same action system backs key bindings, menus, toolbar buttons and the palette.
Soyuz was developed fully with AI. Models wrote the code, the tests and the documentation; a human decided what to build, tried every change in the real app, and kept what felt right.
Please report vulnerabilities privately — see .github/SECURITY.md.
MIT. Bundled fonts (Inter, IBM Plex Sans / Mono, Noto Sans, Cascadia Mono, JetBrains Mono, Source Code Pro) are under the SIL Open Font License 1.1, Hack under the MIT and Bitstream Vera licences, Phosphor icons under MIT; every third-party component and its licence is listed in THIRD-PARTY-NOTICES.md.



