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
System wide
~# cargo install --path=. --force --root=/usr/local # /usr also works
Packaging status
COPR)
Fedora (sudo dnf copr enable atim/joshuto -y
sudo dnf install joshuto
AUR)
Arch ([yay/paru] -S joshuto
[yay/paru] -S joshuto-git
MacPorts)
MacOS (sudo port install joshuto
Usage
~ $ joshuto
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
Contributing
See docs
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