28allday
19fd794b6b
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>
57 lines
2.6 KiB
Markdown
Executable file
57 lines
2.6 KiB
Markdown
Executable file
# cliamp-music — CLIAmp as the default music player
|
||
|
||
Adds a default music player — NoSignal previously had none.
|
||
|
||
## What
|
||
|
||
[CLIAmp](https://github.com/search?q=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.
|