Siivooja 2000 — User Manual

Version 1.0.3 · macOS 14+ Sonoma · Updated April 2026

1. Introduction

Siivooja 2000 is a multi-tool for keeping a Mac tidy: caches, logs, leftover app files, large old files, duplicate detection, a treemap disk visualiser, login-item management, browser-data cleanup, and basic Mac maintenance — all in a single native macOS app.

Every destructive operation goes through the system Trash and is logged. Nothing leaves your Mac.

2. Install & first launch

1. Download the DMG from koodisto.org/siivooja2000.
2. Mount the DMG, drag Siivooja2000.app to /Applications.
3. The app is signed and verified by Apple. The first launch may need a right-click → Open to bypass Gatekeeper.
4. An onboarding wizard walks you through three steps: language pick, Full Disk Access prompt, Trash permission.

3. App layout

Siivooja 2000 is a single window with three regions:

• Title bar — drag area, minimise / maximise / close controls.
• Menu bar — File, View, Scanners, Tools, Help. Same actions are available via macOS global menu where applicable.
• Sidebar (left) — tree of every feature, plus a language picker at the bottom.
• Detail (right) — the currently selected feature.
• Status bar (bottom) — log line, free space, current operation.

4. What's safe to delete & how to restore

Every deletion goes through the system Trash — never a hard rm. You have 24 hours to undo anything before macOS auto-purges the Trash.

Restoring just-deleted files

• Tools menu → "Restore last cleanup" — opens Finder Trash filtered to the most recent batch. Right-click an item → Put Back.
• Or via macOS Trash directly — Dock → Trash → select files → right-click → Put Back.
• After 24 hours — Trash auto-empties; recovery only via Time Machine if you have a backup.

Cache safety reference

What each scanner removes, what comes back automatically, and what you'll notice the next time you use the affected app.

What is NEVER touched by any scanner

• Audio files, projects, samples, presets (these live in ~/Music, ~/Documents, and ~/Library/Application Support proper — Quick Clean doesn't touch the latter)
• Audio Unit / VST plugin binaries (/Library/Audio/Plug-Ins/)
• Source code, git repositories, Xcode project files (.xcodeproj)
• Keychain credentials, passwords, certificates
• System-protected paths (/System, /usr outside /usr/local, /bin, /sbin, /var/db) — hard-coded into the block list

5. Dashboard

The default landing screen. Shows:

• A large free-space number and a percentage gauge for the boot volume.
• Quick-action tiles linking to the most-used scanners (Smart Scan, Quick Clean, Disk Map).
• Last-run summary from the cleanup history.

6. Quick Clean

Cleans the five most common cache locations in one click:

1. ~/Library/Caches
2. ~/Library/Logs
3. ~/Library/HTTPStorages
4. ~/Library/Saved Application State
5. iOS staging caches under ~/Library/Application Support/MobileSync

The scanner sums sizes first, presents a confirmation, and then sends everything to the system Trash. Affected paths are logged to History.

7. Smart Scan

The flagship one-click scan. Sweeps 14 system-junk categories with real-time per-category progress. Categories include user caches, system logs, developer caches (Xcode, npm, pip, cargo, gradle, go, Yarn), Docker pruneable layers, package-manager caches (Homebrew, MacPorts), iOS staging, large old browser caches, broken symlinks, and language-server caches.

• Each category shows its own progress bar; idle CPU stays at 0% the rest of the time.
• Categories scan in parallel — typically under 60 seconds on a modern Mac with a 30–80 GB junk surface.
• Result screen lists every category, its size, and an expandable path tree. Untick anything you want to keep before clicking "Trash".

8. System Junk

The granular cousin of Smart Scan — the same categories, but exposed as a tri-state checkbox tree. Use this when you want to inspect categories before scanning, or to scan only a subset.

• Tri-state: ☐ unchecked, ☑ checked, ◧ partial (some children checked).
• Each leaf shows path, size and last-modified date.
• Right-click → "Reveal in Finder" / "Show full path" works on every entry.

9. Large & Old

Find big or stale files anywhere in your user folders. Two sliders control the search:

• Min size — 10 MB to 10 GB.
• Min age — 30 days to 5 years.

Results are sortable by size, age or path. Hit Space on a row to QuickLook the file. Multi-select with ⇧ / ⌘, click "Trash" to send everything selected to the Trash.

10. Disk Map

A treemap of your user folder (or any folder you point it at). Each rectangle is a file or directory; area = size on disk.

• Click a rectangle to zoom in.
• Breadcrumb at the top to navigate back up.
• Hover for full path + size tooltip.
• Right-click → Reveal / Trash / Set as start path.
• Renders in under 5 seconds for a 100 GB user folder.

11. Duplicates

Three-stage dedupe designed to stay fast and low-memory even on disks with millions of files:

1. Files are first grouped by size — only same-size files can possibly be duplicates.
2. A quick fingerprint of the first kilobytes filters out the obvious mismatches.
3. The remaining candidates are compared with a full file hash.

Hardlinked files (the same data referenced from multiple places) are not counted as duplicates. Results are grouped by content; pick a "keeper" per group, trash the rest.

12. App Uninstaller

Lists every app in /Applications and ~/Applications together with the support files it leaves behind:

• ~/Library/Application Support/<app>/
• ~/Library/Caches/<app>/
• ~/Library/Preferences/<app>.plist
• ~/Library/LaunchAgents/<app>.plist
• ~/Library/Containers/<app>/
• ~/Library/Logs/<app>/
• For the few apps with non-standard cleanup paths, an internal database fills in the gaps.

Select an app, review the path list, click "Trash all" — both the app and its leftovers go to the Trash.

13. Login Items

Lists every user-level start-up item (Launch Agent or System Login Item). Toggle individual items off or trash them entirely. System-level items are read-only; the app refuses to touch them.

14. Privacy (browser cleanup)

Cleans browser caches, cookies and history for Safari, Chrome and Firefox.

15. Maintenance

A button per maintenance task. Each runs a single, fixed standard macOS command on your behalf — no user-supplied input ever reaches the shell.

• Thin local Time Machine snapshots — frees disk space taken by local backup snapshots.
• Spotlight reindex — rebuilds Spotlight's search index from scratch.
• QuickLook cache reset — clears stale preview thumbnails.
• Empty Trash (after confirmation).
• DNS flush — clears the system DNS cache (useful after VPN or network changes).

16. Schedule ⭐

Set up a weekly automatic Smart Scan:

• Pick the weekday, hour and minute.
• The schedule is remembered between launches.
• The scheduler runs only while the app is open — background launch is planned for a future release.

17. System Monitor ⭐

Live RAM pressure and top memory consumers. Refresh is manual via the "Refresh" button so the app uses no CPU when idle.

• Memory pressure indicator with current free / used / cached breakdown.
• List of top processes by memory use, with name, owner, and current footprint.
• Quit any user-owned process with one click; force-quit available with a confirmation prompt. System-owned processes are visible but cannot be touched.

18. History

Every cleanup is logged with a timestamp, the module that ran, total size freed, and the affected paths. Use the History view to see what ran when, or to export a CSV.

18. Languages

Switch the UI language at any time via the sidebar bottom panel or Settings (⌘,). The change is instant — no app restart.

Supported: 🇫🇮 Suomi, 🇬🇧 English, 🇸🇪 Svenska, 🇩🇪 Deutsch, 🇫🇷 Français, 🇪🇸 Español.

19. Troubleshooting

"It doesn't show any caches"

Most likely cause: Full Disk Access not granted. System Settings → Privacy & Security → Full Disk Access → enable Siivooja 2000. Quit and relaunch the app.

"Smart Scan is stuck"

Smart Scan can stall on slow network mounts or on disconnected external volumes. Open the log console (Tools → Show log) and look for the last logged path — that is usually the offender. Cancel the scan and exclude the path.

"It says 'Path forbidden'"

System paths protected by macOS (/System, parts of /usr, /bin, /sbin) and iCloud-mirror folders are blocked by design. This list cannot be overridden — it is there to prevent accidents.

"How do I undo?"

Tools → "Restore last cleanup". Reads back from the system Trash and restores everything trashed in the last 24 hours. After 24 h the macOS Trash auto-purges and restoration is no longer possible.

"Where are the logs?"

Open the in-app log console: Tools → Show log.