danvics/soulsync
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1

Add Docker OAuth workaround instructions to README

Browse source 
Added a section explaining how to complete Spotify OAuth authentication when accessing SoulSync remotely via Docker. This provides a workaround for Spotify's redirect URI restrictions and guides users through the necessary steps.
This commit is contained in:
Broque Thomas 2025-09-13 09:41:56 -07:00
parent 19583a2d28
commit ab125c48ac
1 changed files with 13 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

13
README.md
View file

@ -118,6 +118,19 @@ docker run -d -p 8008:8008 boulderbadgedad/soulsync:latest
``` ```
- Uses separate database from GUI/WebUI versions - Uses separate database from GUI/WebUI versions
### Docker OAuth Fix (Remote Access)
If accessing SoulSync from a different machine than where it's running:
1. Set your Spotify callback URL to `http://127.0.0.1:8888/callback`
2. Open SoulSync settings and click authenticate
3. Complete Spotify authorization - you'll be redirected to `http://127.0.0.1:8888/callback?code=SOME_CODE_HERE`
4. If the page fails to load, edit the URL to use your actual SoulSync IP:
- Change: `http://127.0.0.1:8888/callback?code=SOME_CODE_HERE`
- To: `http://192.168.1.5:8888/callback?code=SOME_CODE_HERE`
5. Press Enter and authentication should complete
**Note**: Spotify only allows `127.0.0.1` as a local redirect URI, hence this workaround. You may need to repeat this process after rebuilding containers.
## 🎯 Core Features ## 🎯 Core Features
**Search & Download**: Manual track search with preview streaming **Search & Download**: Manual track search with preview streaming