A smooth, lightweight, and flexible interactive Dynamic Island for Hyprland.

_{English · 简体中文}

Preview · Features · Installation · Configuration · Common Commands

Tide Island is a small desktop widget for Hyprland, styled like the Dynamic Island.

When nothing much is going on, it just sits in the corner, staying out of the way. When you need to check some information, it expands into a panel where you can view lyrics, switch workspaces, adjust system settings, check notifications, or put in some custom content.

It's built with Quickshell, QML, and C++/Qt 6. Most of the effort went into making the animations as smooth as possible, interactions responsive, and resource usage kept in check. I can't claim it's anything special, but I hope it's comfortable to use.

Clock Mode	System Notifications
Control Center	Music Player
Bluetooth Connection Status	Workspace Overview
Lyrics	Custom Page

Tide Island can display temporary feedback for:

• Volume changes
• Brightness changes
• Battery charging / discharging
• Workspace changes
• Media playback
• System notifications

The custom page can display:

• Time
• Date
• Battery
• Volume
• Brightness
• Workspace
• CPU
• RAM
• CAVA audio visualizer

Memory: <300 Mb

CPU usage: < 1 during normal use

Performance may vary depending on enabled modules, lyrics providers, animations, and system configuration.

Install from the AUR:

yay -S tide-island

Or build manually:

git clone https://github.com/enhaoswen/Tide-island.git
cd Tide-island
makepkg -si

Clone the repository and run the installer:

git clone https://github.com/enhaoswen/Tide-island.git
cd Tide-island
./scripts/install-debian-ubuntu.sh

Tide Island provides a systemd user service.

Enable and start it immediately:

systemctl --user enable --now tide-island

If you want to manage startup manually, add this to your hyprland.conf:

exec-once = tide-island

Or add this to hyprland.lua:

hl.exec_once("tide-island")

If the systemd service is already enabled, you do not need to add exec-once.

systemctl --user restart tide-island

systemctl --user stop tide-island

journalctl --user -u tide-island -f

tide-island-setup --check

tide-island-setup --launch

tide-island-setup --wizard

you can adjust configuration to your liking in ~/.config/tide-island/userconfig.json.

You can also change the key binding.

Example:

"dynamicIslandPrimaryButton": 1,
"dynamicIslandPrimaryAction": "toggleExpandedPlayer",
"dynamicIslandSecondaryButton": 3,
"dynamicIslandSecondaryAction": "toggleControlCenter"

1 = Left click, 2 = Middle click, 3 = Right click

Not required, you can adjust based on your preferences.

Shortcuts for ~/.config/hypr/hyprland.conf.

bind = $mainMod, right, exec, qs ipc -p /usr/share/tide-island call tide showLyrics
bind = $mainMod, left,  exec, qs ipc -p /usr/share/tide-island call tide showCustom
bind = $mainMod, down,  exec, qs ipc -p /usr/share/tide-island call tide showClock
bind = $mainMod, M, exec, qs ipc -p /usr/share/tide-island call tide togglePlayer
bind = $mainMod, C, exec, qs ipc -p /usr/share/tide-island call tide toggleControlCenter

Shortcuts for ~/.config/hypr/hyprland.lua.

hyprland.bind("SUPER", "right", "exec", "qs ipc -p /usr/share/tide-island call tide showLyrics")
hyprland.bind("SUPER", "left",  "exec", "qs ipc -p /usr/share/tide-island call tide showCustom")
hyprland.bind("SUPER", "down",  "exec", "qs ipc -p /usr/share/tide-island call tide showClock")
hyprland.bind("SUPER", "M", "exec", "qs ipc -p /usr/share/tide-island call tide togglePlayer")
hyprland.bind("SUPER", "C", "exec", "qs ipc -p /usr/share/tide-island call tide toggleControlCenter")

The default user configuration file is located at:

~/.config/tide-island/userconfig.json

After editing the configuration, restart the service:

systemctl --user restart tide-island

• Hyprland
• Quickshell
• Qt 6
• hyprctl
• wpctl
• brightnessctl
• pactl
• dbus-monitor
• UPower
• BlueZ
• libudev

• NetworkManager or iwd for Wi-Fi integration
• A Nerd Font for icons
• CAVA for audio visualization
• MPRIS-compatible music player for media integration

Check logs:

journalctl --user -u tide-island -f

Make sure Hyprland, Quickshell, and required command-line tools are installed.

Check whether your player exposes MPRIS:

busctl --user list | grep -i mpris

Make sure the relevant services are running:

systemctl status NetworkManager
systemctl status bluetooth

Issues, bug reports, design suggestions, and pull requests are all welcome.

Thanks to:

• @end-4 for the workspace overview design inspiration
• @gozhuimeng for improving the lyrics backend

• Discord: https://discord.gg/gEmqgz76
• Email: enhaoswen@gmail.com

_{Made for Hyprland users who like quiet and practical desktops.}