Skip to content

HyDE-Project/hydebar

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation



hydebar

A fast, beautiful Wayland status bar for Hyprland

Packaging status

⚑ Blazing fast β€’ 🎨 Beautiful themes β€’ πŸ”§ Easy configuration


Features

Core Modules

  • πŸͺŸ Workspaces - Hyprland workspace integration
  • πŸ“ Window Title - Active window information
  • ⏰ Clock - Customizable date/time format
  • πŸ“Š System Info - CPU, RAM, temperature, disk, network speeds
  • πŸ”‹ Battery - Battery status and power profiles
  • πŸ“‘ Network - WiFi with signal strength %, VPN, connection management
  • πŸ”Š Audio - Volume control with inline sliders, sink/source selection
  • 🎡 Media Player - MPRIS integration with playback controls
  • πŸ’‘ Brightness - Screen brightness control with inline slider
  • πŸ”΅ Bluetooth - Device management with quick connect/disconnect, battery levels
  • πŸ“‹ Tray - System tray support
  • πŸ”„ Updates - Package update notifications
  • πŸ”’ Privacy - Camera/microphone/screenshare indicators
  • ⌨️ Keyboard Layout - Layout switching with custom labels
  • πŸš€ App Launcher - Quick app launcher button
  • πŸ”” Notifications - Notification center with D-Bus integration, DND mode
  • πŸ“Έ Screenshot - Screenshot and screen recording (grim/slurp/wf-recorder)
  • βš™οΈ Settings Panel - Comprehensive settings menu

Visual Features

  • 🎨 11 Built-in Themes - Catppuccin, Dracula, Nord, Gruvbox, Tokyo Night
  • ✨ Smooth Animations - Menu fade in/out, hover effects
  • 🏝️ Multiple Styles - Islands, Solid, Gradient
  • 🎭 Opacity Control - Transparent backgrounds and menus

Customization

  • πŸ“¦ Custom Modules - Extend with your own scripts
  • 🎨 Full Color Control - Customize every color
  • πŸ“ Flexible Layout - Position modules left/center/right
  • πŸ”„ Hot Reload - Config changes apply instantly

Quick Start

Installation

Arch Linux

# Stable release
paru -S hydebar

# Development version
paru -S hydebar-git

ALT Linux

sudo apt-get install hydebar

Nix

# Stable
nix profile install github:RAprogramm/hydebar?ref=0.6.7

# Latest
nix profile install github:RAprogramm/hydebar

See Installation Guide for more options.

Basic Configuration

Create ~/.config/hydebar/config.toml:

# Use a preset theme
appearance = "catppuccin-mocha"

# Or customize colors
[appearance]
style = "Islands"
opacity = 0.95
background_color = "#1e1e2e"
primary_color = "#cba6f7"
text_color = "#cdd6f4"

# Configure animations
[appearance.animations]
enabled = true
menu_fade_duration_ms = 200

# Module layout
[modules]
left = ["Workspaces"]
center = ["WindowTitle"]
right = [["Privacy", "Notifications", "Screenshot"], "Clock", "Settings"]

Available Themes

# Catppuccin variants
appearance = "catppuccin-mocha"      # Dark purple
appearance = "catppuccin-macchiato"  # Dark blue
appearance = "catppuccin-frappe"     # Lighter purple
appearance = "catppuccin-latte"      # Light theme

# Other popular themes
appearance = "dracula"          # Dark purple/pink
appearance = "nord"             # Cool blue
appearance = "gruvbox-dark"     # Warm retro dark
appearance = "gruvbox-light"    # Warm retro light
appearance = "tokyo-night"      # Dark with neon accents
appearance = "tokyo-night-storm"
appearance = "tokyo-night-light"

Screenshots

Themes

Catppuccin Mocha Dracula
Mocha Dracula

Menus

Settings Panel Power Menu
Settings Power
Network Menu Bluetooth Menu
Network Bluetooth

Documentation


Advanced Configuration

Custom Modules

[[CustomModule]]
name = "CustomNotifications"
icon = ""
command = "swaync-client -t -sw"
listen_cmd = "swaync-client -swb"
icons.'dnd.*' = ""
alert = ".*notification"

System Information

[system]
indicators = ["Cpu", "Memory", "Temperature", {"disk" = "/"}, "DownloadSpeed"]

[system.cpu]
warn_threshold = 60
alert_threshold = 80

Power Management

[settings]
lock_cmd = "hyprlock &"
shutdown_cmd = "shutdown now"
suspend_cmd = "systemctl suspend"
reboot_cmd = "systemctl reboot"
logout_cmd = "loginctl kill-user $(whoami)"

Full configuration reference at docs/configuration.


Performance

  • πŸš€ Fast Startup - < 50ms first paint
  • πŸ’Ύ Low Memory - < 5MB idle
  • ⚑ Efficient - < 1% CPU when idle
  • πŸ¦€ 100% Rust - Memory-safe, zero-cost abstractions

See PERFORMANCE.md for benchmarks.


Development

Building from Source

git clone https://github.com/RAprogramm/hydebar.git
cd hydebar
cargo build --release
./target/release/hydebar-app

Contributing

Contributions are welcome! See CONTRIBUTING.md for detailed guidelines.

Quick links:


Troubleshooting

Graphics Issues

If you experience transparency or rendering issues:

WGPU_BACKEND=gl hydebar

This forces OpenGL instead of Vulkan.

Hyprland-Only Features

Currently relies on hyprland-rs for:

  • Active window information
  • Workspace management
  • Keyboard layout

Support for other compositors is planned but not yet implemented.


Acknowledgements

hydebar evolved from ideas initially explored in the ashell project. The current architecture benefits from those early prototypes.


License

Licensed under the MIT License. See LICENSE for details.


Made with ❀️ for the Hyprland community

Website β€’ Issues β€’ Discussions

About

[Maintainer] https://github.com/RAprogramm

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •  

Languages