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
  1. Overview
  2. Install, update and uninstall
  3. Searching and the app grid
  4. Calculator and conversions
  5. Developer tools
  6. Terminal history and projects
  7. Custom commands, web search and snippets
  8. Browser, clipboard and system
  9. Clean Dev Mac
  10. Mac Tweaks
  11. Turning off Apple Spotlight
  12. Menu bar and settings
  13. Privacy
  14. How Lightspot works

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

Menu items

ItemWhat 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 HistoryDeletes 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.
ShortcutThe global shortcut. Marked ⚠︎ when macOS also uses it.
Search EngineThe engine for the Web Search row.
Browser HistoryDisabled, Last 3 Days or Last 7 Days (default) of browser history.
Terminal AppThe terminal used to run commands and open folders.
System SpotlightTurns Apple Spotlight off or on.
Launch at LoginStarts Lightspot when you log in, through macOS’s login items. Turned on at first launch.
Hide / Show Menu Bar IconHides 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 HistoryEmpties 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 UpdatesThe daily check, on by default. Untick it and Lightspot only checks when you ask.
About LightspotVersion (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.

The Shortcut menu with four choices, ⌃Space marked “also switches input source”

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.

The Search Engine menu with six engines, Google checked

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 fileNot 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 appsSnippets, 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.

KeyHolds
lightspot_hotkey_optionShortcut: cmd_space, cmd_shift_space, option_space or control_space
lightspot_search_engineWeb search engine
lightspot_browser_history_daysBrowser history: 0, 3 or 7 days
lightspot_terminal_appTerminal app
lightspot_auto_start_enabledLaunch at Login
lightspot_hide_menubar_iconHide Menu Bar Icon
lightspot_first_run_completedWhether the first-run prompt was shown
lightspot_spotlight_stateLast known Apple Spotlight state, for the menu
lightspot_custom_commandsCustom commands (JSON)
lightspot_pinned_commandsPinned commands
lightspot_snippetsText snippets (JSON)
lightspot_search_historySearch history and ranking statistics (JSON)
lightspot_recent_app_bundle_idsUp to 30 apps you opened through Lightspot
lightspot_auto_update_enabledAutomatically Check for Updates (on by default)
lightspot_last_update_checkWhen the last successful update check happened
lightspot_skipped_versionA version you chose to skip
NSWindow Frame MacTweaksWhere you last put the Mac Tweaks window, and its size
NSWindow Frame CleanDevMacWhere you last put the Clean Dev Mac window, and its size