1 unstable release

Uses new Rust 2024

new 0.1.0 Apr 20, 2025

#433 in Command line utilities

GPL-3.0 license

64KB
1.5K SLoC

rx

A highly flexible file explorer on terminal

Features

  • File Explorer: Navigate through your file system with ease.
  • File Operations: Create, delete, and rename files and directories.
  • Undo-tree: Keep track of your file operations and undo them if necessary.
  • Customizable: Build your own plugins using the provided lua API.

Installation

For the moment, only compiling from source is supported. You can do this by running the following commands:

git clone https://github.com/rcroughs/rx.git
cd rx
cargo build --release

The compiled binary will be located in target/release/rx. You can move it to a directory in your PATH for easier access.

Usage

You can pass the following arguments to the binary:

  • -h or --help: Show the help message.
  • -o or --output: When you leave the app, it will write the current directory to stdout.

Examples

  • Making an alias to jump easily to a directory:
alias rx='cd $(rx -o)'

Scripting

In your config directory (~/.config/rx), you can create a init.lua file. This file will be loaded when the app starts. You can use this file to define your own plugins and customize the app to your liking.

Please note that the API is still in development and may change in the future. Moreover, the API is not documented yet, but you can find some examples in the examples directory.

Contributing

Contributions are welcome! If you have any ideas or suggestions, feel free to open an issue or submit a pull request.

License

This project is licensed under the GNU General Public License v3.0. See the LICENSE file for details.

Acknowledgements

Dependencies

~8–18MB
~258K SLoC