https://github.com/minoxs/spacecrawler

Terminal tool for quickly analyzing disk usage. Made with Windows in mind.
https://github.com/minoxs/spacecrawler

disk-usage terminal windows

Last synced: about 1 month ago
JSON representation

Terminal tool for quickly analyzing disk usage. Made with Windows in mind.

• Host: GitHub
• URL: https://github.com/minoxs/spacecrawler
• Owner: Minoxs
• License: agpl-3.0
• Created: 2024-10-14T01:22:59.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-05-26T03:40:34.000Z (9 months ago)
• Last Synced: 2025-11-22T17:11:38.787Z (3 months ago)
• Topics: disk-usage, terminal, windows
• Language: Go
• Homepage:
• Size: 135 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# SpaceCrawler

This is a terminal tool for analyzing folder and file usage.

It will quickly run through every file in the working directory and report its size.

By default it will spawn up to 5000 threads that will run through the folder calculating size and everything.

Files and folders with restricted access will not be counted properly.

This tool was born out of necessity because windows is awfully slow at reporting folder sizes, and I didn't find any tool which does everything I want.

Version `v1.1.1` is simple but functional. 

It is available both as a [CLI](#command-line-interface-cli) `cmd/sprawler-cli` as well as a [TUI](#terminal-user-interface-tui) `cmd/sprawler-tui`.

## Terminal User Interface (TUI)

The TUI will iterate over the current working directory and allows you to move about the file tree figuring out what is taking up space.

It will update in real time as new folders are crawled through.

![example_tui](img/example_tui.jpg)

Use arrow keys to move around, and enter to expand a node in the tree. Q exits the application.

## Command Line Interface (CLI)

The CLI will iterate over the current working directory and render the file tree into stdout; SIGTERM will halt the process early, but still render out to stdout.

![example_cli](img/example_cli.png)

# DiskExplorer

The package `pkg/DiskExplorer` contains the core functionality used in both tools, and could be used on its own to build other stuff.