joshuto

ranger-like terminal file manager written in Rust.

Dependencies

• cargo >= 1.55
• rustc >= 1.55
• xsel/xclip/wl-clipboard (optional, for clipboard support)
• fzf (optional)
• zoxide (optional)

Also see Cargo.toml

Building

~$ cargo build

Installation

For single user

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

For single user with cargo

~$ cargo install --git https://github.com/kamiyaa/joshuto.git --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

Gentoo (gentoo-zh)

sudo eselect repository enable gentoo-zh
sudo emerge -av app-misc/joshuto

MacOS (MacPorts)

sudo port install joshuto

Usage

~ $ joshuto

See docs#quit for exiting into current directory and other usages

Configuration

Check out docs for details and config for examples

joshuto.toml

• general configurations

keymap.toml

• for keybindings

mimetype.toml

• for opening files with applications

theme.toml

• color customizations

bookmarks.toml

• bookmarks

Contributing

See docs

Bugs/Feature Request

Please create an issue :)

Features

• Tabs
• Devicons
• Fuzzy search via fzf
• Ctrl/Shift/Alt support
• Bulk rename
• File previews
  • See Image previews for more details
• Exit to current directory
• Asynch File IO (cut/copy/paste)
• Custom colors/theme
• Line numbers
  • Jump to number
• File chooser
• Trash support

TODOs

• [x] Built-in command line
  • Mostly working
  • Currently implementation is kind of janky
  • [ ] Tab autocomplete (in progress)