A lightweight and modern desktop shelf for Linux (X11) built with GTK3 and Python. It provides a functional taskbar and application launcher with a focus on aesthetics and smooth interaction, specifically optimized for window managers like Openbox and Many WM.
- Modern & Adaptive UI: Features a sleek design with rounded corners and transparent backgrounds that automatically adjust based on your system's light or dark theme.
- Smart Window Management:
- Real-time window list tracking using X11 event monitoring.
- Click to activate/focus or minimize windows.
- Filtered taskbar that excludes system components like desktop backgrounds and panels.
- Dynamic Animations: Smooth button entry effects using configurable easing functions (e.g.,
ease_out_back) for a "pop" feel. - Integrated Launcher: Supports launching applications via commands (like
rofi) or.desktopfiles. - System Status & Clock: Displays a live clock and status icons in a stylized "pill" container.
- WM Optimization: Uses EWMH Struts to reserve screen space, ensuring windows don't overlap with the dock.
sudo pacman -S python-gobject python-xlib gtk3 roboto-fonts
sudo apt install python3-gi python3-xlib gir1.2-gtk-3.0 fonts-roboto
sudo dnf install python3-gobject python3-xlib gtk3 roboto-fonts
Note: Papirus is the recommended icon theme for the best visual experience.
Clone the repository and run the application using Python:
python3 main.py
You can customize the dock by editing config.py. Key settings include:
- Appearance: Adjust
DOCK_HEIGHT,WIDTH_RATIO, andRADIUS_RATIO. - Launcher: Set your preferred launcher command in
LAUNCHER_CMD(defaults torofi). - Animations: Toggle
ANIMATION_ENABLEDor change theANIMATION_EASINGstyle (e.g.,linear,ease_out_quad,ease_out_back). - Colors: Customize the RGBA values for both light and dark modes.
GNU GPL 3.0
