The Command Palette provides keyboard-driven access to all major TagQt features. Press Ctrl+K to instantly search and execute commands without navigating menus.
Opening the Palette Keyboard Shortcut:
Press Ctrl+K from anywhere in TagQt
The palette appears centered over the main window
A search field is immediately focused
Using the Palette Searching Commands
Type any part of a command name
Results filter in real-time
Matching is case-insensitive
Commands show their keyboard shortcuts (if available)
Executing Commands With Keyboard:
Up / Down arrows to navigate resultsEnter to execute the selected commandEscape to close without executing
With Mouse:
Click any command to execute it
Hover highlights the command
Closing the Palette
Press Escape at any time
Click outside the palette window
Execute a command (palette closes automatically)
Available Commands The Command Palette includes all major TagQt operations:
File Management Command Shortcut Description Open Folder Ctrl+OBrowse and load a music folder Save Changes Ctrl+SSave metadata to current file(s)
Batch Operations Command Description Get Covers (All) Fetch album artwork for all visible files Get Lyrics (All) Fetch lyrics for all visible files Rename Files Batch rename files based on metadata Auto-Tag (All) Fetch metadata from MusicBrainz for all files Romanize Lyrics Convert non-Latin lyrics to romanized text Resize Covers Batch resize cover art to standard dimensions
File Actions Command Description Re-encode FLAC Re-encode FLAC files with optimal settings
View & Navigation Command Shortcut Description Exit Global Edit EscapeLeave Global Edit Mode Toggle Theme - Switch between dark and light themes
Help Command Description Hints & Tips Display usage tips and format info About TagQt Show version and credits
Palette Appearance Design
Width: 500px fixedPosition: Centered, 100px from top of main windowStyle: Frameless popup with rounded cornersBackground: Matches current theme (Surface0)
Command Display Each command shows:
[Command Name] [Keyboard Shortcut]
Example:
Save Changes Ctrl+S Get Covers (All) Toggle Theme
Theme Integration The palette adapts to your active theme:
Dark Theme:
Background: Dark surface color
Text: White
Selection: Pink accent
Hover: Subtle gray
Light Theme:
Background: Light surface color
Text: Dark gray
Selection: Pink accent (adjusted)
Hover: Subtle gray
Command Registration Commands are registered in main.py during initialization:
self .command_palette.register_commands([ { "name" : "Open Folder" , "shortcut" : "Ctrl+O" , "callback" : self .open_folder_dialog}, { "name" : "Save Changes" , "shortcut" : "Ctrl+S" , "callback" : self .save_metadata}, # ... more commands ])
Each command has:
name: Display text for the commandshortcut: Keyboard shortcut (optional, shown in palette)callback: Function to execute
Keyboard Navigation The palette is fully keyboard-accessible:
Key Action Ctrl+KOpen palette EscapeClose palette UpMove selection up DownMove selection down EnterExecute selected command Any text Filter commands
Context-Aware Behavior Batch Operations Commands like “Get Covers (All)” behave differently based on context:
Global Edit Mode Active:
Processes only selected files
Useful for targeted batch operations
Normal Mode:
Processes all visible files
Respects current filter settings
Conditional Commands Some commands may show warnings if:
No files are loaded
No files are selected (when required)
Dependencies are missing (e.g., ffmpeg for FLAC re-encode)
Workflow Examples Quick Save 1. Press Ctrl+K 2. Type "save" (filters to "Save Changes") 3. Press Enter 4. Metadata is saved
Batch Fetch Covers 1. Filter files by album name 2. Press Ctrl+K 3. Type "covers" 4. Select "Get Covers (All)" 5. Press Enter 6. Covers are fetched for filtered files
Toggle Theme 1. Press Ctrl+K 2. Type "theme" 3. Press Enter 4. Theme switches instantly
Implementation Details
Uses Qt’s Qt.Popup window flag
Frameless design for modern appearance
Modal behavior (blocks main window interaction)
Auto-centers on show
Filtering Logic
Case-insensitive substring matching
Matches against command names only
First match is automatically selected
Empty search shows all commands
Instant command execution
No noticeable delay on filter
Smooth keyboard navigation
Commands execute in main thread
Tips The Command Palette is the fastest way to execute batch operations. Instead of navigating through multiple menu levels, just press Ctrl+K and type a few letters.
Some commands require dependencies (like ffmpeg or koroman). If a dependency is missing, you’ll see an error dialog after executing the command.
Advantages
Speed: No mouse movement requiredDiscovery: See all available commands at onceShortcuts: Displays keyboard shortcuts for learningFiltering: Find commands by partial name
Browsing features
Right-click context actions
Accessing submenus (like View By)
Keyboard Shortcuts Full list of keyboard shortcuts
Global Edit Mode Batch editing multiple files
Batch Operations All batch processing features
Themes Toggle theme from palette
