nosignal/NoSignal-OS
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
NoSignal-OS/os updates/cliamp-music/README.md
28allday 19fd794b6b NoSignal — fully-offline Arch → Hyprland desktop installer 
Single-script builder (nosignal.sh) that turns a stock Arch Linux ISO into a
fully-offline installer for a themed Hyprland + caelestia (Quickshell) desktop:
matching SDDM greeter, Btrfs/Limine bootable snapshots, chwd-style GPU
detection, and a curated "os updates" layer (keybind cheatsheet, settings
panels, system polish, on-box management skill). See README.md.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-21 11:03:10 +01:00

2.6 KiB
Executable file
Raw Permalink Blame History

cliamp-music — CLIAmp as the default music player

Adds a default music player — NoSignal previously had none.

What

CLIAmp — "a retro terminal music player inspired by Winamp 2.x" — is what Omarchy ships for terminal music (their omarchy-launch-or-focus-tui cliamp bind), and it is prebuilt in the [omarchy] pacman repo NoSignal already carries (v1.57.0 at time of writing; deps pull in ffmpeg and yt-dlp).

  • Package: cliamp from [omarchy] (repo install, no AUR build).
  • Default player: cliamp.desktop (launches in kitty, class cliamp) + xdg-mime default for 12 common audio types, mirroring the style of omarchy's install/config/mimetypes.sh (which sets no audio defaults itself). Opening an audio file anywhere now starts CLIAmp.
  • Keybind: Super+M → launch-or-focus CLIAmp, floating 1100×700 (same shape as the other NoSignal TUI tools). Before this change both Super+M and Super+Shift+M toggled the shell's music panel (an MPRIS controller, not a player); the panel keeps Super+Shift+M. Launch-or-focus is inlined (hyprctl dispatch focuswindow … || kitty …) since NoSignal does not ship omarchy's helper — note hyprctl exits 0 even when no window matches, so the check greps for ok.
  • Keymap doc: Super+M row updated (the Super+K cheatsheet regenerates from it on next open).

Files

File Role
install-cliamp-music.sh idempotent installer — package (sudo), desktop entry, MIME defaults, marked bind block, keymap doc row
cliamp.desktop desktop entry: kitty --class cliamp -e cliamp %F + audio MimeType list
hyprland-cliamp.conf # >>> cliamp music player >>> marked block (float rules + Super+M), appended to hypr-user.conf

Packaging

  • Add cliamp to the package list (from [omarchy]).
  • Bake the desktop entry, the MIME defaults (skeleton ~/.config/mimeapps.list), the marked block (verbatim, markers included — the installer greps for it), and the keymap doc row.

Test

  1. Super+M → CLIAmp opens floating; Super+M again focuses it (no second instance). Super+Shift+M still toggles the music panel.
  2. Open an .mp3/.flac from the file manager → opens in CLIAmp.
  3. xdg-mime query default audio/mpeg → cliamp.desktop.
  4. Super+K lists Super+M Music player — CLIAmp….

Notes

cliamp 1.57.0-1 installed; audio/mpeg and audio/flac default to cliamp.desktop; runtime binds confirm Super+M → launch-or-focus CLIAmp and Super+Shift+M → music panel; keymap doc row present.