OpenSound is an open-source desktop music streaming application inspired by Spotify. It allows you to listen to music freely and instantly using public YouTube sources with an intelligent fallback system.
⚠️ Disclaimer : This application does not store or host any musical content. It only redirects to public streams available on YouTube. Respect copyright.
npm start- Node.js 20.0.0 or higher
- npm or pnpm
- yt-dlp (automatically installed)
- Multi-sources : Piped API → Invidious → yt-dlp direct
- Smart fallback : Automatic switching between sources
- Intelligent cache : Cached results for optimal performance
- Advanced filters : Search by title, artist, album
- Direct streaming : YouTube audio URLs via ytdl-core + yt-dlp
- Audio quality : Best available audio format (128-320 kbps)
- Smart buffering : Preloading for smooth playback
- Streaming cache : Cached URLs to avoid re-requests
- Spotify-inspired design : Familiar and intuitive interface
- Responsive : Desktop/tablet adaptation
- Themes : Light/dark mode
- Smooth animations : Transitions and micro-interactions
- Playlists : Create and manage custom playlists
- Favorites : Save preferred tracks
- History : View recent listens
- Recommendations : Suggestions based on listening habits
- Frontend : React 18 + TypeScript + Vite
- Backend : Electron (Node.js 20+) + TypeScript
- Styling : TailwindCSS + shadcn/ui
- Audio : Web Audio API + ytdl-core + yt-dlp
OpenSound/
├── src/
│ ├── main/ # Main Electron process
│ │ ├── services/ # Business services (YouTube, Spotify, etc.)
│ │ ├── ipc/ # IPC handlers
│ │ └── preload.ts # Preload script
│ ├── renderer/ # React application
│ │ ├── src/
│ │ │ ├── components/ # UI components
│ │ │ ├── pages/ # Pages (Library, Search, etc.)
│ │ │ └── hooks/ # React hooks
│ └── shared/ # Shared types
├── dist/ # Build compilation
└── package.json # Dependencies
- Multi-layer search : Piped API → Invidious → yt-dlp direct
- Robust streaming : ytdl-core + fallback yt-dlp
- Intelligent cache : Search (10min) + Streaming (5min)
- Error management : Automatic fallbacks
- Playback control : play/pause/seek/volume
- Smart buffering : Preloading for smooth playback
- Network error management : Automatic reconnection
- Multi-level : Search + Streaming
- Size limitation : 100MB maximum
- Configurable TTL : Automatic expiration
- No hosting : No content stored on our servers
- Public sources : Official YouTube APIs
- Direct streaming : Playback from YouTube servers
- Copyright respect : Personal use only
- No tracking : No user data collected
- Open source : Transparent and verifiable code
- No telemetry : No telemetry
- Local only : Everything works locally
Lavalink (Java) → Audio streaming
⬇️
Issues : Java required, heavy, complex maintenance
Piped/Invidious/yt-dlp → Direct audio streaming
⬇️
Advantages : Lightweight, fast, no Java, more reliable
- 🚀 Performance : 3x faster startup
- 💰 Costs : No server required
- 🔧 Maintenance : Easier to maintain
- 🌐 Reliability : Multiple fallback sources
- Before : ~15 seconds (Lavalink)
- After : ~5 seconds (YouTube direct)
- Latency : <2 seconds
- Results : 15-20 tracks per search
- Cache hit : ~80% (reuses)
- Playback start : <1 second
- Quality : 128-320 kbps
- Buffer : 5-10 seconds preloaded
- Advanced playlists : Sharing, collaboration
- AI recommendations : Suggestion algorithms
- Offline mode : Downloads for offline listening
- Podcasts : YouTube podcasts support
- Mobile : iOS/Android version (React Native)
- Cloud sync : Multi-device synchronization
- Public API : Third-party developer API
- Extensions : Browser, mobile extensions
- Multi-sources : SoundCloud, Bandcamp, etc.
- Social : Social sharing, profiles
- Live : Live streaming
# Development mode
npm run dev
# Production build
npm run build
# Tests
npm test
# Lint
npm run lint
# Cache cleanup
npm run clean# Environment variables
cp .env.example .env
# Edit .env with your keys
nano .envWe appreciate contributions! Here's how you can help:
- Fork the repository
- Create a branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
- Follow ESLint/Prettier code conventions
- Add tests for new features
- Document changes in CHANGELOG.md
This project is licensed under MIT - see the LICENSE file for more details.
- React - Frontend framework
- Electron - Desktop framework
- yt-dlp - YouTube extractor
- ytdl-core - YouTube streaming
- TailwindCSS - CSS framework
- shadcn/ui - UI components
- Issues : GitHub Issues
- Discussions : GitHub Discussions
- Wiki : Documentation
🎵 OpenSound - Free, unlimited, privacy-respecting music
