TUISIC

TUI Online Music Streaming application with MCP support

https://github.com/user-attachments/assets/ef349a06-0d7e-488b-aa3d-de928d9b0eef

First app of its kind, It let's you search and play online songs from cli hassle free. Now it supports AI integration through MCP (BETA). Checkout Demo's below

Features

• Vim motions
• No browser, No Ads
• Easy downloads
• Multiple song sources
• Playlist support
• Easy Sharing
• Favourites List
• Configuration file
• Daemon mode (BETA, press 'w' to toggle)
• MPRIS DBUS support ( via playerctl )
• Cava Visualizer (BETA)
• Support for AI Integration via MCP (BETA)
• Support for Discord Rich Presence
• Lyrics support (BETA)

Shortcuts

| Key | Action | | --- | --- | | q | quit | | w | toggle daemon mode | | > | next song | | < | previous song | | <space> | play/pause | | Alt+l | copy url | | d | download song | | a | add to favourites | | . | seek forward | | , | seek backward | | m | mute | | L | Toggle lyrics |

Sources

It fetches songs from some platforms:

• JioSaavn
• SoundCloud
• LastFM
• ForestFM
• YouTube
• YouTube Music (on the way)

Installation:

1. Check releases

2. Using AUR package

yay -S tuisic-git

Building from source

Build Options

| CMake Flag | Description | Default | | ---------------- | --------------------------------- | ------- | | -DWITH_MPRIS | Enable MPRIS (sdbus-c++) support | ON | | -DWITH_CAVA | Enable Cavacore-based visualizer | OFF | | -DWITH_DISCORD | Enable Discord Rich Presence | OFF |

Before Installation

Update the desktop/tuisic.desktop file.

Exec=alacritty -e tuisic # Change terminal accordingly

Debian

1. Install dependencies

sudo apt-get update
sudo apt-get install -y build-essential cmake pkg-config libfftw3-dev libmpv-dev libcurl4-openssl-dev libfmt-dev libsystemd-dev rapidjson-dev libpulse-dev

2. If you want to use MPRIS then install sdbus-cpp

git clone --depth 1 https://github.com/Kistler-Group/sdbus-cpp.git
cd sdbus-cpp
mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
cmake --build .
sudo cmake --build . --target install

3. Build

cmake .. -DCMAKE_BUILD_TYPE=Release
cmake --build . --config Release -j$(nproc 2>/dev/null || sysctl -n hw.ncpu 2>/dev/null || echo 2)

Arch Linux

1. Install dependencies

sudo pacman -S curl mpv fmt yt-dlp fftw sdbus-cpp rapidjson

2. Build

cmake .. -DCMAKE_BUILD_TYPE=Release
cmake --build . --config Release -j$(nproc 2>/dev/null || sysctl -n hw.ncpu 2>/dev/null || echo 2)

MacOS

1. Install dependencies

brew install cmake pkg-config fftw mpv curl fmt rapidjson

2. Set environment variables for Homebrew paths

# Detect Homebrew prefix (Apple Silicon uses /opt/homebrew, Intel uses /usr/local)
BREW_PREFIX=$(brew --prefix)
export HOMEBREW_PREFIX=${BREW_PREFIX}
export PKG_CONFIG_PATH=${BREW_PREFIX}/lib/pkgconfig:${BREW_PREFIX}/opt/curl/lib/pkgconfig:${BREW_PREFIX}/opt/fmt/lib/pkgconfig
export CMAKE_PREFIX_PATH=${BREW_PREFIX}
export LDFLAGS=-L${BREW_PREFIX}/lib
export CPPFLAGS=-I${BREW_PREFIX}/include

3. Build

cmake .. \
  -DWITH_MPRIS=OFF \
  -DCMAKE_BUILD_TYPE=Release \
  -DCMAKE_PREFIX_PATH="${HOMEBREW_PREFIX}"

cmake --build . --config Release -j$(nproc 2>/dev/null || sysctl -n hw.ncpu 2>/dev/null || echo 2)

MISC Build, Compile & Install

mkdir build && cd build
cmake .. # -DWITH_MPRIS=OFF -DWITH_CAVA=ON
make
su

... [View full README on GitHub](https://github.com/Dark-Kernel/tuisic#readme)