/00 — boot sequence

Hello.

cd ../open-source

aiyu-ayaan/Findex-Rust

Findex-Rust

Fast, native file explorer in Rust and Slint with a Windows 11 File Explorer look, for Linux and Windows. Desktop edition of Findex.

  • active
  • 1 stars
  • Rust
  • Apache-2.0
  • pushed yesterday
Findex-Rust preview

// readmeaiyu-ayaan/Findex-Rust

Findex logo

Findex for Linux and Windows

CI Release Last commit

Rust Slint Linux Windows

The desktop edition of Findex, the Android file explorer. A fast, native file explorer written in Rust that looks and feels like the Windows 11 File Explorer, on Linux and on Windows: tabs, every Explorer view mode, fuzzy search across subfolders, thumbnails, a Folder Options window, light and dark themes with translucent Mica-style surfaces, and one transfer window for every copy, move and delete. It can be set as the default file manager, so folders and Super+E open in Findex. It also pairs with Findex on your phone: phone storage shows up next to your drives, and files go both ways over an encrypted link.

Status: early alpha. Linux is built and tested end to end (GNOME, X11). The Windows build compiles in CI but has not been run on real hardware yet. Mica, the Win+E hook and default-app registration on Windows are still open (see the roadmap).


📸 Screenshots

Details view, dark theme   Details view with check boxes, light theme

Large icons with thumbnails   This PC with drives, network locations and unmounted partitions

Fuzzy search across subfolders   Windows 11 style context menu

Transfer window while copying   Transfer window when done   Folder Options window

All screenshots come from the end-to-end UI test runs (tests/ui).


✨ Features

Explore

  • Windows 11 layout: tabs merged with the title bar, command bar, breadcrumb address bar, navigation pane, details pane, status bar.
  • All eight Explorer views: extra large, large, medium and small icons, list, details, tiles, content (Ctrl+Shift+1 to 8). Every view is virtualized, so huge folders scroll smoothly.
  • Tabs: new, close, switch (Ctrl+T, Ctrl+W, Ctrl+Tab), middle-click to close, open a folder in a new tab, restore tabs at startup.
  • Streaming listing: getdents64 on Linux and FindFirstFileExW (large fetch) on Windows. First rows show before the folder finishes loading.
  • Natural sort (file2 before file10) by name, date, type or size, folders first.
  • Keyboard first: arrows, Home/End, PageUp/PageDown, Shift/Ctrl selection, type-ahead, Enter, Backspace, Alt+arrows, F2, F5, Delete, Ctrl+L, Ctrl+F, Ctrl+A, Ctrl+Z.
  • Thumbnails for images, shared with Nautilus and Dolphin through the freedesktop thumbnail cache, generated visible-first.

Search

  • Fuzzy search (the nucleo matcher from Helix) over the current folder and all subfolders. The walk is parallel and breadth-first, and results stream in ranked by match quality.
  • Symbolic links and pseudo file systems (/proc, /sys, ...) are never entered.

Files

  • One transfer window for copy, move, trash and delete: large "% complete", a speed graph that fills with progress, a progress bar, speed, time and items remaining, and pause, resume and cancel.
  • Reflink (FICLONE), then copy_file_range, then buffered copy on Linux. Same-volume moves are renames.
  • Name clashes keep both (a - Copy.txt) and nothing is overwritten. Folders can't be copied into themselves.
  • Delete goes to the Trash, with Undo. Shift+Delete asks first, with the safe button focused.
  • New folder and new text document, rename, copy as path, cut and paste between tabs.

Phones (Findex Link)

  • Pair with Findex for Android: the phone shows under Phones in the navigation pane, and its storage (with usage bars) on This PC.
  • Phone folders open in normal tabs. You can open files, copy and paste both ways, rename, make folders and delete (to the phone's Recycle Bin).
  • Send to phone on any file. Files from the phone land in Downloads/Findex, and text from the phone goes to the clipboard.
  • Encrypted with TLS. Each side pins the other's certificate after a one-time pairing, where both screens show the same 6-digit code. Turn it off in Options > Findex > Phones.

Drives

  • This PC shows mounted volumes, removable drives, network shares (NFS, SMB, SSHFS, GVfs) and unmounted partitions (click to mount through udisks2), with usage bars and a low-space warning.
  • Every free-space probe is timeout-guarded, so a dead network share can't freeze the app.

Look and feel

  • Light and dark themes that follow the system, or are set by hand.
  • Transparency effects: translucent Mica-style window and layers. On Windows 11 it asks for the real Mica backdrop.
  • Fluent System Icons, Inter / Segoe UI Variable, 4 px grid, 100 / 167 / 250 ms motion that turns off with reduced motion, visible focus rings, and colour never used as the only signal.

Folder Options (like Explorer's)

  • General: open to Home or This PC, open folders in the same or a new tab, single- or double-click to open.
  • View: never thumbnails, full path in the title, hide empty drives, hide known extensions, restore tabs, drive letters and mount points, status bar, check boxes, hidden files, typing goes to the search box or selects, navigation pane sections.
  • Search: subfolders, hidden files.
  • Findex: theme, transparency, compact view, default file manager.

🔗 Findex ecosystem

Desktop (this repo)Android
AppFindex for Linux and WindowsFindex for Android (Material 3 Expressive)
Sees the other devicePhones in the navigation pane and on This PCComputers tab on the phone's Home: this PC opens in the phone's Explorer
Copy both waysCopy, paste or Send to phoneCopy, paste or Send to computer (lands in Downloads/Findex here)
StreamingPhone files open on the PCVideos and music on this PC stream to the phone with seeking

Pair a phone. Install Findex on the phone. Here, choose See more (⋯) > Pair a phone and scan the QR code with Home > Computers > Scan QR code on the phone. That's all: the QR code carries this PC's identity, so nothing needs comparing. Without a camera, tap this PC under Nearby on the phone, or use Pair by address. Then check that both screens show the same 6-digit code and accept on both.

The design is modelled on Apple's AirDrop and Continuity: a long-term identity certificate per device, mDNS discovery (_findex._tcp), TLS with certificate pinning, numeric-comparison pairing with hash commitments, and a bearer token per pairing. The protocol and the comparison with Apple are in development/docs/10-ecosystem.md. Paired phones can reach only your Home folder and the Downloads/Findex inbox, and only while Findex is running.


⬇️ Install

Linux (x86_64), no root needed. This installs the AppImage, the Findex logo at every size and a menu entry in your home folder:

curl -fsSL https://raw.githubusercontent.com/aiyu-ayaan/Findex-Rust/master/scripts/install-linux.sh | sh

Add -s -- --set-default to also make Findex the default file manager (folders and Super+E on GNOME open Findex). Use -s -- --channel beta for beta builds, -s -- --version 0.0.1 for one release, or -s -- --uninstall to remove it. Run it again to update. The .deb and the Windows build are on the Releases page.

Default file manager from the app: See more (⋯) > Options > Findex, or findex --set-default. Undo with findex --repair, which restores the previous handler.


🧭 How it works

graph TD
    app["findex-app<br/>window, tabs, listing model, shortcuts"] --> ui["findex-ui<br/>Slint UI, theme tokens, icons"]
    app --> ops["findex-ops<br/>copy, move, trash, delete queue"]
    app --> scan["findex-scan<br/>parallel fuzzy search"]
    app --> thumbs["findex-thumbs<br/>freedesktop cache, scheduler"]
    ops & scan & app --> platform["findex-platform<br/>one API"]
    platform --> linux["findex-platform-linux<br/>getdents64, mountinfo, udisks2, reflink, xdg"]
    platform --> win["findex-platform-win<br/>FindFirstFileExW, drives, Mica, shell"]
    app & ops & scan --> core["findex-core<br/>entries, natural sort, history, fuzzy"]
    app --> link["findex-link<br/>Findex Link: identity, pairing, TLS server and client, mDNS"]

The UI thread never touches the disk. Listing, sorting, search, thumbnails, drive probes and file operations run on worker threads, and every one of them can be cancelled. Platform code lives only in the findex-platform-* crates.

Design docs are in development/docs: architecture, features, platform integration, performance budgets, cleanup and thumbnails, UI design language, roadmap and releases.


🚀 Build

Dev flavour. Every debug build (cargo run), or a release build with --features dev, is the dev flavour. It runs next to an installed Findex without touching it:

  • It keeps its own settings, paired phones and Link identity in findex-dev instead of findex under the config dir.
  • It uses its own single-instance socket, so it never hands its window to the installed app.
  • It doesn't claim org.freedesktop.FileManager1 and refuses --set-default.
  • It prefers Link port 47101, and shows "Findex Dev" in the title and "(dev)" to phones.

Release builds without the feature are the normal flavour.

# Linux needs: libfontconfig1-dev libxkbcommon-dev libwayland-dev libx11-dev libgl1-mesa-dev
cargo run -p findex-app -- ~/Documents      # run
cargo test --workspace                      # unit tests
tests/ui/run.sh                             # end-to-end UI suites (needs a display; CI uses Xvfb)
cargo build --release -p findex-app && scripts/package-linux.sh   # AppImage + .deb in dist/

findex --search ROOT QUERY runs the fuzzy search from the command line and prints the time it took.

🏷️ Releases

Same flow as Domus: put !alpha, !beta, !stable, !fix, !feat or !major at the start of a commit subject on master. That opens a release PR, and merging the PR builds and publishes. Details: development/docs/09-release.md.

Licence

Apache License 2.0. See LICENSE.

// stack

  • Rust
  • Cross Platform
  • Desktop APP
  • File Explorer
  • File Manager
  • Fluent Design
  • Fuzzy Search
  • GUI
  • cross-platform
  • desktop-app
  • file-explorer
  • file-manager
  • fluent-design
  • fuzzy-search
  • gui
  • linux
  • rust
  • slint
  • tabs
  • thumbnails

// specs

status
Working
type
Open Source
year
2026
language
Rust
license
Apache-2.0
stars
1
branch
master

Repository data last synced