NoxDir: A High-Performance Terminal Utility for Disk Usage Visualization

Summary

NoxDir is a powerful, cross-platform command-line tool designed for visualizing file system usage. It offers a responsive, keyboard-driven terminal UI to help users quickly identify and manage disk space. Written in Go, NoxDir supports Windows, macOS, and Linux, making it a versatile utility for system cleanup.

Use at your own risk

OSRepos shares public repositories for knowledge and discovery only. Any installation, execution, configuration, or use of code from these repositories is the user's own responsibility. Always review the repository, source code, dependencies, licenses, and security implications before running or installing anything. OSRepos is not responsible for issues, damages, or losses resulting from third-party repositories.

Introduction

NoxDir is a high-performance, cross-platform command-line tool designed for visualizing and exploring your file system usage. Written in Go, it detects mounted drives or volumes and presents disk usage metrics through a responsive, keyboard-driven terminal UI. NoxDir is crafted to help you quickly locate space hogs and streamline your cleanup workflow, supporting Windows, macOS, and Linux.

Installation

NoxDir offers several convenient installation methods:

Homebrew (macOS):

brew tap crumbyte/noxdir
brew install --cask noxdir

Arch-based Linux distros:
```
pacman -S noxdir
```
NixOS / Nix:
```
nix-env -iA nixpkgs.noxdir
```

Other Linux distros:

curl -s https://crumbyte.github.io/noxdir/scripts/install.sh | bash

Pre-compiled Binaries: Download the latest optimized binary from the Releases page.

Go install (Go 1.24+):

go install github.com/crumbyte/noxdir@latest

Build from source (Go 1.24+):

git clone https://github.com/crumbyte/noxdir.git
cd noxdir
make build
./bin/noxdir

Examples

Using NoxDir is straightforward. Once installed, simply run it in your terminal:

noxdir

The interactive interface initializes immediately, allowing you to explore your disk usage without configuration. You can also use flags to customize its behavior:

Specify a root directory:

noxdir --root="/path/to/your/directory"

Exclude specific directories from scanning:

noxdir --exclude="node_modules,temp_files"

Enable caching for faster subsequent scans:
```
noxdir --use-cache
```

Why Use NoxDir?

NoxDir stands out with its robust feature set and user-friendly design:

High Performance: Built with Go, it offers fast scanning and a responsive terminal UI.
Cross-Platform Compatibility: Seamlessly works across Windows, macOS, and Linux.
Interactive Visualization: A keyboard-driven interface helps you navigate and understand disk usage intuitively.
Delta Mode: Easily view file system changes since your last session, highlighting added or deleted items and space usage differences.
Customization: Personalize your experience with custom key bindings and color schemas to match your preferences.
Caching for Speed: Utilize caching to significantly reduce scanning times on frequently accessed volumes.
Command Bar: Execute actions on selected entries directly from an integrated command bar.