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

This repository profile is provided by osrepos.com, an open source repository discovery platform.

Source: osrepos.com
Repository profile: https://osrepos.com/repo/crumbyte-noxdir
Generated for open source discovery and AI-assisted research.

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.

GitHub: https://github.com/crumbyte/noxdir
OSRepos URL: https://osrepos.com/repo/crumbyte-noxdir

## 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.

## Topics

- cross-platform
- disk-space-analyzer
- disk-usage
- terminal-ui
- Go
- cli-tool
- file-system-utility

## Repository Information

Last analyzed by OSRepos: Sun Dec 28 2025 12:00:58 GMT+0000 (Western European Standard Time)
Detail views: 5
GitHub clicks: 14

## Safety Notice

OSRepos shares public repositories for knowledge and discovery only. Review source code, dependencies, licenses, and security implications before running or installing anything.

## Content

## 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):**
    bash
    brew tap crumbyte/noxdir
    brew install --cask noxdir
    
*   **Arch-based Linux distros:**
    bash
    pacman -S noxdir
    
*   **NixOS / Nix:**
    bash
    nix-env -iA nixpkgs.noxdir
    
*   **Other Linux distros:**
    bash
    curl -s https://crumbyte.github.io/noxdir/scripts/install.sh | bash
    
*   **Pre-compiled Binaries:** Download the latest optimized binary from the [Releases page](https://github.com/crumbyte/noxdir/releases).
*   **Go install (Go 1.24+):**
    bash
    go install github.com/crumbyte/noxdir@latest
    
*   **Build from source (Go 1.24+):**
    bash
    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:

bash
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:**
    bash
    noxdir --root="/path/to/your/directory"
    
*   **Exclude specific directories from scanning:**
    bash
    noxdir --exclude="node_modules,temp_files"
    
*   **Enable caching for faster subsequent scans:**
    bash
    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.

## Links

*   **GitHub Repository:** [crumbyte/noxdir](https://github.com/crumbyte/noxdir)
*   **Latest Releases:** [NoxDir Releases](https://github.com/crumbyte/noxdir/releases)
*   **License:** [MIT License](https://github.com/crumbyte/noxdir/blob/main/LICENSE)