Skip to content
Projects

itsmeadarsh2008/wesper has 26 GitHub stars and 2 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-19 21:18 UTC. Last push 2026-10-21.

How these counts are measured

Measured star growth

in 24h
0
in 7 days
Collecting history
in 15 days
Collecting history
in 1 month
Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

An open-source, privacy-respecting, ad-free Hi-Fi music client. Bring your own source — powered by any Eclipse-compatible addon.

Creative & Media

README.md

Original

Wesper Logo

Wesper

An open-source, privacy-respecting, ad-free Hi-Fi music client.
Bring your own source — powered by any Eclipse-compatible addon.

Live instance GitHub stars GitHub forks GitHub issues License Last commit Discord

About • Features • Quick Start • Usage • Self-Hosting • Contributing • Discord


What is Wesper?

Wesper is an ancient music app reimagined as a bring-your-own-source music client. It ships with no music provider built in and no hard-coded API. Instead, it is a fully Eclipse-compatible app — any addon that speaks the Eclipse addon protocol becomes your stream source.

You deploy (or pick) an addon — a self-hostable server or Cloudflare Worker that provides search, streaming, and catalog endpoints for services such as TIDAL and Qobuz. Paste one addon URL in Settings → Eclipse Addon and the app does the rest. Switch addons any time — no account lock-in, no vendor tie-in.

Why bring your own source?

Wesper never decides what you listen to — you do.

  • Your data, your rules. No built-in tracking, no ads, no third-party analytics.
  • Any Eclipse addon works. TIDAL, Qobuz, self-hosted servers, or your own Cloudflare Worker.
  • Switch freely. Swap providers in seconds; playlists and library stay intact.

Privacy is opt-in. The app itself never tracks you. The only thing that exposes anything about you is the optional account system used for cross-device sync — and that's entirely your choice. If you do create an account, your username/profile becomes searchable by other users, so only sign up if you're comfortable with that.

All wrapped in a clean, minimalist interface for streaming high-quality music without the clutter of traditional platforms.


Features

Audio Quality

  • Hi-Res / lossless streaming with real stream quality shown in the player (bit depth, sample rate, container format reported by the addon)
  • Adaptive streaming (DASH/HLS) plus progressive streaming for regular files
  • Rate-limit-aware request queue with automatic 429 retry and a priority lane for playback
  • Local music file support
  • Intelligent API caching for faster, smoother playback

Interface

  • Modern, minimalist glassmorphism UI
  • Customizable themes and fonts (Google Fonts via the CoolLabs proxy, URLs, or uploads)
  • Accurate, unique audio visualizer
  • Karaoke lyrics with haptic sync
  • Offline-capable Progressive Web App (PWA)
  • Media Session API integration for system controls
  • Keyboard shortcuts for power users

Library & Organization

  • Recently Played history tracking
  • Comprehensive personal library for favorites
  • Queue management with shuffle, repeat, and gapless playback
  • Playlist import from other platforms
  • Public playlists for social sharing
  • Smart recommendations for new songs, albums & artists
  • Unreleased music tracking

Lyrics & Metadata

  • Full lyrics support with karaoke mode
  • Genius integration for lyrics

Integrations

  • Account system for cross-device syncing (powered by Appwrite)
  • Last.fm, ListenBrainz, Maloja, and LibreFM scrobbling
  • Eclipse-compatible addon backend — bring your own stream source

Download

  • High-quality downloads (including DASH manifest resolution)
  • Bulk album / playlist downloads with custom filename templates

Quick Start

1. Use the live instance

# Just open it in your browser
https://wesper.appwrite.network

2. Install an addon

Wesper needs an Eclipse addon for search and streaming:

  1. Deploy (or pick) an addon — see the Eclipse addon docs, e.g. a TIDAL or Qobuz addon
  2. Open Settings → Eclipse Addon
  3. Paste the addon's URL and click Install
  4. Test the connection, then search and play

Usage

Basic usage

  1. Open the app (live instance or your local build)
  2. Search for artists, albums, or tracks
  3. Hit play to start streaming
  4. Use the player to manage playback, queue, and volume

Keyboard shortcuts

Shortcut Action
Space Play / Pause
→ Next track
← Previous track
↑ Volume up
↓ Volume down
M Mute / Unmute
L Toggle lyrics
F Fullscreen
/ Focus search

Accounts

To sync your library, history, and playlists across devices:

  1. Open the Profile section
  2. Sign in with Discord or email
  3. Your data syncs automatically

Self-Hosting

Note: Accounts won't work on self-hosted instances.

Docker (recommended)

git clone https://github.com/itsmeadarsh2008/wesper.git
cd wesper
docker compose up -d

See docs/DOCKER.md for the full Docker guide.


Contributing

Contributions are welcome! Read docs/CONTRIBUTE.md to get started.

Made with passion for music. No ads. No tracking. Just your source.