Wayve is an Android music detection app that helps you build and manage your music library by capturing songs from multiple sources. Never lose track of that song you heard again.
https://docs.google.com/forms/d/e/1FAIpQLSeJ6BW47heqKr9msmCuFhl6YEsOSjRJjatIZ6WT2XUx1bBINA/viewform
- Shazam Integration: Tap to identify any song playing around you
- Continuous Monitoring: Auto-detect songs in the background
- Album Art: Automatically fetches cover art from iTunes/Shazam
- Import your Now Playing history (Pixel exclusive feature)
- JSON import/export support
- Automatic capture via accessibility service
- Beautiful Material 3 design with dynamic theming
- Swipe-to-delete tracks
- Search and filter by title, artist, or album
- Sort by time, artist, or album with smart grouping
- Auto-play: Launch songs in YouTube, Spotify, YT Music, or YT Revanced
- Track duplicates and unique songs/artists
- Total playtime calculations
- Most played songs detection
- Real-time statistics
- OAuth 2.0 with PKCE (secure authentication)
- Export library to Spotify playlists
- One-click playlist creation
- Import playlists directly from Spotify
- Import public YouTube playlists
- Supports full URLs and playlist IDs
- Batch import with progress tracking
- Automatic metadata extraction
- Language: Kotlin
- UI: Jetpack Compose + Material 3
- Architecture: MVVM with ViewModels
- APIs:
- Shazam (via RapidAPI) for music recognition
- iTunes Search API for album art backfill
- Spotify Web API for playlist creation and import
- YouTube Data API v3 for playlist import
- Storage: SharedPreferences + DataStore
- Dependencies: OkHttp, Coil (image loading), Spotify Android Auth SDK
- Android Studio (latest version)
- Android device/emulator running API 24+
- Shazam API Key (free 500 requests/month from RapidAPI)
- YouTube API Key (optional, for playlist import)
- Spotify Developer Account (optional, for playlist export/import)
- Clone the repository
git clone <repository-url>
cd wayve-
Open in Android Studio
-
Configure APIs in the app:
- Shazam: Settings → Shazam API Settings → Enter your RapidAPI key
- YouTube: Settings → YouTube Settings → Enter your API key
- Spotify: Settings → Spotify Settings → Enter Client ID & Secret
-
Build and run!
- Sign up at RapidAPI Shazam
- Subscribe to the free tier (500 requests/month)
- Copy your API key
- Open Wayve → Settings → Shazam API Settings
- Paste your API key and save
- Create an app at Spotify Developer Dashboard
- Add redirect URI:
wayve://spotify-callback - Copy Client ID and Client Secret
- Open Wayve → Settings → Spotify Settings
- Enter credentials and authenticate
- Create a project at Google Cloud Console
- Enable YouTube Data API v3
- Create an API key in Credentials
- Open Wayve → Settings → YouTube Settings
- Enter your API key and save
- Discover: Identify songs at cafés, parties, or on the radio
- Track: Build a history of all music you've encountered
- Import: Bring in your playlists from Spotify and YouTube
- Organize: Sort and search your music library
- Export: Create Spotify playlists from your discoveries
- Analyze: See your listening patterns and most detected songs
- All data is stored locally on your device
- No cloud sync or external servers (except API calls)
- API keys are stored securely in encrypted SharedPreferences
- OAuth tokens are kept local and never shared
This project is for personal use.
This is a personal project, but feel free to fork and customize for your own use!
Made with ❤️ for music lovers