Uninstall Mac apps with every file they leave behind, and see why each belongs. Free up space, fine-tune macOS, and set up Terminal.
Swift cache-cleanercleanerclideveloper-toolsdisk-cleanupdisk-spaceduplicate-finderhomebrewliquid-glassmac-cleanermacosmacos-appmacos-golden-gatemacos-tahoemacos-tweaksswiftswiftuiterminal-themesuninstalluninstaller
Move the guide to each tool out of the README into GUIDE.md
Țugui Dragoș7c3dd6e4cf67
diff --git a/GUIDE.md b/GUIDE.mdnew file mode 100644index 00000000..a03309c2--- /dev/null+++ b/GUIDE.md@@ -0,0 +1,259 @@+# Using Peel++What each tool in Peel does, what Peel asks for and why, and how to remove it. [README.md](README.md) says what Peel is+and how to get it, [SAFETY.md](SAFETY.md) what it protects, [PRIVACY.md](PRIVACY.md) what it sends, and+[TERMINAL.md](TERMINAL.md) every Terminal theme and setting.++## Uninstall apps completely++<p align="center">+ <img src="readme-assets/peel-uninstall-app-with-leftover-files.png" width="900" alt="Peel uninstalling Obsidian: the app, what it left in Application Support, caches, and preferences, and the command Homebrew linked to it, each with its kind and size, selected and ready to move to the Trash, with its list of recent documents under Review Before Removing, its privacy permissions to reset, and the links it opens by default">+</p>++- **Every leftover, with a reason.** Peel searches the places apps keep files: Application Support, caches,+ containers and group containers, preferences, saved state, logs, launch agents and daemons, plug-in folders, and+ more. Each file comes with the reason it matched, such as the app's bundle identifier, its signing team, or a+ Homebrew cask that names it.+- **Only the sure things are selected.** Files that certainly belong to the app are selected for you, unless Peel+ sees something inside that may exist nowhere else, such as a crypto wallet, a signing key, a password database, or+ a repository, or the app keeps there what may exist only on this Mac: local mail, message history, sign-in codes,+ or VPN connections. A file another installed app also uses is shown but never selected, and anything Peel is less+ sure of waits under Review Before Removing. A list's Select menu picks what Peel recommends, everything, or+ nothing. Select All passes by what Peel holds back, guesses at, or shares with another app, which you select one+ by one, and asks before it adds anything else Peel doesn't recommend.+- **Several ways in.** Choose an app in the list, drop one on Peel's Dock icon, select several apps at once, or+ Control-click an app in Finder and choose Uninstall with Peel. With Watch the Trash on, Peel notices when you+ drag an app to the Trash yourself and offers to clear what it left behind. Apps you keep outside the Applications+ folders, such as on another disk, join the list once you add their folder in Settings > General > App Folders.+- **Reset instead of remove.** Clear an app's settings without uninstalling it. Peel saves them first, so you can+ put them back, and never selects your own work.+- **Privacy permissions too, if you want.** Peel can also reset the permissions macOS gave the app, such as access+ to the camera and the microphone.+- **Its Dock icon too.** Peel takes the app's icon out of the Dock, where it would stay as a question mark,+ unless you deselect it, and History puts it back where it was when you put the app back.+- **What it opens.** An app's page lists the kinds of files and links it opens by default, and what would open+ them once it's gone. Peel never changes that itself.+- **Updates for your apps.** Peel checks your apps for new versions, through the update feed each app names or the+ App Store for apps bought there, and shows what is new in the version that waits, as the app's own notes say it,+ with no connection too. Skip This Version and Never Check This App keep it quiet about the ones you want left+ alone.++## Free up disk space++<p align="center">+ <img src="readme-assets/peel-space-areas-of-your-disk.png" width="900" alt="Peel's Space page: how much of the disk is free and used, the areas of your Library with their sizes, and Hidden App Caches open, with what it is and the caches inside it, selected on three pages">+</p>++Space shows what fills your disk, area by area, and what each area is.++- **Orphaned Files:** files left behind by apps you already removed.+- **Developer:** caches of developer tools, editors, browsers, and AI models. What you may want again is listed but+ never selected for you, and toolchains or anything holding an account are never listed.+- **Build Artifacts:** what builds left in your projects, like `node_modules`, `DerivedData`, or `target`, each only+ when its tool's own file proves it. A project changed in the last 7 days is never selected for you.+- **Duplicates:** files and whole folders with identical contents, compared with SHA-256. One copy is always kept.+ Files under 100 KB, and folders holding less, are left out unless you choose a smaller size, in the app and in+ `peel duplicates` alike.+- **Installers and Backups:** installers of apps you already have, including packages an app keeps in Application+ Support, macOS installers, device firmware, downloads a browser never finished, updates apps downloaded and keep+ until they install them, and what your iPhone backups hold. Nothing is selected for you.+- **iCloud Drive:** files already safe in iCloud that are also downloaded to this Mac. Remove Downloads, as in+ Finder, takes away only the copy on this Mac: each file stays in iCloud and downloads again when you open it.+- **Space:** what's taking up room, and which app it belongs to. What an app manages itself, such as Docker's disk,+ Space leaves to that app, with the command that frees it for you to copy.+- **File Search:** large or old files, found through Spotlight.++<details>+<summary>Developer, Build Artifacts, and Space, in detail</summary>++<br>++**Developer:** caches of Xcode, package managers, build systems, editors, cloud and virtual machine tools, game+engines, and AI models, the graphics caches of Chrome, Chromium, Brave, and Opera, and the web caches of apps built+on Electron, such as Slack or Discord (never what a browser or an app keeps for you), and the browser profiles a+Playwright run left in the temporary folder when it ended early, never one a browser still has open. Xcode's+archives and the symbols it copied from your devices, model weights, installed packages, and what a tool keeps for+you to install again (Vagrant boxes, Asset Store packages, Godot's export templates) are listed but never selected+for you, and toolchains or anything holding an account are never listed.++**Build Artifacts:** what builds left in the folders you choose, like `node_modules`, `DerivedData`, `target`,+`.nuxt`, `__pycache__`, Unity's `Library`, and any folder its tool tagged as a cache (`CACHEDIR.TAG`), each only+when a file of the tool that makes it proves it. A project changed in the last 7 days is never selected for you, and+neither are installed packages (a Python environment, `vendor`, Terraform's `.terraform`) or a folder like `target`+whose name says nothing on its own. Until you choose a folder, Peel offers `~/Developer`, `~/Projects`, `~/Code`,+or `~/src` when you have one, and adds it only when you say so.++**Space:** what's taking up room, and which app it belongs to. What an app manages itself, such as Xcode's+simulators, Docker's disk, Rust's toolchains, or Android's NDK versions, Space measures and leaves to that tool,+with the command that frees it for you to copy into Terminal: Peel never runs it, since it deletes for good. The+caches and logs apps keep for every account, and the crash reports macOS keeps, in the Library at the top of the+disk, go through Peel's helper when an administrator owns them, and what macOS keeps there for its own services is+never listed. Peel can also warn you, with a notification that opens Space, when less than a tenth of your disk is+available: turn it on in Settings > General.++</details>++<p align="center">+ <img src="readme-assets/peel-developer-caches-of-your-tools.png" width="900" alt="Peel's Developer page: the tools whose caches it found, largest first, and npm open, with its four folders selected, while the bar counts what is selected on four pages">+</p>++Developer shows what each of your developer tools keeps, folder by folder.++What you select on these pages, iCloud Drive aside, stays selected while you look at the others, and Move to Trash+on any of them moves it all at once, as one entry in History. Only the pages you have opened count, so nothing Peel+selected on a page you never saw goes with it. The bar at the foot of the page says how many pages that is, and+lists them.++## Look after your Mac++<p align="center">+ <img src="readme-assets/peel-homebrew-updates-and-cleanup.png" width="900" alt="Peel's Homebrew page: Homebrew's version and location, its maintenance buttons, the formulae with known vulnerabilities, the packages with updates waiting, and an ⓘ note explaining the vulnerability scan; beside them, openssl@3 with its known vulnerabilities, Upgrade, and Uninstall">+</p>++> [!TIP]+> Not sure what something means? Click the ⓘ next to its name, like the one open above beside Scan for+> Vulnerabilities, for a short explanation in plain words. Next to a file, it tells you why Peel thinks the file+> belongs to the app.++- **Background Items:** launch agents and daemons, and the app that added each one.+- **Extensions and Plug-ins:** app extensions, system extensions, and plug-ins, from audio units to Quick Look.+- **Package Receipts:** what installer packages put on your Mac, item by item.+- **Intel Software:** what still needs Rosetta: apps, the helpers and tools inside universal apps, plug-ins,+ drivers, background items, and the commands in `/usr/local`.+- **Homebrew:** your formulae and casks, with Update, Clean Up (and two deeper ones: downloads older than 30 days,+ or every download), Repair Taps, Check Health, Scan for Vulnerabilities, Upgrade, and Uninstall, or the command to+ run in Terminal for a cask that asks for an administrator's password.++## Fine-tune your Mac++<p align="center">+ <img src="readme-assets/peel-tweaks-hidden-macos-settings.png" width="900" alt="Peel's Tweaks page, on Screenshots: no floating thumbnail after a screenshot, where screenshots are saved, no shadow around a captured window, names without the date, what screenshots are named, and JPEG instead of PNG, each with its own control, and Turn All Off">+</p>++Small tricks that make everyday life on a Mac a little easier. Tweaks gathers 39 settings macOS already has but+keeps out of sight, in six groups: Dock, Screenshots, Finder, Typing, Windows, and Privacy. Make a hidden Dock+appear at once, save screenshots where you want them and without the floating thumbnail, show hidden files and+every file extension in Finder, keep straight quotes as you type, drag a window from anywhere in it, or put+seconds on the menu bar clock. Each tweak says what it changes, and turning it off puts back what was there+before, or leaves it to macOS.++## Set up Terminal++<p align="center">+ <img src="Terminal/Renders/Hadal.png" width="49%" alt="The Hadal theme in Terminal">+ <img src="Terminal/Renders/Noctiluca.png" width="49%" alt="The Noctiluca theme in Terminal">+</p>++Peel comes with 29 dark themes for Terminal, built on Apple's own Clear Dark. Choose one, and Terminal opens with it+in every new window; Put Back gives Terminal its own profile again. The same page can leave out the "Last login"+line, make Option the Meta key, and silence the bell.++It sets up the command line as well. Choose a prompt, or keep the one macOS sets, and turn on settings zsh, Git, and+ssh already have, each with a switch: a longer history shared between windows, Up and Down that find what you started+typing, Tab completion with a menu, rebase when pulling, and connections that stay alive. Peel writes them to files of+its own, which zsh and ssh read through a line you add, and changes Git's with `git config`, so Turn All Off puts+everything back. The Tools tab suggests command-line tools worth having, with the Homebrew command and the lines to+add. [TERMINAL.md](TERMINAL.md) shows every theme and every setting, with what each one writes.++## Stay in control++- **History:** everything Peel moved to the Trash, ready to put back, from the app and from Terminal alike, and+ what it was asked to move and wouldn't, with the reason for each item.+- **Exclusions:** files, folders, and apps Peel must never touch.++## Work your way++<p align="center">+ <img src="readme-assets/peel-settings-sidebar-tools.png" width="900" alt="Peel's Settings, on General: app updates, App Folders, the Homebrew Peel uses, what Peel does while it runs, and Choose Tools open, with a checkbox for each tool the sidebar can show">+</p>++Settings > General holds Peel's choices, among them which tools the sidebar shows.++- **Export:** what's installed and where each app came from, as JSON, a spreadsheet, plain text, or a Brewfile.+- **Shortcuts:** actions that open a page in Peel for you to look at. None of them removes anything.+- **Sidebar:** turn off the tools you don't use in Settings, and they leave the sidebar. The View menu and+ Shortcuts still open them. Background Items, Extensions, Plug-ins, Build Artifacts, Intel Software, and Terminal+ start turned off, and Homebrew starts on only when Homebrew is installed; what you turn on or off stays so.+- **The `peel` command:** most of the above, from Terminal.++With Show in Menu Bar on, Peel's menu bar item lists what each tool found the last time it looked, a line per tool+that opens it in Peel. It never adds them up into one figure and never selects anything for you.++## What Peel asks for, and why++<p align="center">+ <img src="readme-assets/peel-home-permissions-and-disk-space.png" width="900" alt="Peel's Home, beside the sidebar with every tool: this Mac's chip, memory, macOS version, and free space, what Peel has moved to the Trash so far, and which permissions are on">+</p>++Peel opens without any of these and does more with each one. Home, in the picture above, shows which ones are on+and takes you straight to the right place in System Settings.++| Permission | What it lets Peel do |+|---|---|+| Full Disk Access | Look inside the Trash and the private folders where apps keep their data. Without it, Peel can't find everything an app leaves behind. |+| App Management | Move another developer's app to the Trash. Without it, Peel can still clear an app's files, but macOS may refuse to move the app itself. |+| Helper | Move the leftovers that sit in folders only an administrator can change, and start or stop other developers' background items that run as root. macOS asks you to approve it once, in Login Items & Extensions. |+| Notifications (optional) | Tell you when your apps have updates, when your disk is almost full if you turn that warning on, and, with Watch the Trash on, when you move an app to the Trash yourself. |+| Finder extension (optional) | Add Uninstall with Peel to the menu you get when you Control-click an app in Finder. |+| Open at Login (optional) | Start Peel when you log in. With Show in Menu Bar on, it keeps running after you close its window, so Watch the Trash keeps working. |++## Languages++Peel is in English and translated into 17 languages: Romanian, German, French, Spanish, Portuguese (Brazilian),+Italian, Japanese, Chinese (Simplified), Chinese (Traditional), Dutch, Korean, Russian, Polish, Turkish, Swedish,+Czech, and Ukrainian. It uses the first language in your Mac's list that it speaks, and English for any other. Each+translation uses the words macOS itself uses in that language.++To use Peel in a language other than your Mac's, open System Settings > General > Language & Region, click the Add+button under Applications, and choose Peel and a language. The `peel` command stays in English, since scripts read+it.++## Uninstall Peel++In Settings > General, choose Remove Peel. It has its helper move its record of what it moved to the Trash, removes+its helper and its login item, moves itself, the files that are certainly its own, and its folder in Application+Support to the Trash, clears its settings, and quits. That+folder holds History, your exclusions, and the settings Peel saved when you reset an app.++What Peel changed for you stays as it is: tweaks, Terminal's theme, and Git's settings. Turn them off first if you+want them gone. The shell and ssh settings live in Peel's folder, so they go with it, and the line you added to+`~/.zshrc` and the two at the end of `~/.ssh/config` then do nothing. You can delete them.++If you installed Peel with Homebrew, Settings shows this command in its place, with a button that copies it. Run it+in Terminal: Homebrew takes Peel off its list of what is installed, deletes the app rather than moving it to the+Trash, and moves Peel's files to the Trash.++```bash+brew uninstall --zap --cask peel+```++If you put the `peel` command on your path from Settings, remove that link too. Homebrew removes only the one it+made.++```bash+sudo rm -f /usr/local/bin/peel+```++## Questions++### Why does Peel show a smaller size than Finder?++Peel shows what moving an item to the Trash would free, and Finder shows the space it takes. The two differ when+files share their space: a copy Finder makes on an APFS disk shares its blocks with the original until one of them+changes, and a file can have a second name somewhere else, which keeps it. Peel counts only what would really go.++### Why does Peel ask for Full Disk Access?++macOS keeps other apps' data, and the Trash, out of sight of any app without it. Peel works without it, but can't+see everything an app leaves behind. [PRIVACY.md](PRIVACY.md) lists the only times Peel goes online.++### Is Peel really free?++Yes. Peel is free and open source under the GNU General Public License, with no paid edition, no ads, and no+account.++### Something in Peel isn't clear. Where can I read more?++Click the ⓘ next to its name. If it's still not clear,+[open an issue](https://github.com/TuguiDragos/Peel/issues/new/choose): wording that leaves you guessing is a bug+too.diff --git a/README.md b/README.mdindex 7d111dfc..29bd8f64 100644--- a/README.md+++ b/README.md@@ -50,193 +50,16 @@ To update Peel, download the new release and replace the copy in your Applicatio## Why Peel-<p align="center">- <img src="readme-assets/peel-home-permissions-and-disk-space.png" width="900" alt="Peel's Home, beside the sidebar with every tool: this Mac's chip, memory, macOS version, and free space, what Peel has moved to the Trash so far, and which permissions are on">-</p>-Dragging an app to the Trash leaves pieces of it behind: caches, settings, containers, launch agents, and supportfiles scattered across your Library, sometimes gigabytes of them. Peel finds what an app left, tells you why eachfile belongs to it and how sure it is, and moves what you choose to the Trash. Nothing is deleted, and History canput all of it back.-With Show in Menu Bar on, Peel's menu bar item lists what each tool found the last time it looked, a line per tool-that opens it in Peel. It never adds them up into one figure and never selects anything for you.-Peel is free and open source, and it speaks English and 17 other languages.## What Peel does-### Uninstall apps completely--<p align="center">- <img src="readme-assets/peel-uninstall-app-with-leftover-files.png" width="900" alt="Peel uninstalling Obsidian: the app, what it left in Application Support, caches, and preferences, and the command Homebrew linked to it, each with its kind and size, selected and ready to move to the Trash, with its list of recent documents under Review Before Removing, its privacy permissions to reset, and the links it opens by default">-</p>--- **Every leftover, with a reason.** Peel searches the places apps keep files: Application Support, caches,- containers and group containers, preferences, saved state, logs, launch agents and daemons, plug-in folders, and- more. Each file comes with the reason it matched, such as the app's bundle identifier, its signing team, or a- Homebrew cask that names it.-- **Only the sure things are selected.** Files that certainly belong to the app are selected for you, unless Peel- sees something inside that may exist nowhere else, such as a crypto wallet, a signing key, a password database, or- a repository, or the app keeps there what may exist only on this Mac: local mail, message history, sign-in codes,- or VPN connections. A file another installed app also uses is shown but never selected, and anything Peel is less- sure of waits under Review Before Removing. A list's Select menu picks what Peel recommends, everything, or- nothing. Select All passes by what Peel holds back, guesses at, or shares with another app, which you select one- by one, and asks before it adds anything else Peel doesn't recommend.-- **Several ways in.** Choose an app in the list, drop one on Peel's Dock icon, select several apps at once, or- Control-click an app in Finder and choose Uninstall with Peel. With Watch the Trash on, Peel notices when you- drag an app to the Trash yourself and offers to clear what it left behind. Apps you keep outside the Applications- folders, such as on another disk, join the list once you add their folder in Settings > General > App Folders.-- **Reset instead of remove.** Clear an app's settings without uninstalling it. Peel saves them first, so you can- put them back, and never selects your own work.-- **Privacy permissions too, if you want.** Peel can also reset the permissions macOS gave the app, such as access- to the camera and the microphone.-- **Its Dock icon too.** Peel takes the app's icon out of the Dock, where it would stay as a question mark,- unless you deselect it, and History puts it back where it was when you put the app back.-- **What it opens.** An app's page lists the kinds of files and links it opens by default, and what would open- them once it's gone. Peel never changes that itself.-- **Updates for your apps.** Peel checks your apps for new versions, through the update feed each app names or the- App Store for apps bought there, and shows what is new in the version that waits, as the app's own notes say it,- with no connection too. Skip This Version and Never Check This App keep it quiet about the ones you want left- alone.--### Free up disk space--<p align="center">- <img src="readme-assets/peel-space-areas-of-your-disk.png" width="900" alt="Peel's Space page: how much of the disk is free and used, the areas of your Library with their sizes, and Hidden App Caches open, with what it is and the caches inside it, selected on three pages">-</p>--Space shows what fills your disk, area by area, and what each area is.--- **Orphaned Files:** files left behind by apps you already removed.-- **Developer:** caches of developer tools, editors, browsers, and AI models. What you may want again is listed but- never selected for you, and toolchains or anything holding an account are never listed.-- **Build Artifacts:** what builds left in your projects, like `node_modules`, `DerivedData`, or `target`, each only- when its tool's own file proves it. A project changed in the last 7 days is never selected for you.-- **Duplicates:** files and whole folders with identical contents, compared with SHA-256. One copy is always kept.- Files under 100 KB, and folders holding less, are left out unless you choose a smaller size, in the app and in- `peel duplicates` alike.-- **Installers and Backups:** installers of apps you already have, including packages an app keeps in Application- Support, macOS installers, device firmware, downloads a browser never finished, updates apps downloaded and keep- until they install them, and what your iPhone backups hold. Nothing is selected for you.-- **iCloud Drive:** files already safe in iCloud that are also downloaded to this Mac. Remove Downloads, as in- Finder, takes away only the copy on this Mac: each file stays in iCloud and downloads again when you open it.-- **Space:** what's taking up room, and which app it belongs to. What an app manages itself, such as Docker's disk,- Space leaves to that app, with the command that frees it for you to copy.-- **File Search:** large or old files, found through Spotlight.--<details>-<summary>Developer, Build Artifacts, and Space, in detail</summary>--<br>--**Developer:** caches of Xcode, package managers, build systems, editors, cloud and virtual machine tools, game-engines, and AI models, the graphics caches of Chrome, Chromium, Brave, and Opera, and the web caches of apps built-on Electron, such as Slack or Discord (never what a browser or an app keeps for you), and the browser profiles a-Playwright run left in the temporary folder when it ended early, never one a browser still has open. Xcode's-archives and the symbols it copied from your devices, model weights, installed packages, and what a tool keeps for-you to install again (Vagrant boxes, Asset Store packages, Godot's export templates) are listed but never selected-for you, and toolchains or anything holding an account are never listed.--**Build Artifacts:** what builds left in the folders you choose, like `node_modules`, `DerivedData`, `target`,-`.nuxt`, `__pycache__`, Unity's `Library`, and any folder its tool tagged as a cache (`CACHEDIR.TAG`), each only-when a file of the tool that makes it proves it. A project changed in the last 7 days is never selected for you, and-neither are installed packages (a Python environment, `vendor`, Terraform's `.terraform`) or a folder like `target`-whose name says nothing on its own. Until you choose a folder, Peel offers `~/Developer`, `~/Projects`, `~/Code`,-or `~/src` when you have one, and adds it only when you say so.--**Space:** what's taking up room, and which app it belongs to. What an app manages itself, such as Xcode's-simulators, Docker's disk, Rust's toolchains, or Android's NDK versions, Space measures and leaves to that tool,-with the command that frees it for you to copy into Terminal: Peel never runs it, since it deletes for good. The-caches and logs apps keep for every account, and the crash reports macOS keeps, in the Library at the top of the-disk, go through Peel's helper when an administrator owns them, and what macOS keeps there for its own services is-never listed. Peel can also warn you, with a notification that opens Space, when less than a tenth of your disk is-available: turn it on in Settings > General.--</details>--<p align="center">- <img src="readme-assets/peel-developer-caches-of-your-tools.png" width="900" alt="Peel's Developer page: the tools whose caches it found, largest first, and npm open, with its four folders selected, while the bar counts what is selected on four pages">-</p>--Developer shows what each of your developer tools keeps, folder by folder.--What you select on these pages, iCloud Drive aside, stays selected while you look at the others, and Move to Trash-on any of them moves it all at once, as one entry in History. Only the pages you have opened count, so nothing Peel-selected on a page you never saw goes with it. The bar at the foot of the page says how many pages that is, and-lists them.--### Look after your Mac--<p align="center">- <img src="readme-assets/peel-homebrew-updates-and-cleanup.png" width="900" alt="Peel's Homebrew page: Homebrew's version and location, its maintenance buttons, the formulae with known vulnerabilities, the packages with updates waiting, and an ⓘ note explaining the vulnerability scan; beside them, openssl@3 with its known vulnerabilities, Upgrade, and Uninstall">-</p>--> [!TIP]-> Not sure what something means? Click the ⓘ next to its name, like the one open above beside Scan for-> Vulnerabilities, for a short explanation in plain words. Next to a file, it tells you why Peel thinks the file-> belongs to the app.--- **Background Items:** launch agents and daemons, and the app that added each one.-- **Extensions and Plug-ins:** app extensions, system extensions, and plug-ins, from audio units to Quick Look.-- **Package Receipts:** what installer packages put on your Mac, item by item.-- **Intel Software:** what still needs Rosetta: apps, the helpers and tools inside universal apps, plug-ins,- drivers, background items, and the commands in `/usr/local`.-- **Homebrew:** your formulae and casks, with Update, Clean Up (and two deeper ones: downloads older than 30 days,- or every download), Repair Taps, Check Health, Scan for Vulnerabilities, Upgrade, and Uninstall, or the command to- run in Terminal for a cask that asks for an administrator's password.--### Fine-tune your Mac--<p align="center">- <img src="readme-assets/peel-tweaks-hidden-macos-settings.png" width="900" alt="Peel's Tweaks page, on Screenshots: no floating thumbnail after a screenshot, where screenshots are saved, no shadow around a captured window, names without the date, what screenshots are named, and JPEG instead of PNG, each with its own control, and Turn All Off">-</p>--Small tricks that make everyday life on a Mac a little easier. Tweaks gathers 39 settings macOS already has but-keeps out of sight, in six groups: Dock, Screenshots, Finder, Typing, Windows, and Privacy. Make a hidden Dock-appear at once, save screenshots where you want them and without the floating thumbnail, show hidden files and-every file extension in Finder, keep straight quotes as you type, drag a window from anywhere in it, or put-seconds on the menu bar clock. Each tweak says what it changes, and turning it off puts back what was there-before, or leaves it to macOS.--### Set up Terminal--<p align="center">- <img src="Terminal/Renders/Hadal.png" width="49%" alt="The Hadal theme in Terminal">- <img src="Terminal/Renders/Noctiluca.png" width="49%" alt="The Noctiluca theme in Terminal">-</p>--Peel comes with 29 dark themes for Terminal, built on Apple's own Clear Dark. Choose one, and Terminal opens with it-in every new window; Put Back gives Terminal its own profile again. The same page can leave out the "Last login"-line, make Option the Meta key, and silence the bell.--It sets up the command line as well. Choose a prompt, or keep the one macOS sets, and turn on settings zsh, Git, and-ssh already have, each with a switch: a longer history shared between windows, Up and Down that find what you started-typing, Tab completion with a menu, rebase when pulling, and connections that stay alive. Peel writes them to files of-its own, which zsh and ssh read through a line you add, and changes Git's with `git config`, so Turn All Off puts-everything back. The Tools tab suggests command-line tools worth having, with the Homebrew command and the lines to-add. [TERMINAL.md](TERMINAL.md) shows every theme and every setting, with what each one writes.--### Stay in control--- **History:** everything Peel moved to the Trash, ready to put back, from the app and from Terminal alike, and- what it was asked to move and wouldn't, with the reason for each item.-- **Exclusions:** files, folders, and apps Peel must never touch.--### Work your way--<p align="center">- <img src="readme-assets/peel-settings-sidebar-tools.png" width="900" alt="Peel's Settings, on General: app updates, App Folders, the Homebrew Peel uses, what Peel does while it runs, and Choose Tools open, with a checkbox for each tool the sidebar can show">-</p>--Settings > General holds Peel's choices, among them which tools the sidebar shows.--- **Export:** what's installed and where each app came from, as JSON, a spreadsheet, plain text, or a Brewfile.-- **Shortcuts:** actions that open a page in Peel for you to look at. None of them removes anything.-- **Sidebar:** turn off the tools you don't use in Settings, and they leave the sidebar. The View menu and- Shortcuts still open them. Background Items, Extensions, Plug-ins, Build Artifacts, Intel Software, and Terminal- start turned off, and Homebrew starts on only when Homebrew is installed; what you turn on or off stays so.-- **The `peel` command:** most of the above, from Terminal.+[GUIDE.md](GUIDE.md) shows what each tool does, what Peel asks for and why, and how to remove Peel.## Safe by design@@ -267,31 +90,6 @@ A cleaner should never cost you something you wanted. Peel is built around that.[SAFETY.md](SAFETY.md) lists everything Peel protects, and [ARCHITECTURE.md](ARCHITECTURE.md) shows how aremoval travels through the code.-## What Peel asks for, and why--Peel opens without any of these and does more with each one. Home, the first picture on this page, shows which ones-are on and takes you straight to the right place in System Settings.--| Permission | What it lets Peel do |-|---|---|-| Full Disk Access | Look inside the Trash and the private folders where apps keep their data. Without it, Peel can't find everything an app leaves behind. |-| App Management | Move another developer's app to the Trash. Without it, Peel can still clear an app's files, but macOS may refuse to move the app itself. |-| Helper | Move the leftovers that sit in folders only an administrator can change, and start or stop other developers' background items that run as root. macOS asks you to approve it once, in Login Items & Extensions. |-| Notifications (optional) | Tell you when your apps have updates, when your disk is almost full if you turn that warning on, and, with Watch the Trash on, when you move an app to the Trash yourself. |-| Finder extension (optional) | Add Uninstall with Peel to the menu you get when you Control-click an app in Finder. |-| Open at Login (optional) | Start Peel when you log in. With Show in Menu Bar on, it keeps running after you close its window, so Watch the Trash keeps working. |--## Languages--Peel is in English and translated into 17 languages: Romanian, German, French, Spanish, Portuguese (Brazilian),-Italian, Japanese, Chinese (Simplified), Chinese (Traditional), Dutch, Korean, Russian, Polish, Turkish, Swedish,-Czech, and Ukrainian. It uses the first language in your Mac's list that it speaks, and English for any other. Each-translation uses the words macOS itself uses in that language.--To use Peel in a language other than your Mac's, open System Settings > General > Language & Region, click the Add-button under Applications, and choose Peel and a language. The `peel` command stays in English, since scripts read-it.-## PrivacyPeel sends no analytics and has no account. [PRIVACY.md](PRIVACY.md) says when Peel goes online, what it sends, and@@ -358,27 +156,6 @@ your keychains, Mail, Messages, and photo libraries.</details>-<details>-<summary><strong>Why does Peel show a smaller size than Finder?</strong></summary>--<br>--Peel shows what moving an item to the Trash would free, and Finder shows the space it takes. The two differ when-files share their space: a copy Finder makes on an APFS disk shares its blocks with the original until one of them-changes, and a file can have a second name somewhere else, which keeps it. Peel counts only what would really go.--</details>--<details>-<summary><strong>Why does Peel ask for Full Disk Access?</strong></summary>--<br>--macOS keeps other apps' data, and the Trash, out of sight of any app without it. Peel works without it, but can't-see everything an app leaves behind. [PRIVACY.md](PRIVACY.md) lists the only times Peel goes online.--</details>-<details><summary><strong>Does Peel collect any data?</strong></summary>@@ -389,16 +166,6 @@ off, and when you ask Homebrew to do something.</details>-<details>-<summary><strong>Is Peel really free?</strong></summary>--<br>--Yes. Peel is free and open source under the GNU General Public License, with no paid edition, no ads, and no-account.--</details>-<details><summary><strong>Does Peel work on Intel Macs and older versions of macOS?</strong></summary>@@ -410,43 +177,6 @@ never runs where it hasn't been tested.</details>-<details>-<summary><strong>Something in Peel isn't clear. Where can I read more?</strong></summary>--<br>--Click the ⓘ next to its name. If it's still not clear,-[open an issue](https://github.com/TuguiDragos/Peel/issues/new/choose): wording that leaves you guessing is a bug-too.--</details>--## Uninstall Peel--In Settings > General, choose Remove Peel. It has its helper move its record of what it moved to the Trash, removes-its helper and its login item, moves itself, the files that are certainly its own, and its folder in Application-Support to the Trash, clears its settings, and quits. That-folder holds History, your exclusions, and the settings Peel saved when you reset an app.--What Peel changed for you stays as it is: tweaks, Terminal's theme, and Git's settings. Turn them off first if you-want them gone. The shell and ssh settings live in Peel's folder, so they go with it, and the line you added to-`~/.zshrc` and the two at the end of `~/.ssh/config` then do nothing. You can delete them.--If you installed Peel with Homebrew, Settings shows this command in its place, with a button that copies it. Run it-in Terminal: Homebrew takes Peel off its list of what is installed, deletes the app rather than moving it to the-Trash, and moves Peel's files to the Trash.--```bash-brew uninstall --zap --cask peel-```--If you put the `peel` command on your path from Settings, remove that link too. Homebrew removes only the one it-made.--```bash-sudo rm -f /usr/local/bin/peel-```-## Build it yourselfYou need macOS Tahoe 26 or later, Xcode 27 (Swift 6.4), and a team to sign with, even a free one. Open