Skip to content
Québec Studio

For Omarchy

qSpot

A Spotlight-style search for Omarchy: apps, files, calculations and the web in one field.

Version
v1.0.2
License
MIT
Languages
English, French

qSpot on Tokyo Night

Coming from macOS? qSpot is Spotlight: one key, type a few letters, Enter. From Windows: the search in the Start menu, or PowerToys Run; from KDE: KRunner. It pairs with qDock, the Dock, qExposé, Exposé and Mission Control, and qCenter, the Notification Center.

  • Apps, ranked as in Omarchy's menu. An app that is already open comes forward instead of starting again; Shift+Enter opens a new window.
  • Files and folders in your home folder, by name, as you type. qSpot keeps its own index, refreshed every half hour and when it opens, so a file saved a few minutes ago is there. Dependencies, caches and hidden folders stay out. With the field empty, the files you opened lately.
  • Open windows, found by their title.
  • Calculations, units and currencies: 12*7, 5 km to mi, 100 USD to EUR, 15% of 240. The result comes first; Enter copies it. With qalc installed; without it, plain arithmetic.
  • The web. An address opens as is. !yt lofi searches YouTube: DuckDuckGo's 13,000 bangs are suggested as you type, and a bang followed by a space turns into a chip with the site's icon. Add your own shortcuts, and the last row searches the web with the engine of your choice.
  • It learns. What you open for what you type comes first next time, as the top hit. Kept on your computer only.
  • Nothing you type leaves your computer before Enter.
  • A settings window, drawn with Omarchy's own controls, and a magnifier for the bar.
  • Four styles, qDock's: Omarchy (your theme's menu), Cupertino (Spotlight, frosted glass), Redmond (like Windows' search) and Plasma (KRunner, under the bar). With qDock installed, qSpot follows qDock's style unless you set its own.
  • English and French, following Omarchy's language. Calculations read French words too: 100 $ en €, 15 % de 240.
BangsCalculationsOmarchy style
A bang in its chipA currency conversionOmarchy style

Install

omarchy plugin add https://github.com/quebecstudio-mods/omarchy-qspot --enable

Omarchy first shows a security notice and asks you to confirm (Clone and add this plugin?); add --yes to skip the question in a script.

The magnifier lands on the right of the bar: a click opens qSpot, a right click its settings. For calculations with units and currencies, install qalc:

omarchy pkg add libqalculate

A key

Spotlight's key is Command+Space, which Omarchy gives to its menu (Super+Space). Alt+Space, as in Raycast and PowerToys Run, is where Omarchy toggles dictation once a dictation app is installed; to give it to qSpot (push-to-talk on Right Alt stays), add to ~/.config/hypr/bindings.lua:

o.rebind("ALT + SPACE", "qSpot", "omarchy-shell -q quebecstudio.qspot toggle")

Or keep dictation there and take Super+Period, which is free:

o.bind("SUPER + PERIOD", "qSpot", "omarchy-shell -q quebecstudio.qspot toggle")

Frosted glass

In the Cupertino, Redmond and Plasma styles, the window is translucent. For the blur behind it, add this rule to ~/.config/hypr/hyprland.lua:

hl.layer_rule({ match = { namespace = "^qspot$" }, blur = true, ignore_alpha = 0.2 })

Remove

omarchy plugin remove quebecstudio.qspot

Omarchy turns qSpot off, takes its magnifier out of the bar and deletes its folder. Then take out what you added by hand: the key in ~/.config/hypr/bindings.lua (with o.rebind, deleting the line gives Alt+Space back to dictation), the blur rule in ~/.config/hypr/hyprland.lua and, if you copied it, ~/.local/share/applications/qspot-settings.desktop. qSpot's settings stay in its entry under plugins in ~/.config/omarchy/shell.json, and what it learned and cached in ~/.local/state/qspot and ~/.cache/qspot: delete them too for a clean slate.

Keys

KeyWhat it does
EnterOpens the selected result; an open app comes forward; a calculation is copied
Shift+EnterA new window of an app that is already open
Ctrl+EnterShows a file in its folder
Ctrl+CCopies a file's path (with no text selected in the field)
↑ ↓, Ctrl+P / Ctrl+NMove through the results
TabTakes the selected bang into the chip
BackspaceAt the start of the field, removes the chip
EscapeClears the field, then closes qSpot

Settings

qSpot has a settings window: click the gear at the end of the field, right-click the magnifier in the bar, or open qSpot Settings from the app launcher.

The settings window

To find it in Omarchy's menu too, add this line to ~/.config/omarchy/extensions/omarchy-menu.jsonc:

"setup.qspot": {"icon":"󰍉","label":"qSpot Settings","aliases":["qspot","search","spotlight"],"action":"omarchy-shell -q quebecstudio.qspot settings"},

The launcher entry is in the plugin's assets folder:

cp ~/.config/omarchy/plugins/qspot/assets/qspot-settings.desktop ~/.local/share/applications/
cp ~/.config/omarchy/plugins/qspot/assets/logo.png ~/.local/share/icons/hicolor/256x256/apps/qspot.png

Every setting is kept in qSpot's entry under plugins in ~/.config/omarchy/shell.json (the shell.json link at the bottom of the window opens it):

{
  "id": "quebecstudio.qspot",
  "style": "cupertino",
  "searchEngine": "kagi",
  "webShortcuts": {
    "w": "https://en.wikipedia.org/w/index.php?search=%s",
    "local": { "name": "Local sites", "url": "http://%s.localhost", "home": "http://localhost" }
  }
}
SettingValuesDefault
style"omarchy", "cupertino", "redmond", "plasma"qDock's style, else "cupertino"
scrimtrue darkens the screen behind qSpot, false leaves it as it isthe style's: on for Omarchy and Redmond, off for Cupertino and Plasma
appsfalse leaves apps outtrue
windowsfalse: open apps start again rather than come forward, and windows are not searchedtrue
filesfalse leaves files outtrue
recentFilesfalse: nothing while the field is emptytrue
calculationsfalse leaves calculations outtrue
webfalse leaves out addresses and the web search row; bangs still worktrue
searchEngine"duckduckgo", "google", "bing", "kagi", "startpage", "ecosia", "brave", "qwant", or an address with %s where the terms go"duckduckgo"
webShortcutsYour own bangs, before DuckDuckGo's: { "trigger": "address with %s" }, or { "trigger": { "name", "url", "home" } } (see below)none
learnfalse: qSpot does not remember what you picktrue
bangUpdatesfalse: no download of DuckDuckGo's bangs nor of site iconstrue
currencyUpdatesfalse: qalc's exchange rates are not refreshedtrue

Your own shortcuts

A shortcut's trigger is typed after !, in any case. %s in the address is where the terms go; without it, the address opens as is. !w Montreal searches Wikipedia; !w alone opens the site. When %s is part of the site itself (http://%s.localhost), give a home for the bang typed alone. Shortcuts can be added and removed in the settings window, under Web.

Commands

omarchy-shell -q quebecstudio.qspot toggle
omarchy-shell -q quebecstudio.qspot open "text"   # opens with the field filled, for a dock or a start menu
omarchy-shell -q quebecstudio.qspot close
omarchy-shell -q quebecstudio.qspot settings      # the settings window
omarchy-shell -q quebecstudio.qspot settingsAt web   # on a section: appearance, sources, web, calc, about
omarchy-shell -q quebecstudio.qspot about

Privacy

What you type stays on your computer until you press Enter, and then goes only to the site you chose. qSpot itself connects to the network for three things, none of which depends on what you type:

  • DuckDuckGo's list of bangs, from duckduckgo.com/bang.js, once a week when qSpot opens.
  • Site icons, from DuckDuckGo's icon service: those of the 300 most used bangs and of your own shortcuts' sites ahead of time, and that of any other site once you have opened it from a bang. bangUpdates: false turns both off.
  • Exchange rates, fetched by qalc at most once a day when qSpot opens. currencyUpdates: false turns this off.

Your files' index (~/.cache/qspot/home.db) and what qSpot learns (~/.local/state/qspot/choices.json) stay on your computer; Forget my choices, under Sources, clears the latter.

Good to know

  • qSpot needs plocate and Python, both shipped with Omarchy. Until its own index is built, a few seconds after the first start, it reads the system's.
  • Only your home folder is searched. Hidden files show up when what you type starts with a dot (.env); hidden folders, node_modules, vendor, build output and caches never do. ~/.config is searched but ranks lower.
  • The apps are Omarchy's launcher entries, hidden ones aside, with their icons.

See also

  • qDock, a Mac-style dock.
  • qExposé, Exposé and Alt+Tab with previews.
  • qCenter, a Mac-style notification center.
  • Changelog: what changed in each version.

License

MIT © Québec Studio. Bangs are DuckDuckGo's; site icons come from DuckDuckGo's icon service.

macOS and Spotlight are trademarks of Apple Inc.; Windows and PowerToys are trademarks of Microsoft Corporation; KDE, Plasma and KRunner are trademarks of KDE e.V.; DuckDuckGo is a trademark of Duck Duck Go, Inc. This project is not affiliated with or endorsed by any of them.

View the source on GitHub

An idea that doesn’t exist yet?

That’s exactly what we do best. Tell us about it: we’ll find the best way to build it, on your timeline and within your budget.

Tell us

We use cookies

This site uses cookies that are required for it to work. With your consent, we also use cookies to measure traffic. You can change your mind at any time. Privacy policy

Your cookie preferences

Always on

Required for the site to work and for form security. These cannot be turned off.

Necessary
Cookie Set by Purpose Retention
CraftSessionId This site Keeps your browsing session. Session
CRAFT_CSRF_TOKEN This site Protects forms against cross-site request forgery. Session
cookie_consent This site Remembers your cookie choices. 6 months

Help us understand how the site is used so we can improve it. Measured with Matomo.

Statistics
Cookie Set by Purpose Retention
_pk_id.* This site Recognizes the browser from one visit to the next, without identifying you. 13 months
_pk_ses.* This site Groups the pages viewed during a single visit. 30 minutes