Skip to content

Navigation Menu

Sign in
Sign up

Repository files navigation

bonsize banner

bonsize

bonsize allows you to quickly analyze and display the size of directories and files in a tree structure, making it easy to identify which files and folders are taking up the most disk space. It comes with both a fast Command-Line Interface (CLI) and an interactive Graphical User Interface (GUI).

Graphical User Interface (GUI)

The bonsize-gui application provides an interactive, visual way to explore your disk space usage.

interface with a directory tree, folders, files, and their respective sizes visually represented

You can launch the GUI directly from your desktop application launcher or by running the following command in your terminal:

bonsize-gui

CLI Usage

bonsize [OPTIONS] [PATH]

Arguments

  • [PATH] - The directory path to analyze (default: current directory .)

Options

  • -F, --file - Show files in the output
  • -D, --directory - Show only directories
  • -d, --depth <MAX_DEPTH> - Maximum depth to traverse
  • -s, --sorted [<SORT>] - Sort output (possible values: asc, desc)
  • --csv [<CSV>] - Export results to CSV format
  • -c, --cache - Use caching for improved performance
  • -q, --quiet - Suppress non-essential output
  • -l, --logical-size - Show logical size instead of physical size
  • -h, --help - Print help information
  • -V, --version - Print version information

Examples

$ bonsize /folder
πŸ“‚ - folder 109.15MB
 πŸ“‚ - folder/videos 104.79MB
 πŸ“‚ - folder/videos/2026 87.19MB
 πŸ“„ - folder/videos/2026/vacation_2026_02.mp4 87.19MB
 πŸ“‚ - folder/videos/2025 17.60MB
 πŸ“„ - folder/videos/2025/Replay_2026εΉ΄03月12ζ—₯_20-05-46.mp4 17.60MB
 πŸ“‚ - folder/turtle pictures 4.36MB
 πŸ“„ - folder/turtle pictures/image_2.png 4.32MB
 πŸ“„ - folder/turtle pictures/image_1.jpg 40.00KB
 πŸ“„ - folder/letter.txt 4.00KB
# Show only directories, sorted by size
$ bonsize -D -s desc
# Limit depth and use cache
$ bonsize -d 3 -c

Installation

All releases are available on the releases section

Install only the CLI

For Linux

Debian/Ubuntu

Download the .deb package and install it:

sudo dpkg -i bonsize_*-CLI.deb
Universal linux

For the moment, on other distros you can use the tar.gz

For windows

soon

Install only the GUI

Debian/Ubuntu

Download the .deb package and install it:

sudo dpkg -i bonsize_*-GUI.deb
AppImage
chmod +x bonsize_*-GUI.AppImage
./bonsize_*-GUI.AppImage

License

This project is licensed under the WTFPL, see the license file for more details.

About

Fast and interactive disk usage analyzer with both a CLI and a modern GUI to explore directory tree sizes

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

AltStyle γ«γ‚ˆγ£γ¦ε€‰ζ›γ•γ‚ŒγŸγƒšγƒΌγ‚Έ (->γ‚ͺγƒͺγ‚ΈγƒŠγƒ«) /