Menu bar and settings
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 guide
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 manager. |
| Pinned Commands… (⌘⇧P) | Opens the pinned commands 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. |
| Clear Search History | Deletes the history and everything Lightspot learned from it. |
| Clean Dev Mac… | Opens 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 in its own window, as ↵ on its row does, or brings the open window to the front. |
| Shortcut | The global shortcut. Marked ⚠︎ when macOS also uses it. |
| Search Engine | The engine for the Web Search row. |
| Browser History | Disabled, Last 3 Days or Last 7 Days (default) of browser history. |
| Terminal App | The terminal used to run commands and open folders. |
| System Spotlight | Turns Apple Spotlight off or on. |
| 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 your settings. |
| Clear Clipboard History | Empties the in-memory clipboard history. |
| Clear Search (Esc), Close Lightspot | ⋯ menu only. |
| Update to x.y.z… | Appears when a newer version was found. Installs it; see Updates. |
| 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.

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 always go to their own sites.

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). 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, 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 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 |

