Scripts Reference
All scripts are installed to ~/.local/bin/ and should be in your PATH.
Theme & Appearance
Section titled “Theme & Appearance”theme-set theming essential
Switch the system-wide color theme across all applications
theme-set tokyo-nightbg-next theming
Cycle through wallpaper images for the current theme
bg-nextnightlight-toggle theming
Toggle blue light filter for evening use
nightlight-toggle# Apply a themetheme-set tokyo-night
# List available themestheme-set --listtheme-set -l
# Show current themetheme-set --currenttheme-set -c
# Interactive picker (via fuzzel)theme-set --selecttheme-set -stheme-set # default actionHyprland, Waybar, Foot, Ghostty, Mako, Fuzzel, Swaylock, GTK, Neovim, btop, VSCode/Cursor
Screenshots & Recording
Section titled “Screenshots & Recording”screenshot utility
Capture screenshots using grim and slurp
screenshot regionscreenrecord utility
Record screen video with audio support
screenrecordcapture-menu utility
Interactive capture menu with all screenshot/recording options
capture-menu# Full screenscreenshot
# Select region interactivelyscreenshot region
# Active windowscreenshot windowScreenshots saved to ~/Pictures/Screenshots/ with timestamp filenames.
Keybindings:
Print- Full screenShift + Print- Select regionCtrl + Print- Active window
# Start recordingscreenrecord
# Stop recording (run again or press keybinding)screenrecord stopRecordings saved to ~/Videos/ in WebM format.
Audio & Display
Section titled “Audio & Display”volume utility
Control system audio volume
volume upbrightness utility
Control display brightness
brightness uposd-notify utility
Display on-screen notifications for volume/brightness changes. Called automatically by volume/brightness scripts.
osd-notify volume 75volume up # Increase 5%volume down # Decrease 5%volume mute # Toggle mutevolume get # Show current levelbrightness up # Increase 5%brightness down # Decrease 5%brightness get # Show current levelbrightness set 50 # Set to 50%System Controls
Section titled “System Controls”toggle-idle utility
Toggle idle behavior (screen lock, display off, suspend). Useful when watching videos or presenting.
toggle-idlesystem-menu utility essential
Interactive system control menu. Options: Lock, Logout, Suspend, Reboot, Shutdown.
system-menubattery-status utility
Show battery information (for laptops). Output: percentage, charging status, time remaining.
battery-statuswifi-manager utility
Interactive WiFi network manager
wifi-managerwifi-manager # Show menuwifi-manager select # Choose networkwifi-manager status # Connection statusWindow Management
Section titled “Window Management”window-transparency utility
Adjust window transparency
window-transparency 0.9hyprland-session utility
Session management for Hyprland
hyprland-sessionwindow-transparency 0.9 # 90% opacitywindow-transparency 1.0 # Fully opaqueLaunchers & Menus
Section titled “Launchers & Menus”omfreebdy-menu utility essential
Main system menu with hierarchical submenus
omfreebdy-menukeybindings-show utility
Display all configured keybindings
keybindings-showemoji-picker utility
Search and insert emoji characters
emoji-pickerstart-waybar utility
Start or restart the Waybar status bar
start-waybarSubmenus:
- Apps - Launch applications
- Capture - Screenshot/recording options
- Style - Theme and background selection
- System - Power and session controls
- Settings - WiFi, Bluetooth, Audio, Display
Adding Custom Scripts
Section titled “Adding Custom Scripts”Make sure your scripts are executable and located in ~/.local/bin/ which should be in your PATH.
Create your script
Add a new file in ~/.local/bin/:
#!/bin/sh# ~/.local/bin/my-scriptecho "Hello, omfreebdy!"Make it executable
chmod +x ~/.local/bin/my-scriptBind to a key (optional)
Add a binding in ~/.config/hypr/conf/bindings.conf:
bind = SUPER, M, exec, my-script