soundcloud-tui 0.3.11

soundcloud-tui-0.3.11 is not a library.

English

A distraction-free, keyboard-centric terminal SoundCloud & audio stream player designed natively for Linux. Rewritten entirely in Rust with the signature aesthetic of @ttype: clean transparent typography, conveyor-tape progress bars, non-blocking audio engine via mpv, and instant search.

Features

Clean & Transparent Aesthetic: Zero clunky borders or heavy frameworks. Blends directly into your terminal background and color scheme.
Native Linux Architecture: High-performance Rust backend using asynchronous mpv IPC sockets for instant playback and minimal memory footprint.
SoundCloud + Fallback Search: Instant track search powered by yt-dlp, with direct URL streaming support (tracks, playlists, or YouTube fallbacks).
Interactive Player Tape: Center-aligned progress conveyor tape with customizable visual styles (tape, minimal, blocky).
Views & History:
- F1 / Search: Fast inline query or direct SoundCloud track/playlist link.
- F2 / Queue: On-the-fly queue management (add, reorder, delete).
- F3 / Favorites: One-key liking (l) with persistent local storage.
- F4 / History: Automatic playback history tracking.
- F5 / Settings: On-the-fly theme switcher (catppuccin, tokyo night, nord, gruvbox, dracula, amber, white, auto).
Zero Python/Venv Headache: Single standalone static binary.

Requirements

mpv
yt-dlp

Install on Arch Linux:

sudo pacman -S mpv yt-dlp

Install on Debian/Ubuntu:

sudo apt install mpv yt-dlp

Installation

Prebuilt Binary (Instant Install — No Rust Compilation)

# Direct single-binary install to ~/.local/bin:
mkdir -p ~/.local/bin && curl -fLo ~/.local/bin/sctui https://github.com/laguser/soundcloud-tui/releases/latest/download/sctui && chmod +x ~/.local/bin/sctui

Pacman / Arch Linux (Direct `.pkg.tar.zst` Install — No AUR/Rust needed)

sudo pacman -U https://github.com/laguser/soundcloud-tui/releases/latest/download/sctui-bin-x86_64.pkg.tar.zst

(Optional) Or add sctui as a custom Pacman repository in /etc/pacman.conf to install with sudo pacman -S sctui-bin:

[sctui]
SigLevel = Optional TrustAll
Server = https://github.com/laguser/soundcloud-tui/releases/latest/download

Via Cargo (Recommended)

cargo install soundcloud-tui

From Source

Requires Rust (cargo):

git clone https://github.com/laguser/soundcloud-tui.git
cd soundcloud-tui
cargo build --release
install -m 755 target/release/sctui ~/.local/bin/

Keybindings

Key	Action
`space`	Play / Pause playback
`n` / `p`	Next / Previous track in queue
`a`	Add highlighted track to Queue
`d`	Remove track from Queue / Favorites
`l`	Like / unlike current track (add to Favorites)
`s`	Toggle Shuffle
`r`	Cycle Repeat (Off ➔ All ➔ One)
`y`	Synchronized Lyrics karaoke view
`S`	Sync personal SoundCloud library (likes & playlists)
`←` / `→` (or `b` / `f`)	Seek -5s / +5s
`+` / `-`	Volume up / down
`i` or `/`	Focus search bar
`tab`	Cycle views (`search` ➔ `queue` ➔ `favorites` ➔ `history` ➔ `settings` ➔ `lyrics`)
`f1` - `f6`	Jump directly to view
`esc`	Clear search / Back to search screen
`esc esc` / `ctrl+c`	Exit

Desktop Integration (MPRIS2 & Caelestia Shell)

sctui natively registers as an MPRIS2 D-Bus media player (org.mpris.MediaPlayer2.soundcloud-tui). This provides seamless real-time integration with:

Caelestia Shell & Waybar media widgets
System media keys (XF86AudioPlay, XF86AudioNext, etc.)
Notification popups with album artwork, title, artist, and duration

Русский

Минималистичный терминальный SoundCloud плеер под Linux, полностью переписанный на Rust в стиле @ttype. Без тяжёлых фреймворков, без venv и зависимостей Python — быстрый запуск, чистый прозрачный TUI интерфейс, стриминг аудио через легковесный mpv IPC сокет, синхронизированные караоке-тексты песен и поддержка системных медиа-виджетов (Caelestia Shell, Waybar, MPRIS2).

Особенности

Стиль и эстетика @ttype: Чистый интерфейс с прозрачным фоном, адаптирующийся под цвета терминала, кастомный бегущий прогресс-бар (лента).
MPRIS2 D-Bus интеграция: Полная привязка к Caelestia Shell, Waybar и медиа-клавишам системы (отображение обложек, названий, управление воспроизведением).
Синхронизированные слова песен (Караоке): Нажмите y для открытия экрана синхронизированных текстов (LRCLIB API) с плавной подсветкой текущей строки.
Синхронизация библиотеки SoundCloud: Введите oauth_token в ~/.config/soundcloud-tui/config.json и нажимайте S для автоматической загрузки ваших лайков и плейлистов.
Полноценно под Linux: Построен на Rust с асинхронным сокетом mpv — мгновенный отклик, никакой нагрузки на процессор и память.
Поиск SoundCloud и прямые ссылки: Быстрый поиск через yt-dlp, поддержка вставки прямых ссылок на треки/плейлисты SoundCloud, а также резервный поиск.

Системные требования

mpv (для воспроизведения аудио)
yt-dlp (для извлечения аудиопотоков)

Установка в Arch Linux:

sudo pacman -S mpv yt-dlp

Установка

Готовый бинарник (Мгновенная установка без компиляции Rust):

# Прямая установка бинарника в ~/.local/bin за 1 секунду:
mkdir -p ~/.local/bin && curl -fLo ~/.local/bin/sctui https://github.com/laguser/soundcloud-tui/releases/latest/download/sctui && chmod +x ~/.local/bin/sctui

Через Pacman / Arch Linux (Прямая установка `.pkg.tar.zst` без AUR и Rust):

sudo pacman -U https://github.com/laguser/soundcloud-tui/releases/latest/download/sctui-bin-x86_64.pkg.tar.zst

(Опционально) Или добавьте репозиторий в /etc/pacman.conf, чтобы ставить через sudo pacman -S sctui-bin:

[sctui]
SigLevel = Optional TrustAll
Server = https://github.com/laguser/soundcloud-tui/releases/latest/download

Через Cargo:

cargo install soundcloud-tui

Сборка из исходников:

git clone https://github.com/laguser/soundcloud-tui.git
cd soundcloud-tui
cargo build --release
install -m 755 target/release/sctui ~/.local/bin/

Запуск:

sctui