Global Shortcuts on Linux
Use keyboard shortcuts to control BetterStickies from anywhere, even when you're working in another app. On Linux, this takes a quick one-time setup in your desktop settings.
Using the Snap or Flathub version? Global shortcuts aren't available there. Both run in a security sandbox that blocks the connection the helper commands rely on. The AppImage and the native (non-sandboxed) builds support them, so if global shortcuts matter to you, switch to the AppImage from betterstickies.com.
How It Works
BetterStickies listens for commands in the background. Your desktop environment (KDE Plasma, GNOME, etc.) handles the keyboard shortcut and tells BetterStickies what to do. You just need to connect the two.
Available Commands
| Command | What it does |
|---|---|
| Create Note | Opens a new empty note |
| Search | Opens Search Notes, where you can find, preview and open any note |
| Toggle Hide/Show | Hides all notes, or shows them again |
| Quick Capture | Creates a new note with whatever's on your clipboard |
| Show the Hub | Brings the hub back when it's hidden in the tray |
Before You Start
- Make sure BetterStickies is running
- Open Menu > Settings… in BetterStickies and click Configure Global Shortcuts… on the General tab. You'll see the shortcut names listed there for reference
The dialog also has an Open System Settings button that takes you straight to your desktop's shortcut settings.
Setting Up on KDE Plasma
- Open System Settings (or click Open System Settings in the BetterStickies dialog)
- Go to Shortcuts (type "Shortcuts" in the search field if you don't see it)
For each shortcut you want:
- Click Add New > Command or Script…
- In Command, enter the command from the table below, give it a Name (e.g. "BetterStickies - Create Note"), and click Add
- The command now appears under Commands. Select it, click Add…, and press your key combination (e.g. Ctrl+Alt+N)
- Click Apply
These steps are for Plasma 6. On Plasma 5, the same setup lives under Shortcuts > Custom Shortcuts > Edit > New > Global Shortcut > Command/URL.
Commands to Use
| Action | Command |
|---|---|
| Create Note | ~/.config/BetterStickies/betterstickies-cmd.sh create-note |
| Search | ~/.config/BetterStickies/betterstickies-cmd.sh search |
| Toggle Hide/Show | ~/.config/BetterStickies/betterstickies-cmd.sh toggle-hide-show |
| Quick Capture | ~/.config/BetterStickies/betterstickies-cmd.sh quick-capture |
| Show the Hub | ~/.config/BetterStickies/betterstickies-cmd.sh show-hub |
These commands use ~/.config/BetterStickies/, which is where BetterStickies keeps its files on most systems. If you've moved your configuration folder somewhere custom, the helper script lives in that folder under BetterStickies/ instead, so adjust the paths to match.
Write your home folder out in full when you paste a command into your desktop's settings: GNOME runs these commands without a shell, so ~ doesn't work there, and a full path works on every desktop. For example, if your user name is alex, use /home/alex/.config/BetterStickies/betterstickies-cmd.sh create-note. Run echo $HOME in a terminal if you're not sure of your home folder.
Repeat steps 3–6 for each shortcut you'd like to set up. You don't have to add all of them. Pick the ones you'll use.
Setting Up on GNOME
GNOME has custom command shortcuts built in, no extension needed:
- Open Settings > Keyboard
- Click View and Customize Shortcuts, then Custom Shortcuts
- Click Add Shortcut
- Give it a Name, enter the Command, then click Set Shortcut… (the Shortcut row on GNOME 51 and later) and press your key combination. Click Add
Use the full path from Commands to Use, with your home folder written out.
Suggested Key Combinations
These are just suggestions. Use whatever feels natural to you:
| Action | Suggested shortcut |
|---|---|
| Create Note | Ctrl+Alt+N |
| Search | Ctrl+Alt+S |
| Toggle Hide/Show | Ctrl+Alt+H |
| Quick Capture | Ctrl+Alt+V |
Troubleshooting
Shortcuts aren't working
- Is BetterStickies running? The shortcuts only work while the app is open (it can be in the system tray)
- Try running the command directly in a terminal to check:
~/.config/BetterStickies/betterstickies-cmd.sh create-note - If you see "command not found", restart BetterStickies: it creates the helper file on startup
- If you see "No D-Bus command-line tool found", install your distribution's GLib tools package, which provides
gdbus. Most desktops already have it
The helper file is missing
BetterStickies creates it automatically at ~/.config/BetterStickies/betterstickies-cmd.sh when it starts, and keeps it up to date. If your copy is older (say, a command like show-hub answers "Usage: …"), restarting the app refreshes it too. If it's not there, restart the app. You can also check by opening a terminal and running:
ls ~/.config/BetterStickies/betterstickies-cmd.sh
If you use a custom configuration folder, look in that folder under BetterStickies/ instead. And if you installed from the Snap Store or Flathub, global shortcuts aren't supported in those sandboxed versions (see the note at the top of this page): the Snap never gets the file at all, and while the Flathub build does place a copy inside its own private configuration folder (~/.var/app/com.betterstickies.BetterStickies/config/BetterStickies/), running it from outside the sandbox isn't supported.
Quick Capture isn't pasting anything
Quick Capture grabs whatever is currently on your clipboard. If the clipboard is empty, it just creates a blank note instead.
See Also
- Keyboard Shortcuts: full list of in-app and global shortcuts
- Getting Started: overview of the app and basic usage
- Search Notes: find and jump to any note
- Troubleshooting: help with common issues
