User Manual

Find anything on your Mac in seconds

Version 0.2.2 March 2026 macOS

Getting Started

After installing, LovelyTabs lives in your menu bar (top-right of your screen). You'll see a small icon there.

The launcher appears as a floating panel below the menu bar icon. Start typing to search, or browse your open tabs immediately.

Tip: You never need to find the menu bar icon. Ctrl + Space works from any app, anywhere on your Mac.

The Five Modes

LovelyTabs has five search modes, shown as tabs at the top of the launcher. Click a tab to switch, press Tab / Shift+Tab to cycle, or use arrow keys when the search field is empty.

Tabs

Your currently open Chrome tabs. This is the default mode.

History

Your recent browser history (last 500 pages visited).

Bookmarks

Your saved Chrome bookmarks.

Clipboard

Your clipboard history, stored securely on your Mac.

Windows

All open application windows on your Mac.

Searching

Just start typing. LovelyTabs searches instantly as you type with fast keyword matching. After a short pause, AI search kicks in to find results that keyword matching would miss.

Prefix Shortcuts

Switch modes instantly by typing a single letter followed by a space. The prefix is stripped from your search automatically.

Type thisSwitches toExample
t + spaceTabst github
h + spaceHistoryh design site last week
b + spaceBookmarksb stackoverflow
c + spaceClipboardc that invoice
w + spaceWindowsw slack

Keyboard Shortcuts

KeyAction
Ctrl + SpaceOpen/close LovelyTabs (works from any app)
/ Move selection up/down
/ Switch mode (when search field is empty)
EnterOpen the selected result
TabNext mode
Shift + TabPrevious mode
Cmd + 19Jump to numbered result (Tabs mode)
MToggle voice input
EscClose the launcher

Voice Control

LovelyTabs has built-in voice search using your Mac's native speech recognition. Audio is processed locally and never sent to the cloud.

Activating Voice

In Push-to-talk mode (default), press M to start and M again to stop. In Auto-listen mode, the microphone activates automatically when the launcher opens. You can change this in Settings.

Voice Commands

Say thisWhat happens
Any wordsSearches for what you said
"one" through "nine"Selects that numbered result
"open three" / "yes two"Selects and activates that result
"open" / "go" / "select" / "that one"Activates the currently highlighted result
"close" / "cancel" / "dismiss"Closes the launcher
"clear" / "retry" / "again"Clears the search and keeps listening
"tabs" / "history" / "bookmarks" etc.Switches to that mode

Voice Learning

LovelyTabs learns from your voice over time. If speech recognition mishears a word (e.g. "name sheep" instead of "Namecheap"), the app will learn the correction when you select the right result — whether you pick it by voice, keyboard, or mouse.

If the correct result doesn't appear at all, you can type the right word in the search field instead. When you then select a result, the app learns the mapping between what the mic heard and what you actually meant. No setup needed.

Settings

Click the gear icon in the bottom-right corner of the launcher. You can also right-click the menu bar icon and choose Settings.

Settings apply instantly — no save button needed. Click outside the settings panel to close it.

Appearance

Choose your theme:

The theme changes immediately when you select it.

Show Tab List on Open

Voice Mode

Clipboard

Private Domains

Hide specific websites from your tab list. Tabs from these domains won't appear unless you search for their exact domain name. Useful for keeping personal browsing private.

Type a domain (e.g. reddit.com), click Add, and it will be hidden from the default tab list. Remove domains anytime with the X button.

Tips & Tricks

Troubleshooting

Tabs not showing up?

Make sure Google Chrome is running. LovelyTabs reads tabs directly from Chrome.

Windows mode shows nothing?

Go to System Settings → Privacy & Security → Accessibility and make sure LovelyTabs is enabled.

Voice not working?

Check that microphone permission is granted. Go to System Settings → Privacy & Security → Microphone.

AI search not working?

AI search requires an API key. If the AI badge doesn't show any activity when you type, check that your .env file contains a valid ANTHROPIC_API_KEY.

Can't activate tabs after reinstalling?

After installing a new version, macOS may reset permissions. Toggle LovelyTabs off and on in System Settings → Privacy & Security → Accessibility and Automation.