Reverbic

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #claude-code #codex #cli #developer-tools #react #windows

★ 73 Open GitHub ↗

Fast terminal radio player for Linux, macOS, Windows, built in Rust. Live radio, Spotify remote, YouTube playback, gaming overlay, and Discord Rich Presence.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

All-in-one terminal player — Radio, Spotify &amp; YouTube, for Windows, macOS and Linux.

<a href="README.md">English</a> |
 <a href="README.es.md">Español</a>

---

## Installation

```bash
# Quick install (Windows)
winget install Sewandev.Reverbic

# Or, via PowerShell script (Windows)
irm https://raw.githubusercontent.com/sewandev/Reverbic/main/install.ps1 | iex

# Quick install (macOS / Linux)
brew install sewandev/reverbic/reverbic

# Package managers
scoop bucket add reverbic https://github.com/sewandev/scoop-reverbic; scoop install reverbic   # Windows (Scoop)
cargo install --git https://github.com/sewandev/Reverbic.git --locked                          # Any OS (Rust)

# Build from source
git clone https://github.com/sewandev/Reverbic.git
cd Reverbic
cargo build --release
./target/release/reverbic
```

> [!TIP]
> Recommended: run Reverbic in [Windows Terminal](https://apps.microsoft.com/detail/9n0dx20hk701?hl) with [PowerShell 7+](https://apps.microsoft.com/detail/9mz1snwt0n5d?hl) for the best visual experience.

> [!WARNING]
> **Windows SmartScreen** may show a warning for unsigned binaries. Click "More info" → "Run anyway".

---

## Features

- **Radio** — Search and play thousands of internet radio stations by name, genre, or country
- **Spotify** — Remote control: search, play, pause, seek, volume, and device transfer (Premium required)
- **YouTube** — Search and stream audio directly from YouTube
- **Lightweight** — ~25 MB RAM and < 1% CPU at idle, starts in under a second
- **Floating overlay** — always on top, with automatic game detection
- **Discord Rich Presence** — shows your current station and track on your profile
- **Favorites & crossfade** — save your favorite stations with smooth crossfade between them
- **Screensaver mode** — clock, station info, and track metadata when idle
- **Headless CLI** — control radio playback from the command line; it keeps running in the background after you close the terminal

> [!NOTE]
> Currently, the **Floating overlay**, **Audio ducking**, **Media Keys**, **System Tray**, **Notifications**, **Discord RPC**, and **Headless CLI** features are exclusive to Windows. We are actively looking for contributors to help port them to macOS and Linux!

> [!NOTE]
> Spotify's 2026 policy changes could restrict native playback (librespot) at any time. Remote Control mode (search and playback control via the official Spotify API) does not depend on librespot and is a reasonable fallback for that risk, though it has its own requirements (your own Spotify Premium account and Developer app). See [LEGAL.md](LEGAL.md) for details.

---

## Command-line control (headless)

> [!NOTE]
> Windows only for now. Radio only — Spotify and YouTube are out of scope.

Control radio playback without keeping the interface open. After installing, run `reverbic` followed by a command; playback runs in a background process that survives closing the terminal.

```bash
reverbic play <station> # start radio in the background (matches favorites first, then searches online)
reverbic play # resume the last played station
reverbic status # show the current station, track, and playback state
reverbic volume <0-100> # set the volume
reverbic toggle # play / pause
reverbic stop # stop and shut down the background player
reverbic # no arguments: open the full interface
```

---

## Documentation

- **[Spotify guide](docs/spotify.md)** — playback modes, Client ID setup, shortcuts, and known limitations
- **[YouTube guide](docs/youtube.md)** — features (Mix, chapters, SponsorBlock), cookies setup, and known limitations
- **[Legal notes](LEGAL.md)** — third-party services, terms of service, and risk disclosures

> [!WARNING]
> If you configure YouTube cookies, **use a secondary ("burner") account** — never your main Google account. Full instructions in the [YouTube guide](docs/youtube.md).

---

## Screenshots

<table align="center">
 <tr>
 <td align="center">
 <img src="assets/spotify.PNG" alt="Spotify remote control" width="380"> 
 Spotify remote control
 </td>
 <td align="center">
 <img src="assets/youtube.PNG" alt="YouTube search" width="380"> 
 YouTube search
 </td>
 <td align="center">
 <img src="assets/Overlay.gif" alt="Gaming overlay" width="380"> 
 Gaming overlay
 </td>
 </tr>
 <tr>
 <td align="center">
 <img src="assets/screensaver.PNG" alt="Screensaver mode" width="380"> 
 Screensaver mode
 </td>
 <td align="center">
 <img src="assets/configs.PNG" alt="Settings" width="380"> 
 Settings
 </td>
 <td align="center">
 <img src="assets/Discord-Rich-Presence.gif" alt="Discord Rich Presence" width="380"> 
 Discord Rich Presence
 </td>
 </tr>
</table>

---

## Changelog

See [CHANGELOG.md](CHANGELOG.md) for release notes and version history. ([Español](CHANGELOG.es.md))

---

## About this project & AI

Reverbic is built in my spare time outside of work. To move fast with limited time, I lean on AI tools throughout development — but the architecture, design choices, and the final review of what ships are mine. Contributions and feedback are always welcome.

---

## Contributors

Reverbic

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README