cliamp-terminal-music-player

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

4|Updated May 16, 2026

Search Tags:#audio streaming #playlist management #cliamp #terminal music player #media server integration #lua plugins #music troubleshooting

Ready to run

npx skills add https://github.com/Aradotso/devtools-skills --skill cliamp-terminal-music-player

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: cliamp-terminal-music-player
Source: https://github.com/Aradotso/devtools-skills/tree/main/skills/cliamp-terminal-music-player
Command: npx skills add https://github.com/Aradotso/devtools-skills --skill cliamp-terminal-music-player

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of getting rich music playback and streaming access without leaving your terminal, including configuring multiple providers and troubleshooting playback issues.

Core Features & Use Cases

Terminal-first music playback: Play local audio files and streaming URLs with a retro Winamp-inspired interface.
Remote media integrations: Connect and control libraries from Navidrome, Plex, and Jellyfin.
Streaming-provider support: Set up Spotify, YouTube Music, SoundCloud, Bilibili, and NetEase Cloud Music (with the required tooling).
Personalization and extensibility: Manage playlists, use radio browsing, tune the audio with an EQ, and extend functionality with Lua plugins.
Use Case: Install cliamp, run the setup wizard to authenticate your providers, then play a mixed set of local tracks and stream links with consistent keyboard controls and visual EQ.

Quick Start

Install cliamp and start playing your music directory by running: cliamp ~/Music.

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 local audio files and streams directly in my terminal?▼

Terminal music playback is handled by installing cliamp and passing your local music directory or streaming URL as an argument. It plays local files and streams using a retro Winamp-inspired interface.

Can I connect my terminal music player to Navidrome, Plex, or Jellyfin servers?▼

Yes, terminal music playback supports remote media integrations. You can connect to and control your existing audio libraries hosted on Navidrome, Plex, and Jellyfin media servers directly from your terminal environment.

How do I configure Spotify and YouTube Music providers for terminal audio streaming?▼

You configure Spotify and YouTube Music providers by running the cliamp setup wizard to authenticate your accounts. This generates the required provider configuration in ~/.config/cliamp/config.toml for terminal audio streaming.

Does terminal music playback support playlists, EQ tuning, and plugin extensibility?▼

Terminal music playback supports managing playlists, browsing radio stations, tuning audio with an EQ, and extending functionality with Lua plugins. You can play mixed sets of local tracks and stream links with consistent keyboard controls.

Why is my terminal music player failing to authenticate or play audio?▼

Audio or authentication failures during terminal music playback often stem from incorrect provider configuration in ~/.config/cliamp/config.toml. Re-running the setup wizard to re-authenticate your streaming providers usually resolves these common troubleshooting issues.