Configuration
Keybindings
Interface with the desktop shell over IPC using fabric-cli commands.
caffyne shell deliberately delegates keyboard layout and shortcut assignments to your host window manager or compositor. Applets and menus are toggled smoothly via an Inter-Process Communication (IPC) layer using fabric-cli.
IPC Syntax Example
Here is how you can map shell toggles using Niri syntax configurations:
config.kdl
Mod+Space { spawn "fabric-cli" "exec" "caffyne-shell" "bar_manager.toggle('Dash')"; }
Mod+S { spawn "fabric-cli" "exec" "caffyne-shell" "bar_manager.toggle('Settings')"; }
Mod+N { spawn "fabric-cli" "exec" "caffyne-shell" "bar_manager.toggle('Notifications')"; }
Mod+T { spawn "fabric-cli" "exec" "caffyne-shell" "bar_manager.toggle('Themes')"; }
Available Applets
Pass any of the following identifier handles explicitly into bar_manager.toggle('<Page/Applet>') to control component actions:
Dash
Page
Launches the dashboard on app overview
Applets
Page
Selection of individual applet components via drag-and-drop.
Wallpapers
Page
Brings up the wallpaper selection interface.
Themes
Page
Lets you customize the desktop interface.
Launcher
Applet
Launches the searchable desktop application selector overlay.
Settings
Applet
Spawns the quick settings utility control interface dashboard.
Notifications
Applet
Reveals your timeline history database for active alerts.
Clock
Applet
Visualizes a real-time system clock layout utility widget.
Calendar
Applet
Expands into an interactive dashboard calendar tracker.
Weather
Applet
Pulls real-time climate telemetry updates for local regions.
Media
Applet
Direct interface engine with
playerctl for media controls.Volume
Applet
Manages your sound architecture and pulse/audio mixers.
Wifi
Applet
Interactive connection panel for network managing protocols.
Bluetooth
Applet
Scans, syncs, and drops connected bluetooth devices.
Energy
Applet
Shows battery consumption and idle power settings.
Session
Applet
Triggers immediate system logout, lock, reboot, or poweroffs.
Calculator
Applet
Spawns a swift algebraic computing overlay helper tool.
Keyboard
Applet
Allows on-the-fly cycling through global layout languages.
Processes
Applet
Pulls resource usage metrics for active tasks via
psutil.