skills.rest
Aradotso
AradotsoOFFICIAL
Explore all skills by this author →
Website𝕏@aradotsoGitHub

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
One-click install
npx skills add https://github.com/Aradotso/devtools-skills --skill cliamp-terminal-music-player
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
silva2kandsilva2kand

spotify-player

Control Spotify playback and search music from the terminal.

Community
Intermediate
RlierRlier
1

spotify-player

Control Spotify playback and search tracks from the terminal.

Community
Intermediate
ad-repoad-repo
108

subsonic-integration

Connect Subsonic/Navidrome servers for streaming, browsing, and scrobbling with token authentication.

Community
Advanced
guoqiaoguoqiao

dl

Download videos and music from YouTube and Bilibili URLs into organized directories.

Community
Intermediate