Skip to content

houqp/kiorg

Repository files navigation

Kiorg

Kiorg Logo

Kiorg is a performance focused cross-platform file manager with Vim-inspired key bindings. It is built using the egui framework.

Key Features

  • Lightingly fast rendering and navigation
  • Multi-tab support
  • Vim-inspired keyboard shortcuts
  • Content preview for various file formats
  • Customizable shortcuts and color themes through TOML config files
  • Cross-platform support (Linux, macOS, Windows)
  • Bookmarks for quick access to frequently used directories
  • Single binary with battery included
  • Builtin terminal emulator
  • App state persistence

Screenshots

Help Menu
Built-in help menu with keyboard shortcuts

Theme Selection
Customizable color themes

Installation

Pre-built binaries for all platforms are available on the releases page.

Alternatively, you can build it from source using cargo:

git clone --recurse-submodules https://github.com/houqp/kiorg.git && cargo install --locked --path ./kiorg

Configuration

Kiorg uses TOML configuration files stored in the user's config directory:

  • Linux: ~/.config/kiorg/
  • macOS: ~/.config/kiorg/ (if it exists) or ~/Library/Application Support/kiorg/
  • Windows: %APPDATA%\kiorg\

Sample Configuration

# Sort preference configuration (optional)
[sort_preference]
column = "Name"             # Sort column: "Name", "Modified", "Size", or "None"
order = "Ascending"         # Sort order: "Ascending" or "Descending"

# Override default shortcuts (optional)
[shortcuts]
MoveDown = [
  { key = "j" },
  { key = "down" }
]
MoveUp = [
  { key = "k" },
  { key = "up" }
]
DeleteEntry = [
  { key = "d" }
]
ActivateSearch = [
  { key = "/" },
  { key = "f", ctrl = true }
]