soundcloud-tui 0.2.0

soundcloud-tui-0.2.0 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

Quick One-Liner (Build & Install)

curl -sSL https://raw.githubusercontent.com/laguser/soundcloud-tui/main/install.sh | bash

From Source

Requires Rust (cargo):

git clone https://github.com/laguser/soundcloud-tui.git
cd soundcloud-tui
cargo build --release
cp 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)
`←` / `→` (or `b` / `f`)	Seek -5s / +5s
`+` / `-`	Volume up / down
`i` or `/`	Focus search bar
`tab`	Cycle views (`search` ➔ `queue` ➔ `favorites` ➔ `history` ➔ `settings`)
`f1` - `f5`	Jump directly to view
`esc`	Clear search / Back to search screen
`esc esc` / `ctrl+c`	Exit

Русский

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

Особенности

Стиль и эстетика @ttype: Чистый интерфейс с прозрачным фоном, адаптирующийся под цвета терминала, кастомный бегущий прогресс-бар (лента).
Полноценно под Linux: Построен на Rust с асинхронным сокетом mpv — мгновенный отклик, никакой нагрузки на процессор и память.
Поиск SoundCloud и прямые ссылки: Быстрый поиск через yt-dlp, поддержка вставки прямых ссылок на треки/плейлисты SoundCloud, а также резервный поиск.
Очередь и Избранное:
- F1 / Поиск: ввод запроса или ссылки.
- F2 / Очередь: добавление треков в очередь нажатием a, удаление клавишей d.
- F3 / Избранное: сохранение любимых треков клавишей l.
- F4 / История: история прослушиваний с датами.
- F5 / Настройки: смена тем (auto, catppuccin, tokyo night, nord, gruvbox, dracula, amber) и стилей ленты.
Двойной Esc: Умный выход по двойному нажатию Esc, как в ttype.

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

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

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

sudo pacman -S mpv yt-dlp

Установка

Быстрая установка одной командой:

curl -sSL https://raw.githubusercontent.com/laguser/soundcloud-tui/main/install.sh | bash

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

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

Запуск:

sctui