joshuto

ranger-like terminal file manager written in Rust.

Dependencies

• cargo
• rustc
• xsel/xclip/wl-clipboard (optional, for clipboard support)

Also see Cargo.toml

Building

~$ cargo build

Installation

For single user

~$ cargo install --path=. --force

System wide

~# cargo install --path=. --force --root=/usr/local     # /usr also works

Packaging status

Fedora (COPR)

sudo dnf copr enable atim/joshuto -y
sudo dnf install joshuto

Arch (AUR)

• release

[yay/paru] -S joshuto

• build from source

[yay/paru] -S joshuto-git

MacOS (MacPorts)

sudo port install joshuto

Usage

~ $ joshuto

Configuration

Check out wiki/Configuration for details and config/ for examples

joshuto.toml

• general configurations

keymap.toml

• for keybindings, please take a look at src/util/key_mapping.rs for non-printable keys
• for commands, please take a look at src/commands/commands.rs

mimetype.toml

• for opening files with applications

theme.toml

• color customizations

Contributing

See wiki/Contributing

Features/Bugs

Please create an issue :)

TODOs

• Migrate to tui-rs
• Tab support
• Ctrl/Shift/Alt support
• Asynch File IO (cut/copy/paste)
• Built-in command line (in progress)
  • Currently implementation is kind of janky
• File previews (in progress)
  • Waiting for tui-rs to support parsing ANSI color codes
• Tab autocomplete (in progress)
• Bulk rename