Audiomancer CLI

A terminal music player for YouTube — search, stream, and control playback from the command line.

CLINode.jsYouTubempvTerminal

Audiomancer streams audio from YouTube directly in your terminal. No browser, no video, no clutter — just search, play, and control everything with your keyboard.

Prerequisites

Requires yt-dlp and mpv installed and on your PATH.

macOS

brew install yt-dlp mpv

Ubuntu

sudo apt install mpv
pip install -U yt-dlp

Windows (scoop)

scoop install yt-dlp mpv

Installation

npm

npm install -g audiomancer

CLI Commands

play<query>Search YouTube and play the first matching result.

search<query>List matching results without playing anything.

id<url-or-id>Play a specific video by URL or ID.

Usage Examples

shell

# Search and play
adt play lofi hip hop radio

# Browse search results
adt search daft punk

# Play by ID or URL
adt id dQw4w9WgXcQ

Keyboard Controls

Key	Action
`space`	Pause / resume
`→ / ←`	Seek ±10 seconds
`+ / -`	Volume up / down
`q`	Quit

How It Works

yt-dlp searches YouTube and resolves a direct audio stream URL (no file is downloaded). mpv plays that stream with --no-video, exposing an IPC socket for control. The CLI talks to mpv over that socket to pause, seek, and adjust volume live.

architecture

You (terminal) ──→ audiomancer CLI
                        ├── yt-dlp (search + resolve URL)
                        └── mpv (play audio, IPC socket)
                              └── blessed TUI (progress & status)

No audio files are ever downloaded to disk. Everything is streamed in real-time.

Source

Open-source under MIT license. Available on GitHub.