Modus/mine/assets/Plugin.md

Launcher Plugins Documentation

This document provides comprehensive usage information for all available launcher plugins.

Table of Contents

• Application (default)
• Bookmark (bm)
• Calculator (calc)
• Clipboard (clip)
• Emoji (em)
• Google Lens (lens)
• Color Picker (color)
• Google Search (gg)
• YouTube Search (yt)
• Link Opener (lk)
• OTP (otp)
• Password (pass)
• Power Menu (pm)
• Power Profile (power)
• Caffeine (caff)
• Reminder (rem)
• ScreenCapture (sc)
• Todo (todo)
• Tmux (tmux)
• Wallpaper (wall)
• Window Switcher (win)
• SSH Manager (ssh)
• Network Manager (net)
• Bluetooth (bt)

---

Application (default)

Launch desktop applications with fuzzy search.

Usage

application_name

Examples

• firefox — Launch Firefox
• code — Launch VS Code
• terminal — Launch terminal

Features

• Fuzzy search across desktop files
• Smart matching prioritizing exact/common apps

Interactive Features

• Click: launch application
• Enter: launch selected application

---

Bookmark (bm)

Store and manage bookmarks for URLs, file paths, commands, or any text.

Commands

Add Bookmark

bm add name content -description(optional) -tags(optional);

Remove Bookmark

bm remove name;

Update Bookmark

bm update name field new_value;

Fields: content, description, tags

Show Help

bm help

Show Bookmark List

bm add
bm remove
bm update

Interactive Features

• Click: copy content to clipboard
• Shift+Enter: remove bookmark

---

Calculator (calc)

Perform mathematical calculations.

Usage

calc expression

Examples

• calc 2 + 2
• calc sqrt(16)
• calc 100 USD to EUR

Interactive Features

• Click/Enter: execute calculation in terminal

---

Clipboard (clip)

Access and search clipboard history.

Usage

clip [search_term]

Interactive Features

• Click/Enter: copy to clipboard

---

Emoji (em)

Search and insert emojis by name/description.

Usage

em emoji_name

Interactive Features

• Click/Enter: copy selected emoji

---

Google Lens (lens)

Capture a region of the screen and search with Google Lens.

Usage

lens

or

google lens

Behavior

• Activates region selection (slurp)
• Captures screenshot of selected region (grim)
• Uploads image to temporary host
• Opens default browser with Google Lens results

Interactive Features

• Enter: start capture

---

Color Picker (color)

Pick a color and copy as HEX/RGB/HSV.

Usage

color [hex|rgb|hsv]

Examples

• color — Show options
• color hex — Pick HEX
• color rgb — Pick RGB
• color hsv — Pick HSV

Interactive Features

• Click/Enter: start color picking in chosen format

---

Google Search (gg)

Perform Google searches directly.

Usage

gg search_query

Examples

• gg python tutorial
• gg weather today

Behavior

• Opens browser directly (no in-launcher results)

---

YouTube Search (yt)

Perform YouTube searches directly.

Usage

yt search_query

Behavior

• Opens browser directly

---

Link Opener (lk)

Open URLs and links directly.

Usage

lk url_or_domain

Behavior

• Adds https:// if protocol is missing
• Opens in default browser

---

OTP (otp)

Generate and manage TOTP.

Commands

Add OTP Account

otp add account_name qr
otp add account_name secret_key

Remove OTP Account

otp remove account_name

Show Help/List

otp help
otp remove

Interactive Features

• Click: copy OTP code
• Shift+Enter: remove account

---

Password (pass)

Secure passwords with master password protection.

Prompt UX

• If a master password exists and the vault is locked, searching with pass ... or using add/remove/update/list will show an inline prompt.
• Type master password and press Enter (no semicolon). The launcher stays open and the list refreshes.
• Press Enter on empty input to cancel.

Commands

First-Time Setup

On first use (no master password set), typing pass will show an inline prompt to set a master password. Type the password and press Enter. No semicolon is required.

Lock Password Vault

pass lock

Add Password

pass add name username password -website(optional) -notes(optional);

Remove Password

pass remove name;

Update Password

pass update name field new_value;

Fields: username, password

Show Help/List

pass help
pass remove
pass update

Interactive Features

• Click: copy password
• Shift+Enter: remove password

---

Power Menu (pm)

System power actions (shutdown, reboot, etc.).

Usage

pm [option]

External

• pm shutdown, pm reboot, etc. via external toggle

---

Power Profile (power)

Switch system power profiles.

Usage

power [performance|balanced|power-saver]

Behavior

• Shows current profile, switch on Enter/click

---

Caffeine (caff)

Prevent idle/sleep.

Usage

caff [on|off|<duration>]

Examples: caff on, caff 30m, caff 1h, caff 45s, caff 600

---

Reminder (rem)

Schedule reminders with flexible time formats.

Usage

rem [time] [optional message]

Examples: rem 10m, rem 1h30m, rem 21:30, rem 45, rem 10m Take a break

Interactive Features

• Click/Enter: schedule reminder

---

ScreenCapture (sc)

Screenshots and screen recording.

External (no UI)

• sc fs — Fullscreen
• sc region — Region
• sc record — Toggle recording
• sc record mute — Recording muted
• sc stop — Stop recording

---

Todo (todo)

Manage todos with priorities.

Commands

todo add title [-d description] [-p low|medium|high];
todo done title;
todo remove title;
todo edit title field new_value;

• Clear: todo clear
• Help/List: todo help, and todo add|done|remove|edit

Interactive Features

• Click: toggle completion
• Shift+Enter: toggle completion
• Alt+Enter: remove todo

---

Tmux (tmux)

Manage tmux sessions.

Commands

tmux new session_name [directory];
tmux kill session_name;
tmux rename old_name new_name;
tmux terminal terminal_name

• Help/List: tmux help, tmux new|kill|rename|terminal

Interactive Features

• Click: attach to session
• Shift+Enter: kill session

---

Wallpaper (wall)

Browse and set wallpapers.

Usage

wall [search_term]

Interactive Features

• Click/Enter: set wallpaper

---

Window Switcher (win)

Switch between open windows/applications.

Usage

win [window_name]

Interactive Features

• Click/Enter: focus window

---

SSH Manager (ssh)

List and connect to SSH hosts from config/known_hosts.

Commands

• Terminal preference: ssh terminal terminal_name
• Help: ssh help

Interactive Features

• Click/Enter: open terminal & connect
• Shift+Enter: copy ssh command

---

Network Manager (net)

Browse, scan, connect to, and manage NetworkManager Wi‑Fi connections.

Usage

net [connection_prefix] [ifname]

Direct

net connect <ssid> <password> [ifname]
net disconnect [ifname]
net scan [ifname]
net forget <name|uuid>

Prompt UX

• When a password/identity prompt is open, the launcher captures input until Enter (submit) or empty Enter (cancel).

Interactive Features

• Click/Enter on saved network: connect/disconnect
• Click/Enter on access point: connect (prompts if needed)
• Shift+Enter on saved network: forget

---

Bluetooth (bt)

Manage Bluetooth power, scanning, and device connections.

Commands

bt power on;
bt power off;
bt scan start;
bt scan stop;
bt connect Device Name;
bt disconnect Device Name;

• Help/List: bt help, bt

Notes

• Commands with arguments require a trailing semicolon (;).

---

Quick Reference

Plugin	Keyword	What it does / commands	Semicolon Required
Application	—	Application search (default)	No
Bookmark	bm	add, remove, update	Yes
Calculator	calc	Evaluate expressions	No
Clipboard	clip	Clipboard history	No
Emoji	em	Emoji search	No
Google Lens	lens	Capture region and search	No
Google Search	gg	Web search (opens browser)	No
YouTube Search	yt	YouTube search (opens browser)	No
Link Opener	lk	Open URL/domain (adds https://)	No
Color Picker	color	HEX/RGB/HSV	No
OTP	otp	add, remove	No
Password	pass	add, remove, update; auto-prompt for master password when needed	Yes (lock/help/list: No); prompts: No
Power Menu	pm	Power actions (shutdown, reboot, etc.)	No
Power Profile	power	performance, balanced, power-saver	No
Caffeine	caff	on, off, durations (30m, 1h, 45s, 600)	No
Reminder	rem	Flexible times with optional message	No
Todo	todo	add, done, remove, edit, clear	Yes (clear/help/list: No)
Tmux	tmux	new, kill, rename, terminal	Yes (terminal/help/list: No)
Wallpaper	wall	Browse/apply wallpapers	No
Window Switcher	win	Switch between windows	No
SSH Manager	ssh	Hosts, terminal, help	No
Network Manager	net	scan/connect/disconnect/forget; inline password prompt when needed	No
Bluetooth	bt	power on/off, scan start/stop, connect/disconnect	Yes

Notes:

• Inline prompts (Wi‑Fi password, master password) capture input until Enter (submit) or empty Enter (cancel); no semicolon is used in prompts.