(Widget) Quick Launch

Quick Launch Widget

The Quick Launch widget provides a Spotlight style search launcher accessible from the bar. It displays a centered popup where you can search for applications, perform calculations, convert currencies, search browser bookmarks, search the web, run system commands, open Windows Settings pages, kill processes, find files and more, all from a single unified search interface.

Widget Options

Option	Type	Default	Description
`label`	string	`"\uf002"`	The label/icon for the widget on the bar.
`search_placeholder`	string	`"Search applications..."`	Placeholder text for the search field.
`max_results`	int	`50`	Maximum number of results displayed (1–500).
`show_icons`	bool	`true`	Show icons next to search results.
`icon_size`	int	`32`	Size of result icons in pixels.
`home_page`	bool	`true`	Show provider shortcut tiles when search is empty.
`compact_mode`	bool	`false`	When enabled, the popup starts collapsed to just the search bar and only expands to show results when you start typing.
`providers`	dict	See below	Configuration for each search provider.
`popup`	dict	See below	Popup window appearance settings.
`animation`	dict	`{enabled: true, type: "fadeInOut", duration: 200}`	Widget animation settings.
`label_shadow`	dict	`None`	Label shadow options.
`container_shadow`	dict	`None`	Container shadow options.
`keybindings`	list	`[]`	Global keybindings for toggling the popup.
`callbacks`	dict	`{on_left: "toggle_quick_launch", on_right: "do_nothing", on_middle: "do_nothing"}`	Mouse event callbacks.

Popup Options

Option	Type	Default	Description
`width`	int	`720`	Width of the popup window in pixels.
`height`	int	`480`	Height of the popup window in pixels.
`blur`	bool	`true`	Enable background blur effect (Windows 11).
`round_corners`	bool	`true`	Enable rounded corners on the popup window.
`round_corners_type`	string	`"normal"`	Corner rounding type (`"normal"` or `"small"`).
`border_color`	string	`"System"`	Border color of the popup (`"System"`, HEX value, or `"None"`).
`dark_mode`	bool	`true`	Force dark mode colors for the popup (Windows 11).
`screen`	string	`"focus"`	Which screen to show the popup on: `"focus"`, `"cursor"`, or `"primary"`.

Screen Modes

Mode	Description
`"focus"`	Show popup on the screen where the currently focused window is.
`"cursor"`	Show popup on the screen where the mouse cursor is.
`"primary"`	Always show popup on the primary monitor.

Note

When using multiple monitors with bars on each screen, only one popup is shown at a time regardless of which screen triggers it.

Providers

Quick Launch uses a plugin-based provider system. Each provider handles a specific type of search and can be enabled/disabled independently. Providers are activated either automatically or via a prefix character typed into the search field.

Provider Index

Apps
Bookmarks
Calculator
Clipboard History
Color
Currency
Emoji
File Search
Kill Process
Port Viewer
Settings
Snippets
System Commands
Unit Converter
Web Search
World Clock
Hacker News
Developer Tools
IP / Network Info
VSCode
Window Switcher

Apps Provider

Searches installed applications (Start Menu shortcuts). This is the default provider when no prefix is used.

Option	Type	Default	Description
`enabled`	bool	`true`	Enable/disable the apps provider.
`prefix`	string	`"*"`	Trigger prefix. `"*"` means included in default results.
`priority`	int	`0`	Sort order when multiple providers share the same prefix. Lower values appear first.
`show_recent`	bool	`true`	Show recently launched apps at the top.
`max_recent`	int	`10`	Maximum number of recent apps to display.
`show_description`	bool	`false`	Show a short description of the application.

Calculator Provider

Inline math evaluation. Type = followed by a math expression (e.g., =2+2, =sqrt(144)).

Option	Type	Default	Description
`enabled`	bool	`false`	Enable/disable the calculator provider.
`prefix`	string	`"="`	Trigger prefix. Use `"*"` to include in default results.
`priority`	int	`0`	Sort order when multiple providers share the same prefix. Lower values appear first.

Clipboard History Provider

Browse and restore Windows Clipboard History entries. Type cb to list recent items, cb <term> to filter, or cb clear to reveal the "Clear clipboard history" action. Supports plain text, rich text (HTML), and images with previews, press Enter to restore an item to the clipboard.

Option	Type	Default	Description
`enabled`	bool	`false`	Enable/disable the clipboard history provider.
`prefix`	string	`"cb"`	Trigger prefix. Use `"*"` to include in default results.
`priority`	int	`0`	Sort order when multiple providers share the same prefix. Lower values appear first.
`max_items`	int	`30`	Maximum number of clipboard history items to show.

Usage:

Press Enter on a result to restore it to the clipboard.
Right-click a result for Copy to clipboard or Delete from history actions.

Note

Clipboard History requires Windows' Clipboard History feature. If the feature is disabled or access is denied, Quick Launch will show an explanatory message and can open the Windows Clipboard settings.

Currency Provider

Convert between currencies using ECB (European Central Bank) daily rates. Type $ followed by an amount and currency codes (e.g., $100 usd eur, $50 gbp jpy). Rates are cached locally for 12 hours. Works offline using cached data.

Option	Type	Default	Description
`enabled`	bool	`false`	Enable/disable the currency provider.
`prefix`	string	`"$"`	Trigger prefix. Use `"*"` to include in default results.
`priority`	int	`0`	Sort order when multiple providers share the same prefix. Lower values appear first.

Input formats:

$100 usd eur - Convert 100 USD to EUR
$50 gbp to jpy - Convert 50 GBP to JPY (optional "to")
$usd eur - Show rate for 1 USD to EUR
$usd - Show 1 USD converted to common currencies
$eur - Show EUR rates overview

Click a result to copy the converted value to the clipboard.

Note

Currency rates are fetched from the ECB and cached for 12 hours. If there is no internet connection and no cached data, a "rates unavailable" message is shown. Stale cached rates are used as fallback when the network is unreachable.

Web Search Provider

Opens a web search in the default browser. Type ? followed by a search query (e.g., ?python docs). The configured engine appears first in the results, followed by all other available engines so you can pick any of them with a single click.

Option	Type	Default	Description
`enabled`	bool	`false`	Enable/disable the web search provider.
`prefix`	string	`"?"`	Trigger prefix. Use `"*"` to include in default results.
`priority`	int	`0`	Sort order when multiple providers share the same prefix. Lower values appear first.
`engine`	string	`"google"`	Preferred (first) search engine. All other engines are shown below it.

Window Switcher Provider

Quickly search and switch to currently open application windows. Type win followed by the window title or application name to filter the list. When no query is provided, windows are listed in Z-order.

Option	Type	Default	Description
`enabled`	bool	`false`	Enable/disable the window switcher provider.
`prefix`	string	`"win"`	Trigger prefix. Use `"*"` to include in default results.
`priority`	int	`0`	Sort order when multiple providers share the same prefix. Lower values appear first.

Available engines:

Engine	Description
`"google"`	Google web search (default)
`"bing"`	Bing web search
`"duckduckgo"`	DuckDuckGo private search
`"wikipedia"`	Wikipedia article search
`"github"`	GitHub repositories and code search
`"youtube"`	YouTube video search
`"reddit"`	Reddit posts and communities search
`"stackoverflow"`	Stack Overflow programming Q&A

Bookmarks Provider

Search and open browser bookmarks. Type * followed by a search term (e.g., *github, *recipes). Supports Chrome, Edge, Brave, Vivaldi, Chromium, and Firefox.

Option	Type	Default	Description
`enabled`	bool	`false`	Enable/disable the bookmarks provider.
`prefix`	string	`"*"`	Trigger prefix. `"*"` means included in default results.
`priority`	int	`0`	Sort order when multiple providers share the same prefix. Lower values appear first.
`browser`	string	`"all"`	Browser to read bookmarks from (`"all"`, `"chrome"`, `"edge"`, `"brave"`, `"firefox"`, `"vivaldi"`, `"chromium"`).
`profile`	string	`"Default"`	Chromium browser profile name (e.g., `"Default"`, `"Profile 1"`).

Bookmarks are cached in memory and automatically reloaded when the bookmark file changes. Search matches against bookmark title, URL, and folder name.

Note

When browser is set to "all" (default), bookmarks are loaded from every supported browser found on the system (Chrome, Edge, Brave, Vivaldi, Chromium, Firefox). Duplicates across browsers are kept. Firefox bookmarks are read from a copy of the places.sqlite database to avoid locking issues.

System Commands Provider

Exposes common system actions. Type > followed by a command name (e.g., >shutdown, >lock).

Option	Type	Default	Description
`enabled`	bool	`false`	Enable/disable the system commands provider.
`prefix`	string	`">"`	Trigger prefix. Use `"*"` to include in default results.
`priority`	int	`0`	Sort order when multiple providers share the same prefix. Lower values appear first.

Available commands: shutdown, restart, sleep, hibernate, lock, sign out, force shutdown, force restart.

Settings Provider

Quick access to Windows Settings pages. Type @ followed by a setting name (e.g., @wifi, @bluetooth, @display).

Option	Type	Default	Description
`enabled`	bool	`false`	Enable/disable the settings provider.
`prefix`	string	`"@"`	Trigger prefix. Use `"*"` to include in default results.
`priority`	int	`0`	Sort order when multiple providers share the same prefix. Lower values appear first.

Kill Process Provider

Search and terminate running processes. Type ! followed by a process name (e.g., !notepad).

Option	Type	Default	Description
`enabled`	bool	`false`	Enable/disable the kill process provider.
`prefix`	string	`"!"`	Trigger prefix. Use `"*"` to include in default results.
`priority`	int	`0`	Sort order when multiple providers share the same prefix. Lower values appear first.

Port Viewer Provider

View TCP/UDP ports (via netstat) and the owning PID/process name.

Type pv followed by optional filters (e.g. pv 80, pv tcp 443, pv kill 80):

pv 80 - show entries for local port 80
pv tcp 443 - show TCP entries for local port 443
pv udp 53 - show UDP entries for local port 53
pv chrome - show ports for processes matching "chrome" (includes all TCP states)
pv kill 80 - kill the owning process for port 80 (if resolvable)
pv kill 12345 - kill PID 12345 (heuristic: numbers > 65535 are treated as PID)
pv kill chrome - kill processes matching "chrome"

Port numbers are matched by digits (substring match). For example, pv udp 5 can match ports like 500, 5353, 5985, etc. Text filters search across process names, addresses, protocols and states.

Selecting a normal (non-kill) result copies a short summary string to the clipboard.

Option	Type	Default	Description
`enabled`	bool	`false`	Enable/disable the port viewer provider.
`prefix`	string	`"pv"`	Trigger prefix.
`priority`	int	`0`	Sort order when multiple providers share the same prefix. Lower values appear first.
`tcp_listening_only`	bool	`true`	Only show `LISTENING` TCP entries by default.
`include_established`	bool	`false`	Include non-`LISTENING` TCP entries (e.g. `ESTABLISHED`).

File Search Provider

Search files and folders on the system. Type / followed by a filename (e.g., /readme.txt). Supports glob patterns like /*.mp3 or /config*.json.

Option	Type	Default	Description
`enabled`	bool	`false`	Enable/disable the file search provider.
`prefix`	string	`"/"`	Trigger prefix. Use `"*"` to include in default results.
`priority`	int	`0`	Sort order when multiple providers share the same prefix. Lower values appear first.
`backend`	string	`"auto"`	Search backend: `"auto"`, `"everything"`, `"index"`, or `"disk"`.
`show_path`	bool	`true`	Show the parent folder path and file size in the result description.

Backends

Backend	Description
`"auto"`	Tries Everything first, then Index, then Disk as a final fallback.
`"everything"`	Uses the bundled Everything SDK for instant indexed search. Requires the Everything process to be running. Supports installations via installer, portable, or Scoop.
`"index"`	Uses the Windows Search indexer via ADODB/SystemIndex. Only searches indexed locations.
`"disk"`	Full disk scan using Win32 `FindFirstFileExW`. No index required. Works on any system but slower than Everything.

Note

The Everything SDK DLL is bundled with the widget - no manual SDK setup is required. For best performance, install Everything by voidtools. The widget automatically detects Everything installed via the official installer, Scoop package manager, or in the standard Program Files directory. If Everything is not running, the widget shows a prompt to launch it.

Note

The "disk" backend only scans fixed local drives. Removable drives (USB), network drives, and CD/DVD drives are automatically skipped. System directories like Windows, $Recycle.Bin, node_modules, .git, and other common cache/build folders are also excluded for performance.

Unit Converter Provider

Convert between units of measurement. Type ~ followed by a value and unit (e.g., ~10 kg to lb, ~100 f to c). Supports length, weight, volume, speed, data sizes, time, and temperature.

Option	Type	Default	Description
`enabled`	bool	`false`	Enable/disable the unit converter provider.
`prefix`	string	`"~"`	Trigger prefix. Use `"*"` to include in default results.
`priority`	int	`0`	Sort order when multiple providers share the same prefix. Lower values appear first.

Supported categories:

Length: mm, cm, m, km, in, ft, yd, mi, nmi
Weight: mg, g, kg, t, oz, lb, st
Volume: ml, l, gal, qt, pt, cup, floz, tbsp, tsp
Speed: m/s, km/h, mph, knots, ft/s
Data: b, kb, mb, gb, tb, pb
Time: ms, s, min, h, d, wk, yr
Temperature: c, f, k

If no target unit is specified, common conversions within the same category are shown. Click a result to copy the value.

Emoji Provider

Search and copy emojis to the clipboard. Type : followed by a name (e.g., :smile, :fire, :heart).

Option	Type	Default	Description
`enabled`	bool	`false`	Enable/disable the emoji provider.
`prefix`	string	`":"`	Trigger prefix. Use `"*"` to include in default results.
`priority`	int	`0`	Sort order when multiple providers share the same prefix. Lower values appear first.

Searches emoji names, aliases, and tags. Click a result to copy the emoji character to the clipboard.

Color Provider

Pick colors from the screen and convert between HEX, RGB, HSL, HSV, HWB, LAB, LCH, OKLAB, and OKLCH formats. Type c: followed by a color value (e.g., c:#FF5500, c:rgb(255,85,0), c:coral).

Option	Type	Default	Description
`enabled`	bool	`false`	Enable/disable the color provider.
`prefix`	string	`"c:"`	Trigger prefix. Use `"*"` to include in default results.
`priority`	int	`0`	Sort order when multiple providers share the same prefix. Lower values appear first.

Accepted input formats:

HEX: #FF5500, #F50, FF5500
RGB: rgb(255, 85, 0) or 255, 85, 0
HSL: hsl(20, 100%, 50%)
HWB: hwb(20, 0%, 0%)
LAB: lab(62.83, 51.28, 64.35)
LCH: lch(62.83, 82.34, 51.42)
OKLAB: oklab(0.6726, 0.0834, 0.1221)
OKLCH: oklch(0.6726, 0.148, 55.65)
Named colors: coral, steelblue, crimson, etc.

Shows all nine representations (HEX, RGB, HSL, HSV, HWB, LAB, LCH, OKLAB, OKLCH). Press Enter on a result to copy the value.

Snippets Provider

Save and type text snippets into the previously focused window. Type ; to see all your snippets sorted by recent use, or ;meeting to filter by name or content. Selecting a snippet closes the popup and types the text into whatever window was focused before, using SendInput. You can also create and edit snippets inline using the preview panel.

Snippets support template variables that get resolved at the moment you use them:

Variable	Description
`{{date}}`	Current date (default format: YYYY-MM-DD).
`{{date:%d/%m/%Y}}`	Current date with a custom format.
`{{time}}`	Current time (default format: HH:MM:SS).
`{{time:%I:%M %p}}`	Current time with a custom format.
`{{datetime}}`	Current date and time.
`{{clipboard}}`	Current clipboard text.
`{{username}}`	Windows username.

Right-click a snippet for options like Copy to clipboard, Edit, or Delete.

Option	Type	Default	Description
`enabled`	bool	`false`	Enable/disable the snippets provider.
`prefix`	string	`";"`	Trigger prefix. Use `"*"` to include in default results.
`priority`	int	`0`	Sort order when multiple providers share the same prefix. Lower values appear first.
`type_delay`	int	`200`	Delay in milliseconds before typing starts after the popup closes. Increase if the target window needs more time to regain focus.

World Clock Provider

Show current time in cities around the world. Type tz to see your pinned cities (or a default set if nothing is pinned), or tz tokyo to filter by city name. Click a result to copy the formatted time to the clipboard. Right-click a city to pin or unpin it. Pinned cities appear first when searching and are shown as the default view.

Option	Type	Default	Description
`enabled`	bool	`false`	Enable/disable the world clock provider.
`prefix`	string	`"tz"`	Trigger prefix. Use `"*"` to include in default results.
`priority`	int	`0`	Sort order when multiple providers share the same prefix. Lower values appear first.

Each result displays:

Title: City name and current time (e.g., Tokyo - 2:30 AM)
Description: Date, UTC offset, and difference from local time (e.g., Wed, Feb 14 - UTC+9 (14h ahead))

Note

World Clock uses Python's built-in zoneinfo module - no API calls or external dependencies required. Times are always live and accurate.

Hacker News Provider

Browse and search Hacker News stories directly from Quick Launch. Type hn to see available topics (Front Page, Newest, Best, Ask HN, Show HN, Jobs, Best Comments, Active), then click a topic to load stories. You can also type a keyword after a topic to filter (e.g., hn newest rust), or type any keyword directly to search all of HN (e.g., hn python).

Clicking a story opens it in your default browser. Right-click a story to open the HN comments page or copy the URL.

Option	Type	Default	Description
`enabled`	bool	`false`	Enable/disable the Hacker News provider.
`prefix`	string	`"hn"`	Trigger prefix to activate the provider.
`priority`	int	`0`	Sort order when multiple providers share the same prefix. Lower values appear first.
`cache_ttl`	int	`300`	How long (in seconds) to cache feed results before fetching again.
`max_items`	int	`30`	Maximum number of stories to fetch per topic (hnrss.org limit is 100).

Available topics:

Topic	Description
`frontpage`	Top stories on the HN front page
`newest`	Most recently submitted stories
`best`	Highest-voted stories overall
`ask`	Ask HN posts and discussions
`show`	Show HN community projects and launches
`jobs`	Job postings from YC companies
`bestcomments`	Highly voted comments from across Hacker News
`active`	Posts with the most active ongoing discussions

Usage examples:

hn — Show all topic tiles
hn frontpage — Load front page stories
hn newest rust — Search newest stories for "rust"
hn python — Search all of HN for "python"
hn ask — Browse Ask HN posts

Each story result displays:

Title: The story title
Description: Points, comment count, author, and relative time (e.g., 42 points │ 15 comments │ by username │ 3h ago)

Context menu actions:

Open HN comments — Opens the Hacker News discussion page
Copy URL — Copies the story URL to clipboard

Note

Hacker News provider uses hnrss.org RSS feeds. Results are cached in memory and on disk to minimize network requests. No API key is required.

Developer Tools Provider

A collection of common developer utilities accessible from Quick Launch. All operations are local — no network requests, no API keys, instant results.

Option	Type	Default	Description
`enabled`	bool	`false`	Enable/disable the Developer Tools provider.
`prefix`	string	`"dev"`	Prefix to activate the provider.
`priority`	int	`0`	Display priority (higher = shown first).

Available tools:

Command	Description	Example
`uuid`	Generate UUID v4 values (optional count)	`dev uuid` or `dev uuid 10`
`hash`	MD5, SHA1, SHA256, SHA512 hashes	`dev hash hello world`
`base64`	Base64 encode (and auto-decode if valid)	`dev base64 hello`
`url`	URL percent-encode/decode	`dev url hello world`
`jwt`	Decode JWT token payload	`dev jwt eyJhbG...`
`lorem`	Generate lorem ipsum paragraphs/words	`dev lorem`
`ts`	Convert between unix timestamps and dates	`dev ts 1700000000`
`pw`	Generate secure random passwords (optional length)	`dev pw` or `dev pw 32`

Usage examples:

Type dev to see all available tools as tiles
Type dev uuid to generate 5 random UUIDs (click to copy)
Type dev hash mypassword to see MD5/SHA1/SHA256/SHA512 hashes
Type dev base64 hello to encode; paste Base64 text to auto-decode
Type dev jwt <token> to decode JWT payload with timestamp formatting
Type dev ts to see current unix timestamp; type dev ts 1700000000 to convert
Type dev pw 24 to generate 24-character passwords

Note

All Developer Tools operations run entirely offline using Python's standard library. Click any result to copy it to the clipboard.

IP / Network Info Provider

Provides local network interface details, public IP lookup, subnet calculator, IP analysis, DNS lookup, and MAC address listing. All operations except public IP are fully offline.

Option	Type	Default	Description
`enabled`	bool	`false`	Enable/disable the IP / Network Info provider.
`prefix`	string	`"ip"`	Prefix to activate the provider.
`priority`	int	`0`	Display priority (higher = shown first).

Available tools:

Command	Description	Example
`info`	Show local interfaces (IP, MAC, subnet mask)	`ip info`
`public`	Fetch your external IP, ISP, location (online)	`ip public`
`calc`	Subnet calculator from CIDR notation	`ip calc 192.168.1.0/24`
`check`	Analyze IP (type, class, binary, hex, reverse DNS)	`ip check 10.0.0.1`
`dns`	Resolve hostname to IP addresses	`ip dns google.com`
`mac`	List all adapter MAC addresses	`ip mac`

Usage examples:

Type ip to see all available tools as tiles
Type ip info to list all local network interfaces with IPv4, IPv6, MAC, and subnet mask
Type ip public to fetch your public IP with ISP, location, and timezone
Type ip calc 10.0.0.0/16 to see network, broadcast, host range, total hosts
Type ip check 172.16.5.1 to see type (Private), class (B), binary, hex representation
Type ip dns github.com to resolve IPv4 and IPv6 addresses
Type ip mac to list all adapter MAC addresses

Note

Public IP uses ip-api.com

VSCode Provider

Search and open recently used projects, folders, and files directly in Visual Studio Code. Type vsc (or your configured prefix) to see your recent VSCode history, or vsc <query> to fuzzy search through them. Results are intelligently scored based on the search query.

Option	Type	Default	Description
`enabled`	bool	`false`	Enable/disable the VSCode provider.
`prefix`	string	`"vsc"`	Prefix to activate the provider.
`priority`	int	`0`	Display priority (higher = shown first).

Usage examples:

Type vsc to see your most recent VSCode projects chronologically.
Type vsc yasb to fuzzy search for any recent folders or files matching "yasb".
Selecting any project opens it instantly via the code CLI.

Note

The VSCode provider reads directly from VSCode's internal SQLite state database (state.vscdb) in read-only mode to prevent lock issues and does not require VSCode to be running.

Provider Prefixes Reference

Prefixes are configurable per provider. Set prefix to "*" to include a provider in the default (unprefixed) results. These are the defaults:

Prefix	Provider	Example
`*`	Apps	`notepad`
`*`	Bookmarks	`*github`
`=`	Calculator	`=2*pi`
`cb`	Clipboard History	`cb notepad`
`c:`	Color	`c:#FF5500`
`$`	Currency	`$100 usd eur`
`:`	Emoji	`:fire`
`/`	File Search	`/report.docx`
`!`	Kill Process	`!chrome`
`;`	Snippets	`;meeting notes`
`@`	Settings	`@wifi`
`>`	System Commands	`>lock`
`~`	Unit Converter	`~10 kg to lb`
`?`	Web Search	`?python tutorial`
`tz`	World Clock	`tz tokyo`
`hn`	Hacker News	`hn frontpage`
`dev`	Developer Tools	`dev uuid`
`ip`	IP / Network Info	`ip info`
`vsc`	VSCode	`vsc project`

Example Minimal Configuration enabling just the apps provider

quick_launch:
    type: "yasb.quick_launch.QuickLaunchWidget"
    options:
        label: "<span>\uf002</span>"
        search_placeholder: "Search applications..."
        max_results: 30
        show_icons: true
        icon_size: 32
        popup:
            width: 720
            height: 480
            screen: "focus"
            blur: true
            round_corners: true
            round_corners_type: "normal"
            border_color: "system"
            dark_mode: true
        callbacks:
            on_left: "toggle_quick_launch"
        keybindings:
            - keys: "alt+space"
              action: "toggle_quick_launch"

Example Configuration enabling multiple providers

quick_launch:
    type: "yasb.quick_launch.QuickLaunchWidget"
    options:
        label: "<span>\uf002</span>"
        search_placeholder: "Search applications..."
        max_results: 50
        show_icons: true
        icon_size: 32
        providers:
            apps:
                enabled: true
                prefix: "*"
                priority: 0
                show_recent: true
                max_recent: 5
                show_description: true
            calculator:
                enabled: true
                prefix: "="
                priority: 1
            clipboard_history:
                enabled: true
                prefix: "cb"
                priority: 2
                max_items: 30
            currency:
                enabled: true
                prefix: "$"
                priority: 3
            bookmarks:
                enabled: true
                prefix: "*"
                priority: 4
                browser: "all"
                profile: "Default"
            web_search:
                enabled: true
                prefix: "?"
                priority: 5
                engine: "google"
            system_commands:
                enabled: true
                prefix: ">"
                priority: 6
            settings:
                enabled: true
                prefix: "@"
                priority: 7
            kill_process:
                enabled: true
                prefix: "!"
                priority: 8
            port_viewer:
                enabled: true
                prefix: "pv"
                priority: 9
                tcp_listening_only: true
                include_established: false
            file_search:
                enabled: true
                prefix: "/"
                priority: 10
                backend: "auto"
                show_path: true
            unit_converter:
                enabled: true
                prefix: "~"
                priority: 11
            emoji:
                enabled: true
                prefix: ":"
                priority: 12
            color:
                enabled: true
                prefix: "c:"
                priority: 13
            world_clock:
                enabled: true
                prefix: "tz"
                priority: 14
            snippets:
                enabled: true
                prefix: ";"
                priority: 15
                type_delay: 200
            hacker_news:
                enabled: true
                prefix: "hn"
                priority: 16
                cache_ttl: 300
                max_items: 30
            dev_tools:
                enabled: true
                prefix: "dev"
                priority: 17
            ip_info:
                enabled: true
                prefix: "ip"
                priority: 18
            vscode:
                enabled: true
                prefix: "vsc"
                priority: 19
        popup:
            width: 720
            height: 480
            screen: "focus"
            blur: true
            round_corners: true
            round_corners_type: "normal"
            border_color: "system"
            dark_mode: true
        callbacks:
            on_left: "toggle_quick_launch"
        keybindings:
            - keys: "alt+space"
              action: "toggle_quick_launch"

Description of Options

label: The label/icon displayed on the bar. Can contain HTML with icon fonts.
search_placeholder: Placeholder text shown in the search input when empty.
max_results: Maximum number of results displayed across all providers.
show_icons: Whether to show icons next to each result.
icon_size: The size of application icons (in pixels). Only applies to image-based icons.
home_page: When true, show provider shortcut tiles (home page) when the search input is empty.
providers: Configuration for each search provider. Each provider can be individually enabled/disabled and configured.
- apps: Application search with frecency-ranked results. See Apps Provider table above.
- bookmarks: Search and open browser bookmarks (Chrome, Edge, Brave, Vivaldi, Chromium, Firefox). Configurable browser and profile options.
- calculator: Inline math evaluation with prefix =.
- clipboard_history: Browse and restore Windows Clipboard History entries (text, rich text, images). Use max_items to limit how many entries are shown.
- currency: Currency conversion using ECB daily rates with prefix $. Rates cached for 12 hours.
- web_search: Browser-based web search with prefix ?. Shows all engines (Google, Bing, DuckDuckGo, Wikipedia, GitHub, YouTube, Reddit, Stack Overflow) with the preferred engine listed first.
- system_commands: System actions (shutdown, restart, lock, etc.) with prefix >.
- settings: Quick access to Windows Settings pages with prefix @.
- kill_process: Process search and termination with prefix !.
- file_search: File and folder search with prefix /. Uses Everything SDK, Windows Search indexer, or full disk scan.
- port_viewer: View TCP/UDP ports and the owning PID/process name (via netstat). Supports filtering and kill actions.
- unit_converter: Convert between units (length, weight, volume, speed, data, time, temperature) with prefix ~.
- emoji: Search and copy emojis to clipboard with prefix :.
- color: Pick colors from screen and convert between HEX, RGB, HSL, HSV, HWB, LAB, LCH, OKLAB, OKLCH with prefix c:.
- world_clock: Show current time in cities worldwide with prefix tz. Pin cities via right-click.
- snippets: Save and type text snippets with prefix ;. Supports template variables and inline editing.
- vscode: Launch recent files and folders in Visual Studio Code with prefix vsc. Uses fuzzy searching.
popup: Popup window appearance settings.
- width: Width of the popup window in pixels.
- height: Height of the popup window in pixels.
- screen: Which screen to show the popup on ("focus", "cursor", or "primary").
- blur: Enable background blur effect (requires Windows 11).
- round_corners: Enable rounded corners on the popup.
- round_corners_type: Type of corner rounding ("normal" or "small").
- border_color: Border color of the popup window ("System" for system accent color, HEX value, or "None").
animation: Widget animation settings.
- enabled: Whether animations are enabled.
- type: Type of animation ("fadeInOut").
- duration: Duration of the animation in milliseconds.
keybindings: A list of global keybindings. Each entry must specify keys (a list of key combinations) and action (the callback to invoke, e.g., "toggle_quick_launch").
callbacks: Mouse event callbacks (on_left, on_middle, on_right). Valid actions: "toggle_quick_launch", "do_nothing".
label_shadow: Shadow options for the bar label.
container_shadow: Shadow options for the widget container.

Example Style

/* Quick Launch Widget */
.quick-launch-widget .icon {
	font-size: 14px;
	padding: 0 4px;
}
.quick-launch-widget .icon:hover {
	color: #fff;
}

/* Quick Launch Popup - main window */
.quick-launch-popup .container {
	background-color: rgba(29, 29, 29, 0.452);
}
/* Search bar container */
.quick-launch-popup .search {
	padding: 12px 16px;
	background-color: transparent;
	border-bottom: 1px solid rgba(255, 255, 255, 0.15);
}
/* Search loader line color */
.quick-launch-popup .search .loader-line {
	color: #449bff;
}
.quick-launch-popup .search .search-icon {
	font-family: "Segoe Fluent Icons";
	font-size: 18px;
	color: rgba(255, 255, 255, 0.6);
	padding-right: 8px;
	min-width: 18px;
}
.quick-launch-popup .search .search-submit-icon {
	font-family: "Segoe Fluent Icons";
	font-size: 18px;
	color: rgba(255, 255, 255, 0.6);
	min-width: 18px;
}
.quick-launch-popup .search .search-input {
	background: transparent;
	border: none;
	color: #ffffff;
	font-size: 16px;
	font-family: "Segoe UI";
	font-weight: 400;
	padding: 4px 0;
}
/* Search prefix styling (e.g., ">" for commands) */
.quick-launch-popup .search .prefix {
	background: #2167d8;
	border-radius: 6px;
	color: #ffffff;
	padding: -2px 8px 0px 8px;
	margin-top: 2px;
	margin-right: 4px;
	font-size: 13px;
	font-weight: 600;
	font-family: "Segoe UI";
	max-height: 28px;
}

/* Results list */
.quick-launch-popup .results {
	background: transparent;
	padding: 8px;
}
/* Individual result item here you can set font szie for title */
.quick-launch-popup .results-list-view {
	font-size: 16px;
	font-family: "Segoe UI";
	font-weight: 600;
	color: #ffffff;
}
.quick-launch-popup .results-list-view .description {
	color: rgba(255, 255, 255, 0.6);
	font-size: 11px;
	font-family: "Segoe UI";
	font-weight: 600;
}
/* Result item hover and selected states */
.quick-launch-popup .results-list-view::item {
	padding: 12px;
	border-radius: 8px;
}
.quick-launch-popup .results-list-view::item:hover,
.quick-launch-popup .results-list-view::item:selected {
	background-color: rgba(128, 130, 158, 0.1);
}
/* Empty state when no results found */
.quick-launch-popup .results-empty-text {
	font-size: 24px;
	font-family: "Segoe UI";
	color: rgb(255, 255, 255);
	padding-top: 8px;
}

/* Preview Pane */
.quick-launch-popup .preview {
	background: rgba(0, 0, 0, 0);
	border-left: 1px solid rgba(255, 255, 255, 0.06);
}
.quick-launch-popup .preview .preview-text {
	font-size: 13px;
	color: rgba(255, 255, 255, 0.85);
	padding: 8px 12px;
	font-family: "Segoe UI";
	background-color: rgba(255, 255, 255, 0.03);
	border: none;
}
.quick-launch-popup .preview .preview-image {
	background-color: rgba(255, 255, 255, 0.03);
	padding: 8px 12px;
}
.quick-launch-popup .preview .preview-meta {
	padding: 6px 12px;
	border-top: 1px solid rgba(255, 255, 255, 0.06);
	font-family: "Segoe UI";
}
.quick-launch-popup .preview .preview-meta .preview-title {
	font-size: 14px;
	font-weight: 600;
	color: rgb(255, 255, 255);
	font-family: "Segoe UI";
	margin-bottom: 10px;
	margin-left: -2px;
}

.quick-launch-popup .preview .preview-meta .preview-subtitle {
	font-size: 12px;
	color: rgba(255, 255, 255, 0.8);
	font-family: "Segoe UI";
	padding-bottom: 1px;
}

/* Preview inline edit form (.preview.edit) */
.quick-launch-popup .preview.edit .preview-title {
	font-size: 13px;
	font-family: "Segoe UI";
	font-weight: 600;
	color: #ffffff;
	padding: 8px 12px 4px 12px;
}
.quick-launch-popup .preview.edit .preview-line-edit {
	background: rgba(255, 255, 255, 0.06);
	border: 1px solid rgba(255, 255, 255, 0.12);
	border-radius: 4px;
	color: #ffffff;
	font-size: 13px;
	font-family: "Segoe UI";
	padding: 6px 8px;
	margin: 0 12px;
}
.quick-launch-popup .preview.edit .preview-line-edit:focus {
	border-color: rgba(255, 255, 255, 0.3);
}
.quick-launch-popup .preview.edit .preview-text-edit {
	background: rgba(255, 255, 255, 0.06);
	border: 1px solid rgba(255, 255, 255, 0.12);
	border-radius: 4px;
	color: #ffffff;
	font-size: 13px;
	font-family: "Segoe UI";
	padding: 6px 8px;
	margin: 0 12px;
}
.quick-launch-popup .preview.edit .preview-text-edit:focus {
	border-color: rgba(255, 255, 255, 0.3);
}
.quick-launch-popup .preview.edit .preview-actions {
	padding: 8px 12px;
}
.quick-launch-popup .preview.edit .preview-btn {
	background: rgb(45, 46, 48);
	border: none;
	border-radius: 4px;
	color: rgba(255, 255, 255, 0.8);
	font-size: 12px;
	font-family: "Segoe UI";
	font-weight: 600;
	padding: 4px 16px;
}
.quick-launch-popup .preview.edit .preview-btn:hover {
	background: rgb(59, 60, 63);
}
.quick-launch-popup .preview.edit .preview-btn.save {
	background: rgb(12, 81, 190);
	color: #ffffff;
}
.quick-launch-popup .preview.edit .preview-btn.save:hover {
	background: rgb(19, 90, 204);
}

Note

This widget uses SVG icons by default, which cannot be styled with CSS. Also, keep in mind that styling may be limited for certain elements.

Important

Quick Launch widget uses the QMenu, which supports various styles. You can customize the appearance of the menu using CSS styles. For more information on styling, refer to the Styling.

Preview

QL Widget Preview

Home
Installation
Configuration
Keybindings
Styling
YASB CLI
FAQ
Contributing
Writing Widget
Widgets:
- Active Windows Title
- Ai Chat
- Applications
- Battery
- Bluetooth
- Brightness
- Cava
- Copilot
- CPU
- Clock
- Custom
- Github
- GlazeWM Binding Mode
- GlazeWM Tiling Direction
- GlazeWM Workspaces
- Glucose Monitor
- Grouper
- GPU
- Home
- Disk
- Language
- Launchpad
- Libre Hardware Monitor
- Media
- Memory
- Microphone
- Notifications
- Notes
- OBS
- Open Meteo
- Server Monitor
- Systray
- Todo
- Traffic
- Taskbar
- Pomodoro
- Power Menu
- Power Plan
- Quick Launch
- Recycle Bin
- Update Check
- Visual Studio Code
- Volume
- Wallpapers
- Weather
- WiFi
- WHKD
- Window Controls
- Windows Desktops
- Komorebi Control
- Komorebi Layout
- Komorebi Stack
- Komorebi Workspaces

Uh oh!

(Widget) Quick Launch

Quick Launch Widget

Widget Options

Popup Options

Screen Modes

Providers

Apps Provider

Calculator Provider

Clipboard History Provider

Currency Provider

Web Search Provider

Window Switcher Provider

Bookmarks Provider

System Commands Provider

Settings Provider

Kill Process Provider

Port Viewer Provider

File Search Provider

Backends

Unit Converter Provider

Emoji Provider

Color Provider

Snippets Provider

World Clock Provider

Hacker News Provider

Developer Tools Provider

IP / Network Info Provider

VSCode Provider

Provider Prefixes Reference

Example Minimal Configuration enabling just the apps provider

Example Configuration enabling multiple providers

Description of Options

Example Style

Preview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!