skills.rest
reason-machines
reason-machinesOFFICIAL
Explore all skills by this author →
Website𝕏@reasonmachinesGitHub

cliamp-terminal-music-player

Configure and control cliamp terminal music player for local files, streams, and media servers.

4|Updated May 16, 2026
Search Tags:#Spotify#audio streaming#navidrome#cliamp#terminal music player#lua plugins#ipc control
One-click install
npx skills add https://github.com/reason-machines/devtools-skills --skill cliamp-terminal-music-player-reason-machines
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cliamp-terminal-music-player
Source: https://github.com/reason-machines/devtools-skills/tree/main/skills/cliamp-terminal-music-player
Command: npx skills add https://github.com/reason-machines/devtools-skills --skill cliamp-terminal-music-player-reason-machines

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Playing and managing music from the terminal across local files, streaming services, and self-hosted media servers requires juggling multiple tools and configurations, which this Skill consolidates into one guided workflow. ## Core Features & Use Cases - Playback & Integration Setup: Install cliamp and connect it to Spotify, YouTube Music, SoundCloud, Navidrome, Plex, and Jellyfin through the interactive setup wizard and TOML configuration. - Remote Control & Automation: Use IPC commands in headless daemon mode, MPRIS media key integration, and shell scripts for playlist rotation and status bar widgets. - Lua Plugin Development: Write custom visualizers and audio effects using the Lua plugin API with drawing and event hooks. - Use Case: A developer wants to stream their Navidrome library in the terminal with a spectrum visualizer, control playback via media keys, and display the current track in a polybar status bar. ## Quick Start Ask the assistant to install cliamp and configure it to stream music from your Navidrome server with the spectrum visualizer enabled.

Frequently Asked Questions about cliamp-terminal-music-player

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I play music in the terminal with cliamp?▼

Install cliamp via the install script, Homebrew, AUR, or from source with Go, then run cliamp followed by a directory, files, or stream URL. It supports MP3, FLAC, WAV, OGG, AAC, ALAC, Opus, and WMA formats.

How to connect cliamp to Spotify or Navidrome?▼

Run the cliamp setup wizard, which validates connections and writes configuration to ~/.config/cliamp/config.toml. Spotify uses an OAuth flow requiring a Premium account, while Navidrome needs the server URL, username, and password.

Does cliamp support YouTube and SoundCloud playback?▼

Yes, cliamp plays YouTube, YouTube Music, SoundCloud, Bandcamp, Bilibili, and NetEase Cloud Music through the optional yt-dlp dependency. YouTube Music additionally requires browser cookies configured in config.toml.

Why is there no audio output from cliamp on Linux?▼

Silence on Linux usually means the ALSA bridge is missing for PipeWire or PulseAudio. Install pipewire-alsa or pulseaudio-alsa using your distribution's package manager to restore audio output.

Can I control cliamp from scripts or media keys?▼

Yes, run cliamp in headless daemon mode and send IPC commands like play, pause, next, volume, and status from other terminals or scripts. Enabling MPRIS in the config allows control via media keys and playerctl.

How do I write Lua plugins for cliamp?▼

Create a plugin directory under ~/.config/cliamp/plugins containing a plugin.lua file that implements hooks like on_audio_frame and on_track_change. Enable the plugin by name in the plugins section of config.toml.

Related Skills

Explore More Software Engineering Skills→
AradotsoAradotso
4

cliamp-terminal-music-player

Configure cliamp for terminal music playback with local and streaming providers.

Official
Intermediate
mattstyles333mattstyles333

spotify

Controls Spotify playback on macOS via AppleScript.

Community
Basic
vibecodevibecode
1

yt-dlp

Download videos, audio, and playlists from YouTube and other websites using yt-dlp.

Official
Intermediate
llm011llm011
9

computer-use

Controls macOS desktop interfaces via screenshots and simulated mouse/keyboard actions.

Official
Intermediate