Sonic-TTE is a high-octane, event-driven animated screensaver for your terminal. Designed for the Arch & Hyprland communities, it transforms your current music playback into a living ASCII art performance.
- 🚀 Event-Driven: Monitors music playback via
playerctlwith near-zero latency. - 📐 Smart Resizing: Automatically adapts to terminal window resizing (
SIGWINCH) without breaking the animation. - 🔒 Secure & Robust: Multi-user safe (via user-specific temp files) and features a secure configuration parser.
- 🎨 Fully Customizable: Support for any FIGlet font and fine-grained control over animation effects.
- 🔌 Agnostic: Works with Spotify, Firefox, VLC, and any player supporting the MPRIS spec.
Install directly from the AUR using your favorite helper:
# Using paru (Recommended)
paru -S sonic-tte-git
# Using yay
yay -S sonic-tte-gitIf installing manually, ensure you have:
playerctl(Media monitoring)figlet(ASCII generation)python-terminaltexteffects(The engine)
Want to add Sonic-TTE to your Omarchy dash? It's easy!
- Open the Omarchy Menu (
SUPER+ALT+SPACE). - Navigate to 'Install' ➔ 'TUI'.
- Name:
Sonic TTE. - Command:
sonic-tte. - Window Type: Choose either
floatingortilingwindow type! Either will work. - Icon URL: Use your own favorite icon URL (e.g. from Flaticon).
- Enjoy! ✨
Sonic-TTE follows the XDG standard. Custom settings live in:
~/.config/sonic-tte/config
| Variable | Description | Default |
|---|---|---|
PLAYER |
Target a specific player (e.g. spotify) |
(All) |
WRAP_WIDTH |
Chars per line before wrapping | 20 |
POLL_INTERVAL |
Delay when nothing is playing (sec) | 2 |
INCLUDE_EFFECTS |
Space-separated list of effects | (All) |
EXCLUDE_EFFECTS |
Effects to skip | (None) |
FONT_PATH |
Path to your favorite FIGlet .flf font |
(Bundled) |
| Key | Action |
|---|---|
[SPACE] |
Skip current animation & roll a new one |
[Q] |
Graceful Exit |
Created with ❤️ for aesthetic terminal enthusiasts. Part of the Omarchy & Arch + Hyprland communities.