MangoDisk README

README проекта с github.com/harry0703/MangoDisk. Одним файлом markdown: README.md.

MangoDisk application icon MangoDisk

Disk cleanup, storage analysis, and privacy protection for macOS, Windows, and Linux

English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Русский

Latest release macOS supported Windows supported Linux supported Tauri 2 Rust Core

MangoDisk Overview dashboard

What MangoDisk Can Do

Storage

1. Deep Cleanup

Recover storage used by everyday apps, development work, and AI tools. Find caches, build artifacts, and local models in one place, without hunting through hidden folders:

Smart recommendations help you make safe choices quickly. You can also review items individually and see the estimated reclaimable space upfront, keeping every cleanup predictable and under your control.

2. Large File Cleanup

Quickly find the largest files and reclaim space used by old installers, videos, archives, and other bulky content without digging through folders one by one.

3. Duplicate File Cleanup

Reclaim space taken up by duplicate copies without treating files as duplicates just because they share a name. Smart selection keeps at least one file in every group, so cleanup stays effortless and safe.

4. Disk Space Analysis

See where your disk space is going at a glance. Switch between a treemap and a sunburst chart, and choose how many levels to display to explore space usage and folder structure. Browse folders alongside the file list to quickly find the largest folders and files and decide what to clean up.

Privacy & Security

5. Privacy Cleanup

Keep browsing history, searches, cookies, recent items, and clipboard data from lingering on your computer. Clear traces left by browsers, applications, and the system to reduce exposure of your activity and make everyday privacy easier to manage.

System Tools

6. Application Uninstall and Cleanup

Uninstall applications and clear related caches, settings, and leftovers so removing an application actually gives you the space back. Potential personal files are handled cautiously to reduce the risk of accidental deletion.

7. Startup Item Management

Reduce unnecessary startup delays and background resource use, so your computer starts faster and feels lighter. Turn items back on at any time when you need them again.

8. System Optimization

Reduce unnecessary settings that slow down your system or get in the way. Balance performance, privacy, and personal preferences so your computer feels faster and easier to use.

9. System Maintenance

Fix common problems like missing search results, incorrect icons, no sound, or network connection failures—without hunting down fixes or typing complex commands. Get your computer back to normal sooner.

10. Context Menus (Windows)

Available since version 1.2.3

Keep right-click menus tidy and easy to use. Browse entries by menu location or app, disable, restore or remove supported items, and adjust menus for individual file types.

Add everyday actions such as copying paths and opening a terminal, along with shortcuts to system tools.

Activity

11. Operation History

Keep a clear record of every cleanup and system change. See how much space you recovered, what completed successfully, and whether anything still needs your attention.

Resource Usage and Memory Management

Available since version 1.1.1

Track CPU, GPU, memory, network speeds and disk activity in real time, with trends to help you understand resource use. On supported devices, you can also check temperatures, power usage, battery status and disk health.

Quickly find resource-heavy apps, quit those you no longer need, and free memory manually or automatically.

Display metrics in the menu bar, taskbar, system tray or a floating desktop window. Customize the content and appearance to keep an eye on your computer without opening the main window.

AI Explanations

Available since version 1.1.0

Unsure what an item does or what might happen if you change it? AI explanations use the item's description and current scan results to explain its purpose and what to consider before taking action. Spend less time looking things up and make more informed choices.

Get explanations directly from items in Deep Cleanup (built-in rules), Privacy Cleanup, Startup Item Management, System Optimization, and System Maintenance.

Official releases include free explanations each day, with the option to connect your own AI service. AI offers guidance; you decide which actions to take.

Safety and Rules

[!IMPORTANT] MangoDisk puts data safety ahead of reclaiming more space. Cleanup rules and system optimizations only ship after their safety boundaries are clearly defined and they pass validation on real systems.

MangoDisk scans in read-only mode by default. Before cleanup, deletion, uninstall, or system setting changes begin, you can review and confirm exactly what will happen. Results are saved to Operation History.

System Optimization only uses built-in, validated settings. It never accepts arbitrary registry paths, terminal commands, or scripts. MangoDisk reads each setting again after changing it and calls out high-impact items and changes that require administrator access or a restart.

MangoDisk maintains its own cleanup rules. Third-party projects may provide research leads, but a candidate rule is only accepted after reliable sources, safe boundaries, and real-system behavior have been verified. Anything without a clear safety boundary is excluded.

The complete rule library and revision history are open for inspection: view the MangoDisk cleanup rule library.

Screenshots

Deep Cleanup
Make room for what matters by clearing accumulated caches, build artifacts, and AI models you no longer need

MangoDisk Deep Cleanup interface

Large File Cleanup
Find the files taking up the most space without digging through folders

MangoDisk Large File Cleanup interface
Duplicate File Cleanup
Safely remove exact duplicates while keeping at least one copy

MangoDisk Duplicate File Cleanup interface
Disk Space Analysis
See where your storage is going and quickly find the largest files and folders

MangoDisk Disk Space Analysis interface
Startup Item Management
Reduce unnecessary startup programs for faster sign-in and less background activity

MangoDisk Startup Item Management interface
Application Uninstall and Cleanup
Uninstall applications and remove related leftovers to reclaim more space

MangoDisk Application Uninstaller interface
System Optimization
Optimize performance, privacy, and everyday usability in one click

MangoDisk System Optimization interface
System Maintenance
Fix common system issues quickly and get your computer back to normal

MangoDisk System Maintenance interface
Privacy Cleanup
Leave fewer activity traces behind and keep everyday use more private

MangoDisk Privacy Cleanup interface

Before You Begin

[!CAUTION]

  1. Cleanup, permanent deletion, and uninstall operations may not be reversible. Review the selected content and keep reliable backups of important data.
  2. Before running system maintenance or changing a startup item or system setting, make sure you understand its purpose and impact.
  3. Some system optimizations can affect security, privacy, battery life, or update behavior.

Desktop App

Download MangoDisk from the official download page or GitHub Releases, then follow the instructions for your operating system below.

macOS

Requirements: macOS Monterey 12.5 or later.

Install with Homebrew:

brew install --cask harry0703/tap/mangodisk

Manual installation: Download the DMG from the official download page, open it, and drag MangoDisk into the Applications folder.

Windows

Requirements: 64-bit Windows 10 or later.

Install with PowerShell:

irm https://get.mangodisk.app | iex

Install with WinGet (official source):

winget install --id MangoDisk.MangoDisk --exact --source winget

Manual installation: Download the Windows installer from the official download page and follow the installation prompts.

Linux

Recommended: Ubuntu 22.04 LTS or later, on x64 or ARM64.

Available as .deb packages and AppImages. Compatibility with other Linux distributions depends on their system libraries and desktop environment.

Install with Homebrew: Requires a recent Homebrew version and a desktop environment.

brew install --cask harry0703/tap/mangodisk

Install from the terminal (Debian/Ubuntu): This command detects your architecture and installs the latest matching .deb package.

curl -fsSL https://get.mangodisk.app/linux | bash

Manual installation: Choose the package for your architecture on the official download page.

Command Line (CLI)

Use MangoDisk in your terminal or scripts, with the same safety-first cleanup engine as the desktop app.

macOS

Install with Homebrew:

brew install harry0703/tap/mangodisk-cli

Windows

Install with PowerShell:

irm https://get.mangodisk.app/cli | iex

Install with WinGet (official source):

winget install --id MangoDisk.CLI --exact --source winget

Linux

Prebuilt standalone CLI downloads are not yet available for Linux. Follow the Build from Source instructions below to build it yourself.

Usage Examples

If mangodisk is not immediately available after installation, open a new terminal, then verify the installation:

mangodisk --version

Common commands:

# Scan and show cleanable content without changing anything
mangodisk clean

# Apply the same smart recommendations as the desktop application
mangodisk clean --apply

# Preview all selectable content without deleting anything
mangodisk clean --apply --selection all --dry-run

# Produce machine-readable JSON output
mangodisk clean --format json --no-progress

mangodisk clean only scans and never modifies files by default. To perform cleanup in a non-interactive environment, you must also pass --yes to confirm explicitly. Run the following command for all available options:

mangodisk clean --help

Build from Source

Prerequisites

For platform-specific dependencies, see the Tauri 2 prerequisites.

Get the Source and Run the Desktop Application

git clone https://github.com/harry0703/MangoDisk.git
cd MangoDisk
pnpm install --frozen-lockfile
pnpm tauri:dev

Run the Required Checks

pnpm check
cargo test --manifest-path src-tauri/Cargo.toml -p mangodisk-core

Build the Desktop Installer

pnpm tauri:build

Build the CLI

pnpm cli:build

Local builds do not include the signing, notarization, or update metadata provided by official MangoDisk releases. Use them for local development and validation only.

Contributing

Issues, cleanup rules, fixes, and new features are welcome. Read CONTRIBUTING.md and AGENTS.md before getting started.

Routine cleanup coverage should use build-validated, declarative TOML rules. See src-tauri/crates/mangodisk-core/rules/README.md for the rule schema, safety constraints, and validation instructions.

Before submitting changes, run at least:

pnpm check
cargo test --manifest-path src-tauri/Cargo.toml -p mangodisk-core

Report security vulnerabilities privately through GitHub Security Advisories as described in SECURITY.md. Do not open a public issue for a security vulnerability.

Technology Stack

License

MangoDisk is open source under the GNU General Public License v3.0. Third-party components remain subject to their respective licenses.

MangoDisk (harry0703/MangoDisk)

Ищем в базе…

Что это такое?MangoDisk — очиститель диска и анализатор хранилища, в первую очередь ориентированный на безопасность, для macOS, Windows и Linux. Он находит кэш, который можно освободить, большие файлы и дубликаты, позволяет удалять приложения и управлять элементами автозапуска, а также включает инструменты оптимизации и обслуживания системы.
Это приложение для рабочего стола или инструмент командной строки?И то, и другое: десктопное приложение на Tauri с интерфейсом на Vue 3/TypeScript, а также интерфейс командной строки, который использует тот же движок очистки, что и десктопное приложение.
Как установить MangoDisk?На macOS и Windows можно установить через Homebrew или WinGet/PowerShell либо скачать DMG или установщик для Windows напрямую. На Linux доступны пакеты .deb и AppImage, а для Debian/Ubuntu есть скрипт установки, который сам определяет архитектуру.
Очистка всегда безопасна и обратима?Нет — очистка, безвозвратное удаление и удаление приложений могут быть необратимыми, поэтому сначала проверьте выбранное и сделайте резервные копии. По умолчанию инструмент сканирует в режиме только для чтения и применяет только проверенные встроенные правила, а не произвольные скрипты или правки реестра.
Какие версии ОС поддерживаются?macOS Monterey 12.5 и новее, 64-битная Windows 10 и новее, а также Linux (рекомендуется Ubuntu 22.04 LTS и новее на x64 или ARM64); другие дистрибутивы Linux зависят от своих системных библиотек.
Отправляет ли программа мои данные куда-нибудь?Сканирование и очистка выполняются локально, по умолчанию в режиме только для чтения. При этом функция объяснений с ИИ может по желанию подключаться к сервису ИИ, чтобы получить контекст об элементах. Нигде не сказано, что данные сканирования загружаются для самого движка очистки.
Как работа с дубликатами файлов избегает удаления не тех файлов?Программа находит настоящие дубликаты, а не файлы, у которых просто совпадает имя. Кроме того, при умном выборе в каждой группе всегда остаётся как минимум одна копия, поэтому очистка по умолчанию безопасна.
Что такое функция объяснений с ИИ?Она использует описание элемента и текущие результаты сканирования, чтобы объяснить, что он делает и что может произойти, если его изменить или удалить. Это помогает принять решение до действия. Официальные релизы включают бесплатные ежедневные объяснения, а также возможность подключить собственный сервис ИИ.
Можно ли запускать очистку из CLI без интерактивного режима?Да, но команда mangodisk clean по умолчанию только сканирует и никогда не меняет файлы; чтобы действительно выполнить очистку, нужно явно передать флаг --yes.
Как проверяются правила очистки перед добавлением?MangoDisk ведёт собственную библиотеку правил, в которую правило попадает только после проверки надёжных источников, безопасных границ и поведения в реальной системе. Всё, у чего нет чёткой границы безопасности, исключается, а полная библиотека правил открыта для просмотра.
Автор
harry0703
Размер
11.2 MB
Звёзды
5.9K
Возраст
3 мес
Коммиты · 90 дней