kamiyaa/joshuto

Joshuto is a file manager that runs entirely inside a terminal window. Instead of clicking through folders in a graphical file explorer, you use keyboard shortcuts to navigate your filesystem, open files, and move or copy things around. It is written in Rust and is available for Linux and macOS. The interface is modeled after a popular terminal file manager called ranger. The screen is divided into three columns showing the parent directory, the current directory, and a preview of whatever is selected. Navigation follows the hjkl key convention familiar to users of the Vim text editor, so h moves to the parent directory, l opens a file or enters a folder, and j and k move up and down the list. Beyond basic navigation, joshuto supports tabs so you can have multiple directories open at once, bulk rename, file previews including images (with additional setup), fuzzy search via an optional fzf integration, bookmarks, and a trash system instead of permanent deletion. File copy and paste operations run asynchronously, meaning you can keep working while a large file transfer happens in the background. The behavior of the program is configured through a set of TOML files: one for general settings, one for keyboard shortcuts, one for deciding which application opens each file type, one for colors and themes, and one for bookmarks. Installation options include building from source with Cargo (the Rust build tool), downloading a pre-compiled binary via a provided install script, or installing through system package managers on Arch Linux (AUR), Fedora (COPR), Gentoo, NixOS, and macOS via Homebrew or MacPorts.