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.
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 & MediaREADME.md
OriginalWesper
An open-source, privacy-respecting, ad-free Hi-Fi music client.
Bring your own source — powered by any Eclipse-compatible addon.
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:
- Deploy (or pick) an addon — see the Eclipse addon docs, e.g. a TIDAL or Qobuz addon
- Open Settings → Eclipse Addon
- Paste the addon's URL and click Install
- Test the connection, then search and play
Usage
Basic usage
- Open the app (live instance or your local build)
- Search for artists, albums, or tracks
- Hit play to start streaming
- 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:
- Open the Profile section
- Sign in with Discord or email
- 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.