# Mac Tweaks

> Lightspot’s Mac Tweaks frees disk space macOS keeps, turns Apple Intelligence off for every account on a Mac and removes its models, changes 41 macOS settings with undo, and turns off or deletes other apps’ launch agents and daemons.

- URL: https://afixer.app/lightspot/mac-tweaks
- Part of: Projects › Lightspot
- Language: en

Mac Tweaks frees the space macOS keeps, turns Apple Intelligence off for every account on your Mac and removes its models, changes 41 macOS settings with undo, and turns off or deletes the launch agents and daemons other apps installed. Each section shows its plan before it changes anything and ends with a receipt.

## Opening it

Type `mac tweaks`, `free up space`, `debloat` or what you want gone, such as `remove garageband`, `macos installers`, `time machine snapshots`, `ipsw` or `app caches`, and press ↵ on the _Mac Tweaks_ row, or choose **Mac Tweaks…** in the [menu](https://afixer.app/lightspot/settings), right under **Clean Dev Mac…**. Before the first scan the row says _Free up space and tidy macOS_; after one, it gives what Free Up Space found, as in _16.3 GB you can free_.

Three more rows open Mac Tweaks on a section. _Mac Tweaks: Apple Intelligence_ answers to `turn off apple intelligence`, `remove apple intelligence` and `delete apple intelligence models`; `apple intelligence` alone shows it below System Settings’ own _Apple Intelligence & Siri_ pane. _Mac Tweaks: Settings_ answers to `stop music from opening`, `turn off apple music`, `turn off mac analytics`, `turn off personalized ads` and `show the library folder`. _Mac Tweaks: Background Items_ answers to `turn off background items`, `turn off launch agents`, `disable launch agents`, `turn off google updater`, `leftover launch agents` and `launch daemons`; `background items` and `launch agents` alone show it below System Settings’ own _Login Items_ row.

The rows answer to phrases, not to words that other rows own: `pages` or `garageband` still puts the app first, and `clean`, `dock`, `storage`, `music` and `library` keep their own rows. So do `disable`, `launch` and `background`: a Background Items phrase matches by its start only once you have typed into its second word. `free up space` also finds [Clean Dev Mac](https://afixer.app/lightspot/clean-dev-mac), with Mac Tweaks as the Top Hit; Mac Tweaks links to it.

Mac Tweaks opens in a window of its own with a tab per section: **Free Up Space**, **Apple Intelligence**, **Settings** and **Background Items**. ⇥ and ⇧⇥ switch between them. Apple Intelligence appears only on a Mac with Apple silicon and macOS 15.1 or later, where its features exist; Settings and Background Items appear on every Mac Lightspot runs on. A section reads what it needs when you first open it, in the background, and keeps its scan for five minutes, so reopening Mac Tweaks within them shows it again.

The window is new in 1.4.1; up to 1.4.0 Mac Tweaks was drawn inside the search panel, which closed when System Settings or a Touch ID prompt came to the front. The window stays open while you approve a profile in System Settings or answer a Touch ID prompt. Move it where you like and it opens there next time; it can be made larger, not smaller. It closes with its close button, ⌘W, or Esc when no plan or wait is open, and an apply keeps running with it closed. When it is already open, the search rows and the menu item bring it to the front, switched to the section a row names. Free Up Space’s link to Clean Dev Mac opens Clean Dev Mac’s own window, and the links to System Settings leave Mac Tweaks open. The screenshots on this page are 1.4.1’s window: Free Up Space on demo folders, the other sections on read-only scans of my Mac.

## Free Up Space

Free Up Space looks for the space macOS keeps that its own Storage settings won’t give back. The scan runs in the background while the window says what it is looking at, and it carries on if you close the window.

![Mac Tweaks’ window on Free Up Space, with tabs for its four sections: “Found 38.9 GB in 6 places · 25.3 GB ticked”, macOS installers and iPhone and iPad updates ticked, the updates row selected with its .ipsw file, then aerial videos, GarageBand and its sound library and iMovie tagged May ask for password, and app caches](https://afixer.app/lightspot/shots/mac-tweaks-free-up-space.webp)

_Free Up Space on demo folders; my own Mac has nothing left to free_

Rows are measured the way Clean Dev Mac measures, by the space their files take on disk, and shown in Finder’s units. A row with nothing to offer is hidden, and so is anything that takes no space: an empty folder that only an administrator may move would put a password prompt in the plan to free nothing. macOS gives no size for Time Machine’s snapshots, so their row shows how many there are.

| Row                               | What it offers                                                     | Where it goes                       | Ticked |
| --------------------------------- | ------------------------------------------------------------------ | ----------------------------------- | ------ |
| macOS installers                  | Old Install macOS apps in Applications                             | Trash                               | Yes    |
| iPhone and iPad updates           | Software updates Finder downloaded for them                        | Trash                               | Yes    |
| Unavailable simulators            | Simulators whose runtime is no longer installed                    | Deleted by simctl                   | Yes    |
| Time Machine local snapshots      | The copies Time Machine keeps on this disk between backups         | Deleted by tmutil, as administrator | No     |
| Aerial videos                     | The aerial wallpaper and screen saver videos every account shares  | Trash                               | No     |
| GarageBand and its sound library  | The app, with its loops and instruments                            | Trash                               | No     |
| iMovie, Keynote, Numbers, Pages   | Apple’s optional apps, one row each                                | Trash                               | No     |
| App caches                        | Other apps’ caches in \~/Library/Caches                            | Trash                               | No     |
| Apple Intelligence models         | Opens the Apple Intelligence section, while its models are on disk |                                     |        |
| Developer caches and project junk | Opens Clean Dev Mac                                                |                                     |        |
| More in System Settings           | Opens Storage in System Settings                                   |                                     |        |

The selected row shows its first four items with their sizes. Tags beside the size say _Deleted right away_ where nothing goes to the Trash, and _May ask for password_ where an administrator has to act (see [Password](https://afixer.app/lightspot/mac-tweaks#password)). A caveat in the warning colour says what to know first.

### macOS installers

The Install macOS apps an upgrade leaves in Applications. Lightspot offers each `Install macOS*.app` in `/Applications` whose own Info.plist gives Apple’s installer identifier, one starting with `com.apple.InstallAssistant`, so an app that only has the name stays. The App Store downloads one again if you need it. They go to the Trash, and the row is ticked.

### iPhone and iPad updates

The software updates Finder downloaded for iPhones and iPads: everything in `~/Library/iTunes/iPhone Software Updates` and `~/Library/iTunes/iPad Software Updates` except hidden files. Finder downloads them again when it needs them. They go to the Trash, and the row is ticked.

### Unavailable simulators

Simulators whose runtime is no longer installed, so they can’t start. Lightspot asks Xcode’s `simctl` which devices are unavailable and measures their folders in `~/Library/Developer/CoreSimulator/Devices`. Applying runs `simctl delete unavailable` as you, without a password, and simctl deletes them right away instead of moving them to the Trash. The row is ticked.

Lightspot runs simctl from the developer folder that `xcode-select -p` names, and only when `~/Library/Developer/CoreSimulator/Devices` exists. It never runs `/usr/bin/xcrun`, which opens the Command Line Tools installer on a Mac without them. With only the Command Line Tools installed there is no simctl, so there is no row and nothing runs.

### Time Machine local snapshots

The hourly copies Time Machine keeps on this disk between backups, which macOS counts as System Data. The row lists the dates `tmutil listlocalsnapshotdates /` prints and shows how many there are. Applying deletes each one with `tmutil deletelocalsnapshots`, run as administrator, so macOS may ask for Touch ID or your password. They are deleted right away; backups on your backup disk aren’t touched. The row is not ticked.

### Aerial videos

Videos for the moving aerial wallpapers and screen savers, in `/Library/Application Support/com.apple.idleassetsd/Customer`, shared by every account on the Mac. macOS downloads one again when you choose it, and if you use an aerial wallpaper or screen saver now, the row says that macOS will download it again. The strings bundle macOS keeps beside the videos stays, and each account’s own copies are a Clean Dev Mac row. They go to the Trash; the row is not ticked.

### GarageBand and its sound library

One of Apple’s optional apps, with the loops and instruments it downloaded: `/Applications/GarageBand.app` when its Info.plist says it is Apple’s (`com.apple.garageband10`), together with `/Library/Application Support/GarageBand`, `/Library/Application Support/Logic` and `/Library/Audio/Apple Loops/Apple`. Logic Pro and MainStage use the same library, so while either is installed, anywhere macOS’s LaunchServices knows of, the library stays and the row names the app that uses it. Without GarageBand in Applications there is no row. It reinstalls free from the App Store. Everything goes to the Trash; the row is not ticked.

### iMovie, Keynote, Numbers and Pages

Apple’s optional apps, a row each: `iMovie.app`, `Keynote.app`, `Numbers.app` and `Pages.app` in `/Applications`, each only with Apple’s identifier (`com.apple.iMovieApp`, `com.apple.iWork.Keynote`, `com.apple.iWork.Numbers`, `com.apple.iWork.Pages`), so a `Pages.app` that isn’t Apple’s stays. Each reinstalls free from the App Store, and your documents stay. They go to the Trash; the rows are not ticked. If macOS won’t let Lightspot move an app, the [receipt](https://afixer.app/lightspot/mac-tweaks#free-up-space-receipt) says what to do.

### App caches

Files apps keep in `~/Library/Caches` to start faster. Apps rebuild them, so the next launch can be slower: quit your apps first. They go to the Trash; the row is not ticked. These stay:

- macOS’s own caches: names starting with `com.apple.` or `AAProfilePicture`, the macOS cache names RemoveMacAI lists (`GeoServices`, `CloudKit`, `Animoji` and others), and three more that macOS writes, `Brushes`, `MiniLauncher` and `mbuseragent`.
- Lightspot’s own, `com.lightspot.app`, and hidden entries.
- Everything Clean Dev Mac cleans, as explained below.

### The links

_Apple Intelligence models_ shows the size of the models Apple Intelligence downloaded and opens [its section](https://afixer.app/lightspot/mac-tweaks#apple-intelligence) to remove them. It appears once that section has been scanned, and only while the models are on disk. _Developer caches and project junk_ opens [Clean Dev Mac](https://afixer.app/lightspot/clean-dev-mac). _More in System Settings_ opens Storage in System Settings, for iPhone backups, Messages attachments and other files only macOS can manage. ↵ opens them; Space does nothing on them.

### App caches and Clean Dev Mac

Clean Dev Mac already cleans some of what is in `~/Library/Caches`, such as Chrome’s cache (`Google`) and apps’ updater folders (`*.ShipIt`). App caches leaves every entry that a Clean Dev Mac rule reaches into to Clean Dev Mac, so the two never count the same folder: for each rule under `~/Library/Caches`, Mac Tweaks takes the first name below it as a pattern and leaves out every entry that matches. The row says so: _Developer and browser caches are in Clean Dev Mac._

Mac Tweaks uses the rules Lightspot already has and never fetches them: the ones Clean Dev Mac holds from its last scan or download, else your `~/.cleandevmac/rules`, else the copy built into Lightspot.

### The plan

Installers, iPhone and iPad updates and simulators start ticked; the rest wait for you. **Defaults** and **None** reset the ticks, and the line above the list says what was found and how much is ticked. ↵ shows the plan: _Free up …?_, then each ticked row with how many items it holds, what happens to them and the first paths. Nothing has happened yet. Below the rows the plan says where things go, as in _Files go to the Trash. Simulators and snapshots are deleted right away._ When an administrator has something to do, it adds _macOS may ask for Touch ID or your password._ ↵ again applies; Esc goes back to the list.

### Applying

Mac Tweaks shows each step as it goes, in this order:

1. Every ticked file goes to the Trash, each one checked again first (see [Safety](https://afixer.app/lightspot/mac-tweaks#safety)).
2. What only an administrator can do runs next, as one script: the files the Trash move couldn’t take because another user owns them or a folder’s permissions refused, and the snapshots.
3. Unavailable simulators go through `simctl delete unavailable`.
4. Then Lightspot looks again at everything it touched, and measures what is still there.

Applying keeps running if you close the window. Reopen Mac Tweaks to see the steps, then the receipt.

### When it asks for your password

Most of Free Up Space needs no password: Lightspot moves files to the Trash as you, and simctl deletes simulators as you. An administrator has to act only:

- to delete Time Machine local snapshots;
- to move an item that belongs to another user, root for example, which the scan sees and tags with _May ask for password_;
- to move one of your own items that a folder’s permissions won’t let you move.

All of it goes into one script, which runs once and only when it has something to do. It runs through `sudo` with Touch ID when you turned on [Touch ID for sudo](https://afixer.app/lightspot/terminal#touch-id), otherwise, or when you cancel Touch ID, through the macOS password dialog. Once it has started it never runs a second time. If you cancel the prompt, nothing runs as administrator, and the receipt lists what stayed and why.

Each move the administrator makes is checked again as it runs: it goes into the item’s folder, carries on only if that is the folder the check approved, makes sure the Trash is still a real folder, and moves the item from there into your Trash under a name nothing there has yet. A path swapped for a symbolic link in the meantime can’t lead it anywhere else.

### The receipt

When the apply ends, Free Up Space says what it freed: how many items went to the Trash and their size, how many simulators and snapshots it deleted, what macOS protects, and everything that stayed, with the reason. When anything went to the Trash it adds _Empty the Trash to get the space back._ Until you empty it, what went there can be taken out again.

- **Freed** counts only what Lightspot moved or deleted, less anything that has grown back at the same path since, such as a cache an app made again. Something that disappeared on its own, even into the Trash while the prompt was open, isn’t counted.
- **Protected by macOS**: a file of yours that macOS itself won’t let go. Nobody can move it without turning protections off, so it stays, and the receipt counts it with its size.
- **Apps**: from macOS 13 on, moving an app another developer made takes the App Management permission, which Lightspot doesn’t have unless you give it. When macOS refuses, the receipt says so: drag the app to the Trash in Finder (⌥↵ on the receipt shows it), or allow Lightspot under System Settings → Privacy & Security → App Management.

## Apple Intelligence

This section turns Apple Intelligence off, feature by feature, for every account on your Mac, and removes the models it downloaded. One configuration profile, _Lightspot Mac Tweaks_, switches the features off and stops their models downloading again. Once you have approved it in System Settings, Lightspot asks Apple’s asset service to remove the models that no feature you kept needs. Removing the profile turns all of it back on.

![Mac Tweaks’ window on Apple Intelligence: “0 of 14 features on · Apple Intelligence’s models aren’t on this Mac”, the row Turn Apple Intelligence back on, then every feature with a lock and Locked off, Siri and Siri AI selected with the foundation models it needs](https://afixer.app/lightspot/shots/mac-tweaks-apple-intelligence.webp)

_Apple Intelligence on my Mac, after turning it off_

### The features

One row per feature your macOS has, with its state; the selected row lists the models it needs, with their sizes. A feature appears from the macOS version that brought it, and Spatial Photos only while Apple’s asset service still knows its models: macOS 26.7.2 had retired them, and macOS 27.2 knows them again.

| Feature                          | What it is, and what off means                                                                      | From macOS | Models                                      |
| -------------------------------- | --------------------------------------------------------------------------------------------------- | ---------- | ------------------------------------------- |
| Siri and Siri AI                 | Siri, including its Apple Intelligence answers. Off means Siri won’t respond.                       | 15.1       | Foundation models                           |
| ChatGPT and other AI extensions  | Third-party AI in Apple apps. Off means they can’t be used or signed into.                          | 15.2       | None                                        |
| Writing Tools                    | Rewrite, proofread and summarize in text fields. Off removes the Writing Tools menu.                | 15.1       | Foundation models                           |
| Genmoji                          | Making your own emoji from a description. Off hides Genmoji in the keyboard.                        | 15.1       | Foundation models, image and Genmoji models |
| Image Playground                 | The Image Playground app and image generation in Apple apps. Off disables both.                     | 15.1       | Foundation models, image and Genmoji models |
| Mail summaries and smart replies | Mail’s message summaries and suggested replies. Off stops Mail summarizing or suggesting.           | 15.1       | Foundation models                           |
| Notification summaries           | Summaries of stacked notifications. Off shows notifications as they arrive.                         | 15.1       | Foundation models                           |
| Messages summaries               | Summaries of long message threads. Off shows messages as they arrive.                               | 15.1       | Foundation models                           |
| Safari summaries                 | Summaries of web pages in Safari. Off removes the summarize button.                                 | 15.4       | Foundation models                           |
| Notes transcription summaries    | Summaries of recorded-audio transcripts in Notes. Off leaves transcripts as they are.               | 15.3       | Foundation models                           |
| Inline text predictions          | Grey suggested text while typing. Off stops the suggestions.                                        | 15.1       | None                                        |
| Spatial Photos                   | Turning flat photos into spatial ones. Off keeps them flat.                                         | 26         | Spatial Photos models                       |
| Photos Clean Up                  | The Clean Up tool in Photos that removes objects. Off removes its model, so the tool stops working. | 15.1       | Photos Clean Up models                      |
| Xcode predictive code completion | Predictive code completion in Xcode. Off removes its model, so completion stops working.            | 15.1       | Xcode code completion models                |

A row’s state is one of:

- _On_.
- _Off_, read from your own settings: Siri, for example, reads off when Siri is switched off in System Settings.
- _Locked off_, by Lightspot’s profile.
- _Managed_, when another configuration profile sets one of its switches. Lightspot leaves it as that profile has it.
- _Unknown_, for a feature that is only its models, when the asset service didn’t report their size. Photos Clean Up and Xcode’s completion read on while their models are on disk.

### The models

The models come in five sets, shared by every account on the Mac, and Lightspot removes a set only when you turn off every feature that needs it:

- _Apple Intelligence foundation models_: Siri, Writing Tools, Genmoji, Image Playground, and the Mail, notification, Messages, Safari and Notes summaries.
- _Image and Genmoji models_: Genmoji and Image Playground.
- _Spatial Photos models_, _Photos Clean Up models_ and _Xcode code completion models_: one feature each.

Keeping Writing Tools, for example, keeps the foundation models on disk. Sizes come from the asset service’s own inventory. On my Mac, macOS 26.7.2 had none of these models on disk, and macOS 27.2 had downloaded 8.0 GB of them.

### Choosing and the plan

Every feature you can change starts ticked, which here means _turn off_: untick the ones to keep. A managed feature, or one already locked off, shows a lock, and Space does nothing on it. A feature you keep stays out of the profile, and so does any feature the section didn’t show, so the profile never touches a feature you didn’t choose.

↵ shows the plan. Its title, like the button, says what it does, and since a feature that is already off isn’t turned off but locked off, it can read _Turn off 11 features, lock 3 already off_. The plan says that it turns these features off for every account on this Mac, which ones stay on, what happens to the models, such as _Deletes 8.0 GB of models and stops macOS downloading them again_, or that they aren’t on this Mac, or that the features you kept need them, and that System Settings asks you to approve one profile.

### Approving the profile

Applying writes the profile to `~/Library/Application Support/Lightspot/LightspotMacTweaks.mobileconfig`, opens it, and a second later opens System Settings at Device Management. Mac Tweaks then says what to do: _In System Settings › General › Device Management, double-click Lightspot Mac Tweaks, then click Install._

It checks once a second, for up to 10 minutes, whether the profile is in. The Mac Tweaks window stays open beside System Settings, and the wait goes on if you close it. Esc in Mac Tweaks stops waiting, and the window then says the wait ended instead of closing; the profile stays in System Settings, and the next apply carries on once you have installed it. The file is deleted once the profile is in.

The profile has the System scope, so it applies to every account on your Mac. For each feature you turn off it sets the feature’s restriction, or forces its preference, to off. For each model set it removes, it points the set’s downloads at a closed port on the Mac itself (`https://127.0.0.1:9/lightspot-blocked/`), so a download fails instead of filling the disk again. Its description in System Settings ends with _Remove this profile to undo everything it changed._, and you can remove it there at any time.

### Removing the models

Lightspot asks the asset service to remove models only once the profile is in force, so they can’t download again, and only when the sets to remove take space or their size is unknown. When the service says they take nothing, nothing is sent, and the section says _Apple Intelligence’s models aren’t on this Mac_. Each set is asked once, then again after 5 and 15 seconds while macOS is still using it; then Lightspot reads the inventory every 3 seconds, for up to 30 seconds, until the sizes reach 0\. A set your macOS doesn’t know is left alone, and the receipt says so.

The receipt says how much was deleted, and that System Settings’ Storage can keep counting the models for a while, because macOS deletes the files on its own schedule. When macOS was still using a set to the end, it says _macOS is still using these models. Restart your Mac, then open Mac Tweaks again to finish._

### Finishing, and turning it back on

While Lightspot’s profile turns Apple Intelligence off, the feature rows are locked and the section offers:

- **Finish removing the models**, ticked, when the sets the profile blocks still hold models, for example after macOS kept a set it was using. It checks that the profile is still in force first, and sends nothing without it.
- **Turn Apple Intelligence back on**, never ticked for you. It removes Lightspot’s profile through the administrator prompt, with Touch ID or your password, as Free Up Space’s administrator step does. When the profile also holds Settings tweaks, it is replaced instead by one without Apple Intelligence, which you approve in System Settings, and those tweaks stay. macOS downloads the models again when you next turn a feature on.

Each of these rows is applied on its own: ticking one unticks the others. If the profile is still there after the administrator step, Lightspot opens Device Management and waits for you: _In System Settings › General › Device Management, select Lightspot Mac Tweaks, then click Remove._

### Other profiles, RemoveMacAI and macOS updates

- A feature another configuration profile sets reads _Managed_ and stays as that profile has it.
- When RemoveMacAI’s profile is installed, the section is read-only and says that RemoveMacAI manages Apple Intelligence on this Mac. Lightspot’s own profile can still be removed.
- A profile made before a macOS update that added features leaves the new ones on. The features can then be changed again, the new ones say _New since Lightspot’s profile was made. Applying adds it to the profile._, and the summary names them.

### Apple’s asset service runs outside Lightspot

Reading the models’ sizes, and removing them, goes through Apple’s private asset framework. Calling it costs 9 to 11 MB of memory that doesn’t come back, so Lightspot never calls it itself: each read and each removal runs in a short-lived copy of Lightspot started as `Lightspot --asset-service`, which prints one answer and exits, and the memory goes with it. When that copy crashes, runs out of time or answers something Lightspot can’t read, nothing changes. A size the service can’t report is shown as unknown, never as 0.

## Settings

41 macOS settings in six groups, each with its state on your Mac and a tick that changes it. The selected row, and the plan, show each change in full as the command you would type for it, such as `defaults write …`, `launchctl …` or `chflags …`, or as `profile: …` for what goes in Lightspot’s profile. Everything Lightspot changes here can be undone.

![Mac Tweaks’ window on Settings: “25 of 41 on · 1 partly”, the Recommended and Maximum privacy presets with 1 setting to change each, then the Privacy group, whose rows carry a Profile tag with a lock and their state](https://afixer.app/lightspot/shots/mac-tweaks-settings.webp)

### Presets

Two rows at the top tick a set of settings that aren’t on yet; Space on one again unticks them. Neither touches Apple Intelligence, which has its own section.

- **Recommended**: Mac Analytics, personalized ads, Improve Siri and Dictation, Improve Search, Spotlight internet results and Look Up suggestions off; clicks on the wallpaper no longer hiding windows; file extensions and the path bar shown; folders above files; no `.DS_Store` files on network and USB drives; and no recent apps in the Dock.
- **Maximum privacy**: everything in Recommended, plus Game Center and Safari’s search suggestions off.

### States and ticks

Nothing starts ticked. What a tick does depends on the row’s state:

- _Off_: the tick turns the setting on.
- _On_: the tick undoes it, and the box shows an undo arrow (see [Undo](https://afixer.app/lightspot/mac-tweaks#undo)).
- _Partly_: part of it is set already, as when smart quotes are off and smart dashes are not. The tick finishes it. It never undoes a setting that is partly your own.
- _Managed_: another configuration profile sets it, so Lightspot leaves it alone, and the row shows a lock.
- _Not on this macOS_: the row says which macOS it needs. The Finder group but the Library folder, the Dock’s recents, delay, bounce and minimizing, window animations, screenshot shadows and the Typing group work from macOS 13; iPhone Mirroring, the Book Store and the gaps between tiled windows need macOS 15; the rest need macOS 14.

Rows tagged _Profile_, with a lock, go into Lightspot’s configuration profile instead of your own settings: Mac Analytics, personalized ads, Improve Siri and Dictation, Improve Search, Spotlight internet results, Look Up suggestions, Safari search suggestions, Game Center, iPhone Mirroring, Apple Music and the Book Store. While the profile is in, they can’t be switched back by hand, and they apply to every account on your Mac. A profile setting kept as a preference, such as Improve Search, whose value your own settings already have counts as off until it is locked, and its row says _Already off in your own settings, but not locked._

### The 41 settings

What each one does and what it changes. `NSGlobalDomain` is the domain every app reads; the `allow…` keys are restrictions in the profile.

#### Privacy

| Setting                             | What it does                                                                                                                                               | What it changes                                                                              |
| ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| Turn off Mac Analytics              | Stops your Mac sending diagnostic and usage data to Apple and to app developers.                                                                           | `Profile: allowDiagnosticSubmission = false`                                                 |
| Turn off personalized ads           | Stops Apple using what you do in its apps to target ads in the App Store, News and Stocks.                                                                 | `Profile: allowApplePersonalizedAdvertising = false`                                         |
| Turn off Improve Siri and Dictation | Stops Apple storing and reviewing recordings of your Siri and dictation requests.                                                                          | `Profile: com.apple.assistant.support “Siri Data Sharing Opt-In Status” = 2`                 |
| Turn off Improve Search             | Stops Apple keeping your Spotlight, Safari and Look Up searches to improve search.                                                                         | `Profile: com.apple.assistant.support “Search Queries Data Sharing Status” = 2`              |
| Turn off Spotlight internet results | Keeps Spotlight searches on your Mac instead of sending them to Apple for web suggestions.                                                                 | `Profile: allowSpotlightInternetResults = false`                                             |
| Turn off Look Up suggestions        | Stops Look Up sending the words you select to Apple for web results.                                                                                       | `Profile: com.apple.lookup.shared LookupSuggestionsDisabled = true`                          |
| Turn off Safari search suggestions  | Stops Safari sending what you type in the address bar to your search engine and to Apple. The address bar no longer suggests searches as you type.         | `Profile: com.apple.Safari UniversalSearchEnabled = false, SuppressSearchSuggestions = true` |
| Turn off Game Center                | Turns Game Center off, with its sign-in prompts, friend requests and notifications. Games that need Game Center to save progress or play online lose that. | `Profile: allowGameCenter = false`                                                           |

#### Annoyances

| Setting                                     | What it does                                                                                                                                                                                         | What it changes                                                               |
| ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| Stop clicks on the wallpaper hiding windows | Stops every window sliding away when you click the wallpaper by mistake.                                                                                                                             | `com.apple.WindowManager EnableStandardClickToShowDesktop = false`            |
| Hide desktop widgets                        | Hides widgets on the desktop, including in Stage Manager.                                                                                                                                            | `com.apple.WindowManager StandardHideWidgets, StageManagerHideWidgets = true` |
| Stop Music from opening, even by hand       | Switches off the entry macOS uses to start Music, so an AirPods press or the play key can’t open it. Nothing is installed. Music won’t open at all, not even when you click it, until you undo this. | `launchctl disable and bootout of Music’s launch entry`                       |
| Turn off the play, pause and skip keys      | Turns off the service behind the media keys, so the play key can’t open Music. The keys stop working in every app, including VLC and Spotify.                                                        | `launchctl disable and bootout of com.apple.rcd`                              |
| Turn off iPhone Mirroring                   | Turns iPhone Mirroring off, so the app and its prompts go away.                                                                                                                                      | `Profile: allowiPhoneMirroring = false`                                       |

#### Apple apps

| Setting                                | What it does                                                                                                                                           | What it changes                                         |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------- |
| Turn off Apple Music in the Music app  | Turns the Music app back into a plain player for your own library, without the store and subscription prompts. Apple Music subscribers lose streaming. | `Profile: allowMusicService = false`                    |
| Turn off the Book Store                | Removes the store from the Books app and keeps your own books.                                                                                         | `Profile: allowBookstore = false`                       |
| Remove unused Apple apps from the Dock | Removes News, TV, Music, Podcasts, Books, Freeform, Image Playground, Journal, Maps and Stocks from the Dock. The apps stay installed.                 | `com.apple.dock persistent-apps, those icons taken out` |

#### Finder

| Setting                                         | What it does                                                                                                                                   | What it changes                                                                   |
| ----------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| Show file extensions                            | Shows the full name of every file, so a file pretending to be a document is easier to spot.                                                    | `NSGlobalDomain AppleShowAllExtensions = true`                                    |
| Show hidden files                               | Shows the files macOS hides, such as .gitignore and .zshrc.                                                                                    | `com.apple.finder AppleShowAllFiles = true`                                       |
| Show the path bar                               | Shows where the current folder is at the bottom of every Finder window.                                                                        | `com.apple.finder ShowPathbar = true`                                             |
| Show the status bar                             | Shows the number of items and the free space at the bottom of Finder windows.                                                                  | `com.apple.finder ShowStatusBar = true`                                           |
| Keep folders above files                        | Keeps folders above files when sorting by name.                                                                                                | `com.apple.finder _FXSortFoldersFirst = true`                                     |
| Search the current folder                       | Makes Finder search the folder you’re in, not the whole Mac.                                                                                   | `com.apple.finder FXDefaultSearchScope = SCcf`                                    |
| Skip the extension change warning               | Stops Finder asking for confirmation each time you change a file’s extension.                                                                  | `com.apple.finder FXEnableExtensionChangeWarning = false`                         |
| Show the full path in the title bar             | Shows the full folder path at the top of Finder windows.                                                                                       | `com.apple.finder _FXShowPosixPathInTitle = true`                                 |
| Stop .DS\_Store files on network and USB drives | Stops Finder leaving .DS\_Store files in shared folders and on USB drives. Finder stops remembering window layouts in folders on those drives. | `com.apple.desktopservices DSDontWriteNetworkStores, DSDontWriteUSBStores = true` |
| Empty the Trash after 30 days                   | Deletes items that have been in the Trash for 30 days, so it stops filling the disk.                                                           | `com.apple.finder FXRemoveOldTrashItems = true`                                   |
| Save new documents on this Mac                  | Makes Save dialogs start on your Mac instead of iCloud Drive.                                                                                  | `NSGlobalDomain NSDocumentSaveNewDocumentsToCloud = false`                        |
| Expand Save dialogs                             | Opens Save dialogs with the full folder browser instead of the small version.                                                                  | `NSGlobalDomain NSNavPanelExpandedStateForSaveMode = true`                        |
| Show the Library folder                         | Shows the hidden Library folder in your home folder.                                                                                           | `chflags nohidden ~/Library`                                                      |

#### Dock and windows

| Setting                                | What it does                                                                 | What it changes                                             |
| -------------------------------------- | ---------------------------------------------------------------------------- | ----------------------------------------------------------- |
| Hide recent apps in the Dock           | Stops the Dock adding apps you opened recently.                              | `com.apple.dock show-recents = false`                       |
| Remove the Dock auto-hide delay        | Shows a hidden Dock straight away instead of after half a second.            | `com.apple.dock autohide-delay = 0`                         |
| Stop Dock icons bouncing               | Stops Dock icons bouncing while apps open.                                   | `com.apple.dock launchanim = false`                         |
| Minimize windows into their app icon   | Keeps minimized windows inside their app’s icon instead of filling the Dock. | `com.apple.dock minimize-to-application = true`             |
| Turn off window opening animations     | Opens new windows instantly instead of zooming them in.                      | `NSGlobalDomain NSAutomaticWindowAnimationsEnabled = false` |
| Remove gaps between tiled windows      | Removes the margins around windows you tile to the sides of the screen.      | `com.apple.WindowManager EnableTiledWindowMargins = false`  |
| Remove shadows from window screenshots | Takes window screenshots without the large drop shadow around them.          | `com.apple.screencapture disable-shadow = true`             |

#### Typing

| Setting                                     | What it does                                                                                                                             | What it changes                                                                                  |
| ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
| Turn off autocorrect                        | Stops macOS correcting words as you type.                                                                                                | `NSGlobalDomain NSAutomaticSpellingCorrectionEnabled = false`                                    |
| Turn off smart quotes and dashes            | Keeps straight quotes and double hyphens as you typed them, which code and terminals need.                                               | `NSGlobalDomain NSAutomaticQuoteSubstitutionEnabled, NSAutomaticDashSubstitutionEnabled = false` |
| Turn off period on double space             | Stops two spaces turning into a period.                                                                                                  | `NSGlobalDomain NSAutomaticPeriodSubstitutionEnabled = false`                                    |
| Turn off automatic capitals                 | Stops macOS capitalizing the first word of each sentence.                                                                                | `NSGlobalDomain NSAutomaticCapitalizationEnabled = false`                                        |
| Repeat held keys instead of showing accents | Repeats a key while you hold it, instead of opening the accent menu. Type accents with Option shortcuts or the Character Viewer instead. | `NSGlobalDomain ApplePressAndHoldEnabled = false`                                                |

### Apple Music, three ways

- **Turn off Apple Music in the Music app** goes in the profile: Music becomes a plain player for your own library, and Apple Music subscribers lose streaming.
- **Stop Music from opening, even by hand** switches off the launchd entry macOS uses to start Music, whose name holds the inode numbers of `Music.app` and its executable. Music quits if it is open, and then nothing opens it, not a click, an AirPods press or the play key. After a macOS update replaces Music it can open again: the row reads _Partly_, and ticking it stops Music again.
- **Turn off the play, pause and skip keys** switches off `com.apple.rcd`, the service behind the media keys, so they stop working in every app. If macOS doesn’t let Lightspot stop the service at once, it is off from your next login, and the row reads _Partly_ until then. Undoing it switches the service back on.

### Applying

↵ shows the plan, titled _Apply_ and the number of changes: each ticked row with what a tick will do (_Turns on_, _Finishes_, _Undoes_ or _Turns off_, with what that means for the row) and its commands, then which apps restart, and, when the profile changes, that System Settings asks you to approve one profile and that _This profile applies to every account on this Mac: changing it here changes it for them too._ ↵ again applies, in this order:

![The plan for the Recommended preset and six more settings, “Apply 7 changes?”: each row says what will happen, such as “Turns on”, above its defaults write command, then that Finder restarts and how to undo, with the buttons Back and Apply 7 changes](https://afixer.app/lightspot/shots/mac-tweaks-settings-plan.webp)

_The plan for the Recommended preset and six more settings; nothing has changed yet_

1. Your own settings change first. Each is saved to the undo journal before it changes and read back after; preferences are written through macOS’s preferences service, as `defaults write` would.
2. Finder, the Dock and SystemUIServer restart once each, only for the changes that need it. Apps you have open pick up the other changes when you reopen them. Before the Dock restarts, Lightspot waits until a Dock that has just started has run for 8 seconds and shows the same icons twice in a row, because a Dock stopped while it is still starting writes the icons it started with back over a change. After the restart it checks the icons in the new Dock, and if the restart lost the change, it makes it once more. After a second loss the receipt says so, and the journal goes back to what the Dock shows.
3. When a Profile row changed, the profile is rebuilt with it, keeping its Apple Intelligence part exactly as it is in force, and you approve it in System Settings, as in [Apple Intelligence](https://afixer.app/lightspot/mac-tweaks#ai-approve). When nothing would be left in it, Lightspot removes it through the administrator prompt instead.
4. Everything is read again, and the receipt says what changed, one line per kind: _Applied: …_, _Finished: …_, _Undone: …_, what restarted and what the profile now locks.

### Undo

Before Lightspot first changes a setting, it saves the value it found to `~/Library/Application Support/Lightspot/tweaks-journal.json`, and it makes the change only once that save has worked. A later change keeps the first value saved, so undo always goes back to how the setting was before Lightspot. Background Items saves the background items it turns off or deletes to the same file (see [Turning them back on](https://afixer.app/lightspot/mac-tweaks#background-undo)).

- **One row**: tick an _On_ row. Lightspot writes back the value it saved, or, for a setting it saved nothing for, macOS’s default, and the plan says which. A service that was already off before Lightspot stays off. A Profile row comes out of the profile, and _Remove unused Apple apps from the Dock_ puts the icons back where they were and checks them in the restarted Dock, as it does when it removes them.
- **Undo everything Lightspot changed**, the last row, puts back every change in the journal (settings, the Library folder’s flag, Dock icons and services, including any from an older version that this one no longer lists), turns the [background items](https://afixer.app/lightspot/mac-tweaks#background-undo) Lightspot turned off back on, moves the ones it deleted back from the Trash, restarts what they need once, and removes Lightspot’s profile; if the profile turned Apple Intelligence off, it comes back on. Removing the profile and turning daemons back on share one administrator prompt, and with a daemon in the journal the plan also says _Background items for all users come back on for every account on this Mac._ Files Free Up Space moved to the Trash and Clear Dock Icons’ backup are not part of it.

Turning a service back on, here or as a background item, runs `launchctl enable`, and launchd then keeps an “enabled” record for it, which `launchctl print-disabled` lists. No launchctl command removes that record and only an administrator can, so Lightspot leaves it, and the plan and the receipt say so.

An entry leaves the journal once its undo has been checked, and the file goes when it is empty. A journal Lightspot can’t read is never overwritten: the next change moves it aside as `tweaks-journal-unreadable-<date>-<id>.json`, and if it can’t be moved, the section changes nothing until the file is moved or fixed. The [uninstaller](https://afixer.app/lightspot/install#uninstall) keeps the journal, so a reinstalled Lightspot can still undo.

## Background Items

Apps install launch agents and daemons to run their updaters and helpers whether or not the app is open. Background Items lists the ones other apps installed and turns each off, back on, or deletes it: stops it, switches it off and moves its file to the Trash. What it turns off or deletes is saved to the [undo journal](https://afixer.app/lightspot/mac-tweaks#undo) first, so _Undo everything Lightspot changed_ turns it back on, and puts a deleted file back from the Trash, too.

![Mac Tweaks’ window on Background Items: three items from other apps; GoogleUpdater selected and marked for deletion, tagged Delete, Updater and Not loaded, with a warning that its app is still installed, its plist, the launchctl disable and the move to the Trash; JOKey on; OrbStack tagged For all users and May ask for password; the button Delete 1 item…](https://afixer.app/lightspot/shots/mac-tweaks-background-items.webp)

_Background Items on my Mac_

### What it lists

Every `.plist` in three folders, in this order:

- `~/Library/LaunchAgents`: your own agents.
- `/Library/LaunchAgents`: agents every account loads.
- `/Library/LaunchDaemons`: daemons, which run for the whole Mac.

It leaves out macOS’s own (labels starting `com.apple.`), a plist without a `Label`, such as the empty stubs Google’s Keystone leaves behind, and dot files. Lightspot itself has no plist there. Each plist is read without waiting on it, and only as a regular file of at most 1 MB, so a pipe or a huge file named like a plist can’t stall the scan. A plist that is a symbolic link, as old Homebrew installs and GNU stow make, is followed one folder at a time, never into a folder macOS guards, such as `~/Documents`, where even looking makes macOS ask for permission, nor into another disk under `/Volumes` or `~/Library/CloudStorage`. When two plists in the agent folders have the same label, the first makes the row and names the other, since launchd runs only one of them.

### The rows

Each row is titled with the app the item belongs to: the `.app` its program sits in, else the name of what it runs; when that is only its label, the app its plist names in `AssociatedBundleIdentifiers`, so Docker’s helper reads _Docker_, or else the third part of the label. Below the title are the label and what it runs: the program, or an interpreter such as `sh` or `python3` with its script, never the other arguments, which can hold tokens. The state is on the right:

- _On_: launchd has it loaded.
- _Off_: launchd’s switch for it is off, or its own plist says `Disabled` and launchd has no switch for it (_Its own file keeps it off._). One that is off but still running says so: a daemon runs until you restart, an agent until you log out.
- _Not loaded_: switched on, but not loaded. Login Items & Extensions in System Settings may have switched it off; launchctl can’t see that switch, so the row says “may”.
- _Unknown_: launchd didn’t say.

The state comes from `launchctl print-disabled` and `launchctl print`, without root. Of `print` only the exit status is kept, because its output lists the job’s environment. Tags beside the state:

- _Updater_: “update” is in its label or in its program’s name. A row that is neither an updater nor a leftover warns _Not an updater. Turning it off can stop <app> working._
- _Leftover_: what it runs is gone (see [Leftovers](https://afixer.app/lightspot/mac-tweaks#leftovers)).
- _For all users_: a daemon, whose change is for every account on this Mac, or an item in `/Library/LaunchAgents` to be deleted, whose file goes for every account.
- _May ask for password_: an administrator may have to make the change (see [Applying](https://afixer.app/lightspot/mac-tweaks#background-apply)).
- _Delete_, in red, with a trash box instead of the tick: the row is marked for deletion (see [Deleting an item](https://afixer.app/lightspot/mac-tweaks#background-delete)).

When the apps a plist names aren’t installed, its row says _The app it came with (…) isn’t installed._ That alone doesn’t make it a leftover: on my Mac, Zoom is gone but its helper stayed, so Zoom’s daemon isn’t one.

A row that can’t be ticked says why: a label launchctl could misread (one with a slash, a quote or any character outside printable ASCII, since an accented letter would reach launchctl spelled differently from the label launchd has), a link on the way to the item’s folder that leads somewhere else, launchd not saying whether the item is switched off, or an undo journal Lightspot can neither read nor move aside.

The last row, _Login Items in System Settings_, opens Login Items & Extensions, where macOS keeps its own switches for background items.

### What a tick does

A tick is the row’s change, and the row says what will happen:

- An _Off_ row is turned back on: `launchctl enable`, then `launchctl bootstrap` with its plist while it isn’t loaded. launchd then keeps an “enabled” record for it (see [Undo](https://afixer.app/lightspot/mac-tweaks#undo)).
- A leftover is deleted (see [Deleting an item](https://afixer.app/lightspot/mac-tweaks#background-delete)). Leftovers are the only rows ticked from the start, and for them a tick and ⌫ are the same change.
- Any other row is turned off: `launchctl disable`, then `launchctl bootout` while it is loaded. It stops now and stays off after a restart; one that wasn’t loaded stays off even if Login Items switches it on again.

In `/Library/LaunchAgents`, turning an item off or back on is for your account only, and the row says so; deleting one from there takes its file away from every account. Your own agents change as you. Daemons, and a file only an administrator can move, take the administrator prompt, and a daemon’s change is for every account on this Mac.

### Deleting an item

⌫ (or ⌦) marks the selected row for deletion, and again unmarks it. The mark replaces the row’s tick, and Space ticks the row’s own change instead, so a row is either turned off or on, or deleted. A marked row shows a trash box and the _Delete_ tag, and the row and the plan list the commands a delete equals:

- `launchctl bootout` while it runs. A refused bootout changes nothing, and the plist stays.
- `launchctl disable`, so a copy its app writes again doesn’t load.
- `mv … ~/.Trash/`: the plist goes to your Trash. Your own agents’ plists move as you; a daemon’s, a plist another account owns and one in `/Library/LaunchAgents` move in the administrator script, with the same checks as Free Up Space’s moves (see [Password](https://afixer.app/lightspot/mac-tweaks#password)).

Deleting a helper of an app that is still installed can stop the app working, and the app may put it back the next time it runs; the row and the plan say so, naming the app. A row whose app isn’t installed says that instead. Deleting a daemon or an item in `/Library/LaunchAgents` is for all users and may ask for your password. A plist that is a symbolic link, or that shares its label with another plist, can’t be deleted.

### Leftovers

An item is a leftover only when macOS says what it runs doesn’t exist. For an interpreter such as `sh`, `python3` or `node`, the script it runs is judged instead of the interpreter. Some are never judged gone: inline code (`-c`, `-e`), a program in a folder macOS guards, which Lightspot doesn’t look into, a path macOS won’t let Lightspot look at, and a program on another disk under `/Volumes`, which may only be unplugged. A leftover whose plist is a symbolic link, or whose label has another plist, is never moved: its tick turns it off instead. One that is still running after Lightspot stops it stays where it is. Since 1.4.1 a leftover is deleted like any other item, so it is switched off as well as moved, and Undo everything can put it back.

### Applying

↵ shows the plan, titled by what it does, such as _Turn off 2 items_, _Delete 1 item_ or, for a mix, _Apply 3 changes_: each ticked row with its commands, then that turned-off items stay off after a restart until you turn them back on, that deleted items are switched off too and that Undo everything puts them back while they are still in the Trash, that items for all users change for every account on this Mac, and whether macOS may ask for Touch ID or your password. ↵ again applies, in this order:

1. The plists and launchd are read again. An item already as asked, changed since the scan or gone is left alone, and the receipt says so.
2. Each item to turn off or delete is saved to the undo journal, with whether launchd had it switched off and whether it was loaded, before anything runs; a delete also saves where its plist was. An item whose entry can’t be saved stays as it is. When the item was turned off earlier, its entry keeps that earlier state, so undo goes back to how it was before Lightspot.
3. Your own agents change as you, with `launchctl` run directly, never through a shell. An item to delete is stopped, kept if it is still running, switched off, then moved to the Trash, and the journal entry gets the name it has there.
4. Every daemon’s change, and every move only an administrator can make, runs in one administrator script, as in Free Up Space (see [Password](https://afixer.app/lightspot/mac-tweaks#password)): one prompt at most. The Trash names of its moves are saved to the journal before the prompt, and each move checks the folder and the Trash again as it runs.
5. launchd is read again, and only what it confirms counts: off means launchd’s switch is off, on means it isn’t, and deleted means the plist is gone from its folder, its copy is in the Trash, the switch is off and nothing runs. A delete whose plist didn’t move goes back to its earlier journal entry, or, when the item did get switched off, the receipt says it is off but its file stays. One that is off but still running is reported, a daemon until you restart and an agent until you log out, and so is one that is on again but didn’t load. When launchd can’t be read, the item counts neither way and its journal entry stays, so Undo everything can still turn it back on.

The receipt has one line per kind: _Turned off: …_, _Turned back on: …_, _Deleted, moved to the Trash: …_, which names where each plist went in the Trash, _Already off: …_, _Already on: …_ and _Already gone: …_, with each problem on a line of its own and, after a turn-off or a delete, how to undo it.

### Turning them back on

Tick an _Off_ row to turn it back on, and its journal entry goes. [Undo everything Lightspot changed](https://afixer.app/lightspot/mac-tweaks#undo), in Settings, turns back on everything Lightspot turned off here and starts again only what was running before. Daemons go back on in the administrator prompt that removes the profile, or in one of their own when there is none to remove; agents as you. As root, Lightspot only names a label and a plist the scan finds in `/Library/LaunchDaemons`: the journal is a file your account can write, so nothing it says alone makes root act.

It puts back what Lightspot deleted here too. Each plist moves from the Trash back to where it was, then is switched on and started only as it was before: your own as you, root’s in the same administrator prompt, and only a regular file root owns, with one link and the label the journal names, going back to a name nothing holds in `/Library/LaunchAgents` or `/Library/LaunchDaemons`, so editing the journal can’t install a daemon. It never replaces a file that is at the old place now: when the app wrote the plist again, Lightspot only switches it back on and names the copy left in the Trash. A copy no longer in the Trash is said and its entry dropped, and launchd keeps its switch off. With a root plist’s delete in the journal, the plan of Undo everything says it asks for the password.

An entry whose plist is gone runs nothing and is dropped, and launchd keeps its switch off; the plan and the receipt say so. One that is still off afterwards stays in the journal, and the receipt gives launchctl’s reason, as in _<app>: still off (…)_.

## Receipts and the log

Every apply ends with a receipt in its section: a green check when it did what you asked, and a warning sign when something stayed or is still waiting. ↵ on a receipt scans the section again; reopening Mac Tweaks within five minutes shows the receipt, and after that it scans afresh. Apple Intelligence and Settings share the profile, so after an apply in one, the other scans again when you open it. Settings and Background Items share the undo journal: after an apply in Background Items, Settings scans again, and after Undo everything, Background Items does. A plan from a scan that another section’s apply has made stale is never applied: the section scans again instead.

Every apply is also appended to `~/Library/Application Support/Lightspot/mac-tweaks.log`, marked _Mac Tweaks run (Lightspot)_ with the section’s name: when it started and ended, what changed, and what stayed and why. Lightspot writes it only when you apply something. Past 1 MB the log keeps its newest 256 KB, like cdm’s `clean.log`.

## Keys

| Key    | In Mac Tweaks                                                                                                                                                                                                                                                                                                      |
| ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| ↑ ↓    | Select a row; the selected one shows its first items with their sizes, the models it needs, or its commands                                                                                                                                                                                                        |
| Space  | Tick or untick the selected row; nothing on a link or a locked row. On a Settings preset, tick its rows that aren’t on yet, and again to untick them. In Background Items, tick the row’s change: off, back on, or, for a leftover, delete; on a row marked for deletion, Space ticks the row’s own change instead |
| ⌫      | In Background Items, mark the selected item for deletion, and again unmark it. Forward Delete (⌦) does the same                                                                                                                                                                                                    |
| ⇥ / ⇧⇥ | Next or previous section                                                                                                                                                                                                                                                                                           |
| ↵      | Show the plan, or open a link row, such as Login Items in System Settings; ↵ again applies; on a receipt, scan again                                                                                                                                                                                               |
| ⌥↵     | In Free Up Space, show the selected row’s first item in Finder, and in Background Items its plist; on Free Up Space’s receipt, an app macOS kept                                                                                                                                                                   |
| Esc    | Back from the plan; while a section waits for System Settings, stop waiting; otherwise close the window                                                                                                                                                                                                            |
| ⌘W     | Close the window                                                                                                                                                                                                                                                                                                   |

_Finish removing the models_, _Turn Apple Intelligence back on_ and _Undo everything Lightspot changed_ are applied on their own: ticking one unticks the rest. Stopping a wait leaves the profile in System Settings; the window’s close button closes it and leaves the wait going. ⌥↵ and ⌘↵ on the Mac Tweaks row itself open it, as ↵ does.

## Safety

In Free Up Space, every path goes through Mac Tweaks’ own check when the list is built and again right before it moves, because the plan may have been open for a while:

- It must sit directly in one of its row’s folders, which are fixed in code, and never be the folder itself. Mac Tweaks never reaches inside an app: an app goes to the Trash whole, or stays.
- The folder must be where it should be also with symbolic links resolved, so no link on the way leads out of it, and the item itself may not be a symbolic link. A path with a `.` or `..` step is refused.
- An app or an installer must be Apple’s, by the identifier in its own Info.plist.
- Nothing under `/System` is touched, and nothing in `~/Desktop`, `~/Documents`, `~/Downloads`, `~/Pictures`, `~/Movies`, `~/Music`, iCloud Drive, `~/Library/Containers`, `~/Library/Group Containers`, `~/Library/Mail`, `~/Library/Messages` or `~/Library/Application Support/MobileSync`, where iPhone backups are, whatever a row says.

In Apple Intelligence and Settings:

- The profile takes effect only once you install it in System Settings yourself, and removing it there undoes everything it changed.
- A setting or feature another configuration profile sets is left alone.
- Settings saves the previous value before every change and changes nothing when it can’t, and Undo everything puts back only what Lightspot changed.
- Lightspot’s own process never calls Apple’s asset framework.

In Background Items:

- macOS’s own items are never listed, and nothing outside the three folders, which are fixed in code, is changed. Each folder must be where it should be also with symbolic links resolved, or its rows can’t be ticked.
- A plist is read only as a regular file of at most 1 MB, and a symbolic link is never followed into a folder macOS guards, another disk or `~/Library/CloudStorage`.
- An item is a leftover only when macOS says what it runs doesn’t exist, and its file is checked again right before it moves.
- `launchctl` runs directly, never through a shell, with no input and 10 seconds per call, and only with a label it can’t misread.
- A turn-off or a delete is saved to the undo journal before `launchctl` runs, and with a journal that can be neither read nor moved aside, nothing changes.
- A delete moves the plist to the Trash, never deletes it for good, and counts only once the copy is there.
- As root, Lightspot acts only on a label and a plist the scan found, and puts back only a file root owns into the two shared folders.

In every section, nothing changes without the plan and a second ↵, and Mac Tweaks makes no network request. It does nothing until you open it: no scan, file read or process at launch. While it is closed nothing runs, except an apply you started, which may wait up to 10 minutes for you to approve its profile, checking once a second. Once a scan is older than five minutes, closing Mac Tweaks drops the rows it found; Free Up Space’s total stays for the search row, and the Apple Intelligence inventory for the link to the models. The [privacy page](https://afixer.app/lightspot/privacy#reads) lists everything it reads.

## Where it comes from

Mac Tweaks ports logic from [RemoveMacAI](https://github.com/omlahore/RemoveMacAI) by omlahore, under the MIT License: Free Up Space’s storage logic (what it offers, how it sizes it, which caches are macOS’s own, and how it moves what only an administrator can move in one batch); Apple Intelligence’s feature and model catalog, how it reads each feature’s state, the configuration profile with its download block, and the asset-service calls; Settings’ tweak catalog, how it reads and writes preferences, its undo journal, its plan and Music’s launch entry; and, for Background Items, which launch agents and daemons it lists, how it tells an updater and a leftover, and how it turns them off and on. RemoveMacAI’s code is not included as such: it was read and rewritten for Lightspot.

RemoveMacAI’s Apple Intelligence work builds on [pared](https://github.com/4evy/pared) by 4evy, also under the MIT License. pared mapped the asset framework’s reset, the model sets and several of the settings keys for macOS 27, and Lightspot’s asset-service bridge, model catalog and download block follow it. The checks, the administrator script, the helper process, the undo journal’s format and the wording are Lightspot’s, and so, in Background Items, are reading whether launchd has an item loaded, judging every change by reading launchd again and asking LaunchServices for the app a plist names. Both license notices are in [THIRD-PARTY-NOTICES.md](https://github.com/openhoangnc/mac-lightspot/blob/main/THIRD-PARTY-NOTICES.md).
