10 Essential Features of BleachBit’s New Text-Based User Interface

Linux system cleanup tools are plentiful, but few have the depth of BleachBit. This open-source powerhouse handles everything from browser caches to package archives, and now it's gaining a text-based user interface (TUI). Ideal for users who prefer the terminal or lightweight environments, the TUI brings full functionality without the graphical overhead. I've taken it for a spin, and here are the ten things you need to know about this exciting new mode.

1. What BleachBit TUI Actually Is

BleachBit has long been available as a graphical application (GUI) and a command-line tool (CLI). The TUI, currently in alpha, bridges the gap between the two—it's an interactive, keyboard-driven interface that runs entirely within the terminal. It offers a structured, menu-based way to select cleaning operations without memorizing commands. The TUI shares the same core engine as the GUI, so all your existing cleanup rules, custom lists, and cookie filters are carried over automatically. This means you can switch between GUI and TUI seamlessly without reconfiguration. The alpha version focuses on core functionality, with more polish expected in future releases.

2. Navigating the Interface Is Intuitive

Once launched, the TUI presents a clean, hierarchical layout of cleaning categories. Navigation relies on simple keyboard shortcuts: use arrow keys to move between categories, press Enter to expand a category and view the files inside, and toggle individual items on or off with the Space bar. Every action provides immediate visual feedback, and the interface responds smoothly even over SSH. For users accustomed to text-based tools, the learning curve is minimal. The developers have clearly prioritized ease of use, making it accessible even for those new to system cleanup utilities. Mouse interaction is also partially supported, including scroll-wheel scrolling, but keyboard remains the primary input method.

3. Two Preview Modes for Accurate Cleanup

Before deleting anything, BleachBit TUI offers two distinct preview modes. Pressing p (lowercase) triggers a full preview that shows a list of every file that would be removed across all selected categories. For a more granular look, pressing P (uppercase) runs a focused preview on only the currently highlighted category. This dual-mode approach lets you verify the exact impact of cleanup operations before committing. The preview output includes file paths and sizes, helping you decide if any items should be spared. Use Shift or Caps Lock to type uppercase when needed—a small but helpful design detail.

4. Delete Commands Are Equally Flexible

After previewing, deletion follows the same logic. The d key (lowercase) deletes all selected items across all categories, while D (uppercase) removes only files from the currently focused category. A confirmation prompt appears before any irreversible action, requiring you to press Y to proceed. On my first test, the deletion failed because the TUI wasn't run with elevated privileges. Relaunching with sudo python3 bleachbit_tui.py solved it immediately. After successful deletion, a dialog box in the bottom-right corner reports the number of files deleted and the disk space reclaimed—satisfying feedback that lets you know exactly what was accomplished.

5. Privilege Requirements and How to Handle Them

Many cleanup operations—such as wiping free space or removing system-wide logs—require root privileges. The TUI will display errors if launched without sudo. The official workaround is to run the tool using sudo python3 bleachbit_tui.py on Linux. On Windows, the TUI ships as a native 64-bit binary and automatically requests elevation when needed. This is an important caveat for anyone testing the alpha: if you encounter permission denied messages, simply relaunch with appropriate privileges. The developers plan to improve privilege handling in future releases, perhaps by prompting for elevation when necessary.

6. Palette Menu Gives Quick Access to Extended Features

Press Ctrl+P to open the palette menu—a floating command palette similar to those found in modern IDEs. From here you can search for commands by typing a few letters, maximize the current component to full screen, quit the application cleanly, save a screenshot of the TUI session, or open a help panel that lists all keyboard shortcuts. This centralized menu reduces the need to memorize every keybinding, making the TUI friendlier for occasional users. The help panel is especially useful when you're learning the ropes, as it organizes keys by function (navigation, preview, deletion, system).

7. Seamless Settings Sharing with the GUI

One of the smartest design decisions is the shared backend between the TUI and the traditional GUI. Any cleaning options you've configured in the graphical version—such as which browser caches to clear, which files to keep in a keep list, your custom cleaning list, and your cookie keep list—are automatically picked up by the TUI. This means you don't have to reconfigure everything from scratch if you switch between interfaces. It also ensures that cleaning rules remain consistent regardless of how you launch the tool. For power users who maintain intricate cleanup profiles, this interoperability is a huge time saver.

8. Theme Support and Visual Customization

While the TUI is text-based, it doesn't have to be ugly. BleachBit TUI supports display themes, allowing you to change color schemes to suit your terminal background or personal preference. Combined with the ability to resize and maximize components, you can tailor the visual experience even without a graphical environment. The interface uses modern terminal capabilities for borders and shading, making it pleasantly readable even over low-quality remote connections. Mouse support, including scroll wheel, adds another layer of convenience. These small touches show that the developers care about user experience in the terminal.

9. Cross-Platform Availability and Packaging

BleachBit TUI is designed for both Linux and Windows. On Linux, you can run it from source by following the quick-start instructions in the official announcement—particularly for Ubuntu users. If that's not your distribution, building from source is straightforward. On Windows, the TUI is distributed as both an installer and a portable package. Notably, the Windows build is compiled as a native 64-bit binary, while the stable GUI and CLI remain 32-bit. This performance edge will benefit users on modern Windows systems. The cross-platform approach ensures that system cleanup is accessible on desktop and server environments alike.

10. Alpha Status: Expect the Unexpected

This is an alpha release, meaning the software is still under heavy development. Features may change, bugs are to be expected, and some operations might fail. The developers have been transparent about this, advising testers to back up important data before trying the TUI. If you encounter issues, report them through the project's issue tracker to help improve future versions. Participation from the community is welcomed and encouraged. Despite the rough edges, the alpha already demonstrates a solid foundation. For adventurous users who enjoy shaping tools through early feedback, BleachBit TUI offers an exciting glimpse into the future of terminal-based system cleanup.

Conclusion: A Terminal Cleaner Worth Watching

BleachBit's TUI successfully marries the power of a command-line tool with the usability of a graphical one. Its intuitive keyboard navigation, flexible preview and delete modes, shared settings with the GUI, and cross-platform availability make it a promising addition to the Linux ecosystem. While it's still in alpha and requires careful handling—especially regarding permissions—the core functionality is already impressive. Whether you're a terminal aficionado or just looking for a lightweight alternative to the full GUI, this TUI is definitely worth testing. Keep an eye on its development; it's likely to become a staple in many system administrators' toolkits.