v1.0.5

Install rwx 1.0.5

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/vncsmnl/rwx/releases/download/v1.0.5/rwx-installer.sh | sh

Install prebuilt binaries via Homebrew

brew install vncsmnl/tap/rwx

Download rwx 1.0.5

File	Platform	Checksum
rwx-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
rwx-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
rwx-aarch64-unknown-linux-gnu.tar.xz	ARM64 Linux	checksum
rwx-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum

v1.0.4

Install rwx 1.0.4

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/vncsmnl/rwx/releases/download/v1.0.4/rwx-installer.sh | sh

Install prebuilt binaries via Homebrew

brew install vncsmnl/tap/rwx

Download rwx 1.0.4

File	Platform	Checksum
rwx-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
rwx-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
rwx-aarch64-unknown-linux-gnu.tar.xz	ARM64 Linux	checksum
rwx-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum

v1.0.3

Installation

1. From Crates.io

Since rwx is published on crates.io, you can install it using Cargo:

cargo install rwx

2. Debian / Ubuntu (APT)

Download the latest .deb package from the GitHub Releases and install it:

sudo apt install ./rwx_*_amd64.deb

3. Fedora / RHEL / CentOS (DNF)

Download the latest .rpm package from the GitHub Releases and install it:

sudo dnf install ./rwx-*.x86_64.rpm

4. Pre-compiled Binaries (Cargo Binstall)

If you have cargo-binstall installed, you can quickly download and install pre-compiled binaries directly from GitHub Releases:

cargo binstall rwx

5. Building from Source

If you want to compile rwx yourself:

Prerequisites

• Rust and Cargo (2024 Edition) installed on your system.
• A Unix-like operating system (macOS, Linux, BSD) because the tool relies on Unix-specific features.

git clone https://github.com/vncsmnl/rwx.git
cd rwx
cargo build --release
sudo cp target/release/rwx /usr/local/bin/

---

Usage

Start rwx in the current directory:

rwx

Or open a specific file or directory directly in the Editor mode:

rwx /path/to/file_or_directory

CLI Arguments

rwx [FLAGS] [PATH]

Arguments:
  [PATH]         Path to the file or directory to inspect/edit

Flags:
  -R, --recursive  Apply changes recursively (when target is a directory)
  -h, --help       Print help information
  -V, --version    Print version information

v1.0.2

chore: bump version to 1.0.2 in Cargo.toml and update Cargo.lock

v1.0.1

feat: add support for cross-platform packaging including Debian, RPM,…

v1.0.0 - Initial Release of rwx

Interactive File Permissions TUI Manager

I'm excited to announce the initial release of rwx, a modern, interactive terminal-based file permissions manager written in Rust.

rwx provides a beautiful and efficient Terminal User Interface (TUI) to inspect, modify, and manage file/directory permissions, ownership, and special bits in real-time, eliminating the need to memorize complex chmod and chown flags.

🚀 Features

• 📂 Interactive File Browser: Navigate your local filesystem with standard terminal keybindings, inspect metadata (such as sizes and types), and select files/directories directly for editing.
• 🛡️ Full Permission Editor: Easily toggle Read (r), Write (w), and Execute (x) permissions for:
  • Owner
  • Group
  • Others
• ⚙️ Special Permission Bits Support: Full support for setting/unsetting:
  • SetUID (Set User ID on execution)
  • SetGID (Set Group ID on execution)
  • Sticky Bit
• 🔢 Direct Octal Input: Edit permissions dynamically using direct octal code entry (e.g. typing 0755 or 1777 directly updates the interface).
• 👤 Owner & Group Management: Directly edit file/directory owner and group names via input fields.
• 🔁 Recursive Mode: Apply changes recursively to directories and their contents.
• 💻 CLI Arguments: Open a specific target path directly from the command line (rwx <path>), with optional recursive application flag (-R / --recursive).
• 🛡️ Terminal Restoration: Safe crash protection restores your terminal state if the application encounters an error.

⌨️ Controls & Keybindings

File Browser Mode

• j / Down Arrow — Move cursor down
• k / Up Arrow — Move cursor up
• Enter — Open selected directory or file
• s / S — Open the current directory itself in the editor
• q / Esc — Quit rwx

Permission Editor Mode

• h / l / j / k / Arrows — Move focus between elements (checkboxes, inputs, buttons)
• Space / Enter — Toggle selected permission checkbox / Click active button
• Tab / BackTab — Cycle focus forward/backward
• b / B / Backspace — Return to File Browser
• a / A — Apply changes immediately
• q / Esc — Quit rwx (if input is focused, Esc returns focus to checkboxes)

📦 Installation

To build and run rwx from source:

1. Clone the repository:

   git clone https://github.com/vncsmnl/rwx.git
   cd rwx

2. Build the release binary:

   cargo build --release

3. Run the binary:

   ./target/release/rwx [path]

4. Copy to PATH

   sudo cp ./target/release/rwx ~/.local/bin/rwx

5. Run the binary:

   rwx [path]