Skip to content

Repository files navigation

Explorer

A keyboard-driven file explorer for Windows, built with Tauri v2, React, and TypeScript.

Explorer Demo

Installation

Scoop (recommended)

scoop bucket add yannick https://github.com/YannickHerrero/scoop-bucket
scoop install yannick/explorer

This pulls the portable bundle (explorer-app.exe + WebView2Loader.dll) into ~\scoop\apps\explorer\ and adds a Explorer shim on your PATH. No admin needed. Requires the system-installed WebView2 runtime (default on Windows 11).

Standalone installers

Direct downloads from the Releases page — pick whichever suits:

  • explorer-portable.zip — same bundle scoop uses, ~5 MB.
  • Explorer_x64-setup.exe — NSIS installer with the offline WebView2 bootstrapper, ~200 MB.
  • Explorer_x64_en-US.msi — MSI variant for managed installs.

Features

  • Column view — macOS Finder-style hierarchical columns
  • Keyboard-first — Full keyboard navigation; optional Vim bindings (hjkl + y/x/p)
  • File operations — Rename, new file/folder, duplicate, move to trash, copy / cut / paste
  • Drag and drop — Move files between columns or onto pinned sidebar folders
  • Search — Recursive walkdir-based search across the current folder or home
  • Preview pane — Real text, code, image, audio, video, and PDF preview
  • Tag system — Color-coded tags; click a tag in the sidebar to filter
  • Quick open — Open files in Notepad (Ctrl+E) or the current folder in Windows Terminal (Ctrl+`)
  • Pinned folders — Right-click any folder in the sidebar to pin it to Favorites
  • WSL & drives — All mounted drives and WSL distros surface automatically in the sidebar
  • Themes & density — 5 themes (Sage, Paper, Stone, Clay, Ink dark) × 3 densities (Compact / Comfortable / Spacious)
  • Toggleable previewCtrl+Shift+P
  • Show hidden filesCtrl+H
  • Auto-update — Manual check from Settings; updates fetched from GitHub releases
  • External config reload — Backend watcher emits a config-changed event whenever config.json is rewritten by another process (e.g. a theme orchestrator), and the React frontend re-applies the new state live

Tech Stack

Layer Technology
Desktop framework Tauri v2
Frontend React 19 + TypeScript
Build tool Vite 7
Backend Rust
Fonts IBM Plex Sans, Newsreader, JetBrains Mono

Getting Started

Prerequisites

Development

bun install
bun tauri dev

Building a Windows release from WSL

make install   # cross-compile to x86_64-pc-windows-gnu and install the .exe

See Makefile for the individual targets.

Keyboard Shortcuts

Navigation

Key Action
Navigate between columns
Move selection within column
Home End First / last item in column
PgUp PgDn Jump 10 items at a time
Ctrl+[ Back
Ctrl+] Forward

File operations

Key Action
Enter Open
Space Quick Look
R Rename
Ctrl+N New file
Ctrl+Shift+N New folder
Ctrl+D Duplicate
Ctrl+C / Ctrl+X / Ctrl+V Copy / Cut / Paste
Ctrl+Shift+C Copy full path (quoted)
Del (or Ctrl+Del / Ctrl+Backspace) Move to Trash
Ctrl+T Add tag

Open in…

Key Action
Ctrl+E Open file in Notepad
Ctrl+` Open folder in Windows Terminal

Palettes & overlays

Key Action
Ctrl+K Command palette
Ctrl+P Go to folder
Ctrl+F Search
Ctrl+B Toggle sidebar
Ctrl+Shift+P Toggle preview pane
Ctrl+H Toggle hidden files
Ctrl+, Settings
Ctrl+/ Keyboard shortcuts
Esc Dismiss

Vim mode (Settings → Keyboard)

When enabled, the following bare-letter shortcuts are active:

Key Action
h j k l Left / down / up / right
y Yank (copy)
x Cut
p Paste

Project Structure

src/
  components/     UI components (Chrome, Columns, Sidebar, PreviewPane, StatusBar)
  overlays/       Modal overlays (CommandPalette, SearchOverlay, Settings, TagPicker, PromptModal, Cheatsheet, ContextMenu, FolderPalette)
  hooks/          React hooks (useKeyboardNav, useRealFileTree, useConfig, useInit, useTheme, useSidebarDirs)
  data/           Command and shortcut catalog
  themes/         Theme and density token definitions
  icons/          SVG icon library
src-tauri/
  src/commands/        Rust backend (fs operations, search, config, init)
  src/config_watcher.rs  notify-based watcher on the app config dir; emits
                       a `config-changed` Tauri event to the frontend on
                       external rewrites of config.json

License

MIT

About

A better, keyboard driven file explorer built in rust

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages