# Menu bar and settings

> Every item in Lightspot’s menu bar menu: Clean Dev Mac, Mac Tweaks, shortcut, search engine, browser history, terminal app, Apple Spotlight, launch at login, update checks, exporting and importing settings, and where Lightspot keeps its settings.

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

Lightspot has no settings window. Everything is in the menu of the magnifying-glass icon in the menu bar, and in the same menu behind the ⋯ button of the search field.

![Lightspot’s menu bar menu](https://afixer.app/lightspot/shots/menu.webp)

_The menu bar menu_

![The menu behind the ⋯ button in the search field](https://afixer.app/lightspot/shots/menu-modal.webp)

_The ⋯ menu in the search field_

These are 1.3.1’s menus. Since 1.4.0, **Mac Tweaks…** sits right under **Clean Dev Mac…**.

## Menu items

| Item                                  | What it does                                                                                                                                                |
| ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Show Lightspot (⌘Space)               | Opens the search bar. Shows your current shortcut. Menu bar only.                                                                                           |
| Next / Previous Category (Tab / ⇧Tab) | Switches the app grid category. ⋯ menu only.                                                                                                                |
| Custom Commands… (⌘⇧C)                | Opens the [custom commands](https://afixer.app/lightspot/custom-commands) manager.                                                                          |
| Pinned Commands… (⌘⇧P)                | Opens the [pinned commands](https://afixer.app/lightspot/terminal#pins) manager.                                                                            |
| Pin / Unpin Selected Command (⌘P)     | Pins the selected history command. ⋯ menu only; greyed out when nothing pinnable is selected.                                                               |
| Search History… (⌘⇧H)                 | Opens the [search history](https://afixer.app/lightspot/search#history).                                                                                    |
| Clear Search History                  | Deletes the history and everything Lightspot learned from it.                                                                                               |
| Clean Dev Mac…                        | Opens [Clean Dev Mac](https://afixer.app/lightspot/clean-dev-mac) in its own window, as ↵ on its row does, or brings the open window to the front.          |
| Mac Tweaks…                           | Opens [Mac Tweaks](https://afixer.app/lightspot/mac-tweaks) in its own window, as ↵ on its row does, or brings the open window to the front.                |
| Shortcut                              | [The global shortcut](https://afixer.app/lightspot/settings#shortcut). Marked ⚠︎ when macOS also uses it.                                                   |
| Search Engine                         | The engine for the [Web Search](https://afixer.app/lightspot/custom-commands#web) row.                                                                      |
| Browser History                       | Disabled, Last 3 Days or Last 7 Days (default) of [browser history](https://afixer.app/lightspot/browser-and-system#browser).                               |
| Terminal App                          | The [terminal](https://afixer.app/lightspot/terminal#terminals) used to run commands and open folders.                                                      |
| System Spotlight                      | [Turns Apple Spotlight off or on](https://afixer.app/lightspot/spotlight).                                                                                  |
| Launch at Login                       | Starts Lightspot when you log in, through macOS’s login items. Turned on at first launch.                                                                   |
| Hide / Show Menu Bar Icon             | Hides the magnifying glass. Use the ⋯ menu in the search field to show it again.                                                                            |
| Export Settings… / Import Settings…   | [Back up or restore](https://afixer.app/lightspot/settings#backup) your settings.                                                                           |
| Clear Clipboard History               | Empties the in-memory [clipboard history](https://afixer.app/lightspot/browser-and-system#clipboard).                                                       |
| Clear Search (Esc), Close Lightspot   | ⋯ menu only.                                                                                                                                                |
| Update to x.y.z…                      | Appears when a newer version was found. Installs it; see [Updates](https://afixer.app/lightspot/install#update).                                            |
| Check for Updates…                    | Asks GitHub for the latest release now, and tells you if you are up to date.                                                                                |
| Automatically Check for Updates       | The daily check, on by default. Untick it and Lightspot only checks when you ask.                                                                           |
| About Lightspot                       | Version (and a newer one if available), current shortcut and what else in macOS uses it, and the state of Apple Spotlight’s shortcut, process and indexing. |
| Quit Lightspot (⌘Q)                   | Quits. Launch it again from Applications.                                                                                                                   |

## Shortcut

Choose ⌘Space (default), ⌘⇧Space, ⌥Space or ⌃Space. The new shortcut works at once, in every app. Lightspot registers it as a global hot key, which needs no Accessibility permission. Picking ⌘Space while Apple Spotlight still uses it offers to free it, and if another app holds the shortcut when Lightspot starts, Lightspot tells you; see [When ⌘Space is taken](https://afixer.app/lightspot/spotlight#shortcut).

![The Shortcut menu with four choices, ⌃Space marked “also switches input source”](https://afixer.app/lightspot/shots/menu-shortcut.webp)

A combination that macOS itself uses still works for Lightspot, but macOS acts on the same keystroke too. ⌃Space is macOS’s shortcut for _Select the previous input source_, so with it Lightspot opens and your keyboard input source switches. The Shortcut menu marks such a choice, names the macOS shortcut that uses yours and offers **Open Keyboard Shortcuts Settings…**, where you can turn that shortcut off or change it. Lightspot reads your own bindings, so it notices if you moved input-source switching elsewhere, and it never changes them itself.

## Search engine

Google, DuckDuckGo, Kagi, Bing, Brave Search or Ecosia. This only changes the last _Web Search_ row; the [search prefixes](https://afixer.app/lightspot/custom-commands#search-prefixes) always go to their own sites.

![The Search Engine menu with six engines, Google checked](https://afixer.app/lightspot/shots/menu-engine.webp)

## Export and import

**Export Settings…** saves a JSON file, named `Lightspot-Settings-2026-10-16.json` by default, and reports how many custom and pinned commands it contains. **Import Settings…** reads such a file, shows a summary and asks before it **replaces** your current settings; nothing is merged.

| In the file                                                                                                                                                                                         | Not in the file                                          |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
| Shortcut, Launch at Login, menu bar icon, browser history days, automatic update checks, custom commands with their icons, pinned commands, search history with its ranking statistics, recent apps | Snippets, terminal app, search engine, clipboard history |

Before writing the file, Lightspot replaces your home folder (`/Users/you`) with `~` in custom commands, pinned commands and search history, so the same file works on a Mac with a different user name; `~` is expanded again when a path is opened. Files from a newer Lightspot with a higher `version` are refused, and imported history is cleaned the same way as Lightspot’s own (see [what Lightspot stores](https://afixer.app/lightspot/privacy#stored)). A shortened example:

```
{
  "app" : "com.lightspot.app",
  "customCommands" : [
    {
      "iconSource" : "runner",
      "id" : "5AD4742B-E829-415A-A5B8-603FC8E56D4F",
      "keywords" : [ "github", "git", "repo", "code" ],
      "name" : "Open GitHub",
      "prefix" : "gh",
      "target" : "https://github.com/search?q={query}&type=repositories",
      "type" : "url"
    }
  ],
  "exportedAt" : "2026-10-16T08:00:00Z",
  "pinnedCommands" : [ "docker compose up -d", "npm run dev" ],
  "preferences" : {
    "autoStartEnabled" : true,
    "autoUpdateEnabled" : true,
    "browserHistoryDays" : 7,
    "hideMenuBarIcon" : false,
    "hotkeyOption" : "cmd_space"
  },
  "recentAppBundleIDs" : [ "com.apple.Terminal", "com.microsoft.VSCode" ],
  "searchHistory" : { "entries" : [ … ], "itemStats" : { … } },
  "version" : 1
}
```

The export contains your search history: what you searched for and which apps, pages and projects you opened. Look through the file before sharing it.

## Where settings are stored

Everything is in Lightspot’s preferences (`defaults read com.lightspot.app`), under these keys, plus a lock file in `~/Library/Application Support/Lightspot` that keeps a second copy from starting. Once you apply something in [Mac Tweaks](https://afixer.app/lightspot/mac-tweaks), the same folder also holds its log, `mac-tweaks.log`; the undo journal of its Settings and Background Items sections, `tweaks-journal.json`; and, after Clear Dock Icons, `dock-backup.plist`. The [uninstaller](https://afixer.app/lightspot/install#uninstall) deletes all of it but the journal and the Dock backup, which it keeps so that a reinstalled Lightspot can still undo what Mac Tweaks changed.

| Key                               | Holds                                                                    |
| --------------------------------- | ------------------------------------------------------------------------ |
| `lightspot_hotkey_option`         | Shortcut: cmd\_space, cmd\_shift\_space, option\_space or control\_space |
| `lightspot_search_engine`         | Web search engine                                                        |
| `lightspot_browser_history_days`  | Browser history: 0, 3 or 7 days                                          |
| `lightspot_terminal_app`          | Terminal app                                                             |
| `lightspot_auto_start_enabled`    | Launch at Login                                                          |
| `lightspot_hide_menubar_icon`     | Hide Menu Bar Icon                                                       |
| `lightspot_first_run_completed`   | Whether the first-run prompt was shown                                   |
| `lightspot_spotlight_state`       | Last known Apple Spotlight state, for the menu                           |
| `lightspot_custom_commands`       | Custom commands (JSON)                                                   |
| `lightspot_pinned_commands`       | Pinned commands                                                          |
| `lightspot_snippets`              | Text snippets (JSON)                                                     |
| `lightspot_search_history`        | Search history and ranking statistics (JSON)                             |
| `lightspot_recent_app_bundle_ids` | Up to 30 apps you opened through Lightspot                               |
| `lightspot_auto_update_enabled`   | Automatically Check for Updates (on by default)                          |
| `lightspot_last_update_check`     | When the last successful update check happened                           |
| `lightspot_skipped_version`       | A version you chose to skip                                              |
| `NSWindow Frame MacTweaks`        | Where you last put the Mac Tweaks window, and its size                   |
| `NSWindow Frame CleanDevMac`      | Where you last put the Clean Dev Mac window, and its size                |
