mirror of
https://github.com/cstaelen/shazarr.git
synced 2026-10-19 01:31:11 -05:00
dependabot[bot]
9f29a1d4d4
Bumps [node](https://github.com/aredridel/node-bin-gen) from 25.9.0 to 26.0.0. - [Commits](https://github.com/aredridel/node-bin-gen/commits) --- updated-dependencies: - dependency-name: node dependency-version: 26.0.0 dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] <support@github.com>
Shazarr - Unofficial Shazam mobile app web UI
Shazarr project is a mobile app (android, ios) providing Shazam song recognition service with Lidarr and Tidarr integration.
Features
- Audio microphone capture and song recognition using reverse Shazam API with node-shazam-api.
- Download discovered album with Lidarr, auto-search via API (with browser fallback if no API key)
- Download discovered track or album with Tidarr, search Tidal content in-app, pick the album, queue track or full album download, or with Tidarr 1.2.1 or higher, add track to Tidal favorites
- Add custom search service
- Listen on streaming app Spotify, Apple Music and Deezer
- Show lyrics
- Offline mode : record and recognize later (if network down)
- Records history
- Privacy: No login, no tracking, no API key
Screenshots
Get started
- Android: ✅ APK Download APK here
- iOS: ⚠️ build app from Xcode ONLY (needs xcode and paired device)
Get last release :
App options (fit with your data)
- Lidarr URL :
http://<lidarr-web-ui-url> - Tidarr URL:
http://<tidarr-web-ui-url> - Custom service URL:
http://<service-url>?query= - Custom service name:
My custom music service
iOS ( /!\ source build only )
Requirements: pnpm, xcode.
- Git clone project first
- in project folder run:
cd docker-shazarr
pnpm run ios:build
XCode should open project.
- Pair your iOS device
- build the app.
- After few secs, it should be installed on your ipad/iphone.
Roadmap
- Android app
- Record history: access last shazamed songs
- Offline record: record without API access, recognize song later
- Update notifications
- iOS app: find a way to distribute packaged app without using app store and without have to clone and build it
Development
- Android + iOS mobile app (ReactJS + Ionic/Capacitor)
Watch mode
Start app in watch mode :
pnpm run start # Listening on http://localhost:3000/
pnpm run android:live # Listening on http://localhost:8100/ + emulate
pnpm run ios:live # Listening on http://localhost:8100/ + emulate
Build
Build APK with Android studio:
pnpm run android:build
Build ios app with Xcode:
make ios/build
Support
If you like this project you can support here:
Credits
- Big thanks to the node-shazam-api team for the awesome works and reactivness 👏💪🙏
- UI inspiration : https://github.com/codrops/ShazamButtonEffect
- See Lidarr project: https://github.com/linuxserver/docker-lidarr
- See Tidarr project: https://github.com/cstaelen/tidarr