A Macbook Touch Bar daemon with enhanced features including Hyprland integration, expandable menus, and keyboard backlight control.
- Hyprland Integration: Context-aware buttons that change based on active window/application
- Expandable Menus: Multi-level navigation with customizable button groups
- Custom Commands: Define unlimited custom commands and actions
- Required kernel modules for T2:
apple-bce,hid-appletb-kbd,hid-appletb-bl
Use the provided installation script:
./install-tiny-dfr.shThe script will:
- Install required dependencies
- Build from source
- Configure systemd service
- Set up user environment
- Apply default configuration
Configuration files are located in /etc/tiny-dfr/:
See share/tiny-dfr/config.toml for examples
Define custom commands:
- Command_[Name]: Named commands
See share/tiny-dfr/commands.toml for examples
Multi-level menu configurations:
- Expand_[Name]: Named Expandables
See share/tiny-dfr/expandables.toml for examples
Application-specific button layouts:
- Class-based configurations: Different buttons per application
- Dynamic context switching: Buttons change based on active window
See share/tiny-dfr/hyprland.toml for examples
The daemon supports keyboard backlight control on the following device paths:
/sys/class/leds/:white:kbd_backlight/sys/class/leds/smc::kbd_backlight- Generic detection: Any device in
/sys/class/leds/containing "kbd" or "keyboard"
The system automatically detects available keyboard backlight devices and provides hardware-level brightness control with configurable step sizes.
Check what keyboard backlight devices exist on your system:
ls -la /sys/class/leds/ | grep -i kbd
# or
find /sys/class/leds/ -name "*kbd*" -o -name "*keyboard*"