hrkfdn/ncspot
Ncspot
ncspot is a terminal-based music player that streams audio from a Spotify Premium account, combining a text-based user interface with Vim-style keyboard navigation for browsing and playing music libraries. It functions as an interactive Spotify client that can also accept remote commands over an IPC socket, enabling headless or scripted playback control without direct user interaction.
The player is designed for efficient keyboard-driven operation, using modal keybindings inspired by Vim to navigate tracks, albums, playlists, and genres. It supports lightweight music streaming suitable for low-power or headless systems, with a local SQLite cache for offline browsing and fast search. The interface is fully configurable through a TOML-based theme and layout system, allowing users to customize colors, borders, and spacing.
For automation and integration, ncspot exposes a Unix domain socket that accepts JSON-formatted commands to control playback, queue management, and volume from external processes or scripts. The application communicates with Spotify's servers using the librespot library for authentication and audio streaming, decoding Ogg Vorbis streams to output PCM audio through the system's audio device.
Features
- Spotify Controllers - An interactive terminal-based music player that streams audio from a Spotify Premium account.
- JSON IPC Controllers - Sends remote commands over an IPC socket to control music playback without direct interaction.
- Modal Input Systems - Implements a modal input handler mapping keyboard sequences to player actions with configurable keymaps.
- Vim-Style Application Keybindings - Uses Vim-style keybindings to navigate and control the music player interface efficiently.
- Vim-Style - A music player controlled entirely through Vim-inspired keybindings for navigation and playback management.
- Spotify Connect Implementations - Communicates with Spotify servers using the librespot library for authentication and audio streaming.
- Unix Socket Interfaces - Exposes a Unix domain socket that accepts JSON commands for external playback control.
- Terminal Rendering Engines - Renders a full-screen terminal UI using crossterm with direct framebuffer writes and event-driven redraws.
- Spotify Client Libraries - Streams music from a Spotify premium account using a lightweight library with minimal resource footprint.
- Lightweight Music Streaming Clients - Streams Spotify music with minimal resource usage, suitable for low-power or headless systems.
- Metadata Caches - Persists Spotify metadata in a local SQLite cache for offline browsing and fast search.
- Stream Decoding - Decodes Ogg Vorbis audio streams from Spotify into PCM data for system audio output.
- TOML-Based Theme Definitions - Ships a fully configurable TOML-based theme and layout system for customizing terminal UI appearance.
- Media Streaming - Terminal-based music streaming client written in Rust.
- Music and Audio - Cross-platform terminal-based Spotify client.
- Music Players - Cross-platform ncurses Spotify client.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
