Music streaming
from your terminal.

v1.0.0 · MCP ready

Search, play, and download songs from multiple sources — no browser, no ads, no distractions. Just your music and your shell.

Download Install $ tuisic --mcp-server
6
Music sources
12
Features
C++
Built with
MCP
AI integration
/ features

Everything you need, nothing you don't.

A streamlined terminal experience built for speed, focused on what matters — the music.

>

Vim motions

Navigate your library with familiar keyboard bindings. No mouse needed.

>

No ads

Zero advertisements, zero tracking. Pure, uninterrupted music.

>

Easy downloads

Download songs directly to your machine with a single keystroke.

>

Playlists

Create and manage playlists. Save favourites for quick access.

>

Daemon mode

Run in the background. Control playback without keeping the TUI open.

>

MPRIS DBUS

Integrates with your desktop via playerctl for system-wide media control.

>

CAVA visualizer

Real-time audio visualizer built directly into the terminal interface.

>

Discord RPC

Show what you're listening to on your Discord profile in real time.

>

Lyrics

Fetch and display synced lyrics for whatever's playing.

/ sources

Aggregated from across the web.

Pulls music from multiple platforms so you're never stuck searching for a song.

JioSaavn SoundCloud LastFM ForestFM YouTube YouTube Music
/ shortcuts

Keyboard-first by design.

Every action has a binding. Stay in the flow without lifting your hands.

qQuit
wToggle daemon
SpacePlay / Pause
Alt+lCopy URL
>Next song
<Previous song
dDownload
aAdd to favourites
.Seek forward
,Seek backward
mMute
LToggle lyrics
/ install

Get started in seconds.

Available on every major platform. Choose your OS below.

# Quick install (Linux / macOS / WSL) $ curl -fsSL https://raw.githubusercontent.com/Dark-Kernel/tuisic/master/install.sh | sh
# AppImage — portable, no deps needed $ curl -fsSL https://github.com/Dark-Kernel/tuisic/releases/latest/download/tuisic-linux-x64.AppImage -o tuisic $ chmod +x tuisic && ./tuisic
# AUR (Arch Linux) — recommended $ yay -S tuisic-git
# Debian / Ubuntu — build deps $ sudo apt-get install build-essential cmake pkg-config libfftw3-dev libmpv-dev libcurl4-openssl-dev libfmt-dev libsystemd-dev rapidjson-dev libpulse-dev
# Build from source $ git clone https://github.com/Dark-Kernel/tuisic.git $ cd tuisic $ mkdir build && cd build $ cmake .. -DCMAKE_BUILD_TYPE=Release $ make -j$(nproc) $ sudo make install
# Install dependencies $ brew install cmake pkg-config fftw mpv curl fmt rapidjson # Build from source $ git clone https://github.com/Dark-Kernel/tuisic.git $ cd tuisic $ mkdir build && cd build $ export PKG_CONFIG_PATH="$(brew --prefix)/lib/pkgconfig" $ cmake .. -DCMAKE_BUILD_TYPE=Release -DWITH_MPRIS=OFF $ make -j$(sysctl -n hw.ncpu) $ sudo make install
# Install WSL (Ubuntu) then run: $ sudo apt-get update $ sudo apt-get install build-essential cmake pkg-config libfftw3-dev libmpv-dev libcurl4-openssl-dev libfmt-dev rapidjson-dev libpulse-dev # Build from source $ git clone https://github.com/Dark-Kernel/tuisic.git $ cd tuisic $ mkdir build && cd build $ cmake .. -DCMAKE_BUILD_TYPE=Release -DWITH_MPRIS=OFF $ make -j$(nproc) $ sudo make install
/ mcp

AI-native integration

tuisic ships with a built-in MCP (Model Context Protocol) server. AI assistants can control playback, search songs, and manage your queue through natural language.

  • Search and play songs via chat
  • Control playback hands-free
  • Manage playlists and queue
  • Works with any MCP-compatible client
opencode.json 
{
  "tuisic": {
    "type": "local",
    "command": [
      "/path/to/tuisic",
      "--mcp-server"
    ],
    "enabled": true
  }
}