/joshuto

ranger-like terminal file manager written in Rust

Primary LanguageRustGNU Lesser General Public License v3.0LGPL-3.0

Linux build

MacOS build

joshuto

ranger-like terminal file manager written in Rust.

Alt text

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

Fedora (COPR)
sudo dnf copr enable atim/joshuto -y
sudo dnf install joshuto
Arch (AUR)
[yay/paru] -S joshuto
[yay/paru] -S joshuto-git
MacOS (MacPorts)
sudo port install joshuto

Usage

~ $ joshuto

Configuration

Check out docs for details and config for examples

  • general configurations
  • for keybindings
  • for opening files with applications
  • 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