{"id":28427208,"url":"https://github.com/fulygon/spotify-proxy","last_synced_at":"2026-06-20T18:31:00.670Z","repository":{"id":289802573,"uuid":"972165825","full_name":"FuLygon/spotify-proxy","owner":"FuLygon","description":"Reverse proxy for Spotify API","archived":false,"fork":false,"pushed_at":"2025-04-29T09:47:00.000Z","size":55,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-03T23:33:56.218Z","etag":null,"topics":["reverse-proxy","spotify-api"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/FuLygon.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-24T16:28:42.000Z","updated_at":"2025-04-29T09:46:57.000Z","dependencies_parsed_at":"2025-07-03T23:42:01.373Z","dependency_job_id":null,"html_url":"https://github.com/FuLygon/spotify-proxy","commit_stats":null,"previous_names":["fulygon/spotify-proxy"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/FuLygon/spotify-proxy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FuLygon%2Fspotify-proxy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FuLygon%2Fspotify-proxy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FuLygon%2Fspotify-proxy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FuLygon%2Fspotify-proxy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FuLygon","download_url":"https://codeload.github.com/FuLygon/spotify-proxy/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FuLygon%2Fspotify-proxy/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34581934,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-20T02:00:06.407Z","response_time":98,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["reverse-proxy","spotify-api"],"created_at":"2025-06-05T12:09:43.841Z","updated_at":"2026-06-20T18:31:00.655Z","avatar_url":"https://github.com/FuLygon.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Reverse proxy for Spotify API\n\n[![Publish to GitHub Container Registry](https://github.com/FuLygon/spotify-proxy/actions/workflows/publish-package.yaml/badge.svg)](https://github.com/FuLygon/spotify-proxy/actions/workflows/publish-package.yaml)\n\nInitially made this to use with my private fork of [NowPlaying for Spotify](https://github.com/busybox11/NowPlaying-for-Spotify) and my [Homepage](https://github.com/gethomepage/homepage) dashboard.\n\n## Usage and Configuration\n\n### Docker Installation\n\n- Prepare and setting up the `.env` file:\n\n```bash\nwget https://raw.githubusercontent.com/fulygon/spotify-proxy/main/.env.example -O .env\n```\n\n- Optional, prepare and setting up the `routes.yaml` file:\n\n```bash\nwget https://raw.githubusercontent.com/fulygon/spotify-proxy/main/routes.example.yaml -O routes.yaml\n```\n\n- Then deploy the service. Compose file example:\n\n```yaml\nservices:\n  spotify-proxy:\n    image: ghcr.io/fulygon/spotify-proxy:latest\n    container_name: spotify-proxy\n    env_file: .env\n    ports:\n      # Access server port\n      - 8000:8000\n      # Proxy server port\n      - 8001:8001\n    # Optional, only if you already configured routes.yaml\n    volumes:\n      - ./routes.yaml:/app/routes.yaml\n```\n\n### Source Installation\n\nMake sure [Go](https://go.dev/doc/install) is installed.\n\n- Clone the repo:\n\n```bash\ngit clone https://github.com/FuLygon/spotify-proxy.git\ncd spotify-proxy\n```\n\n- Prepare and setting up the `.env` file:\n\n```bash\ncp .env.example .env\n```\n\n- Optional, prepare and setting up the `routes.yaml` file:\n\n```bash\ncp routes.example.yaml routes.yaml\n```\n\n- Then build and run:\n\n```bash\ngo build -o spotify-proxy ./cmd/main.go\n./spotify-proxy\n```\n\n### Post Installation\n\nThe service runs on two ports by default:\n\n- **8000**: Access port, where you can access the authentication API, should not be exposed to the public.\n- **8001**: Reverse proxy port, all your requests to Spotify API will be proxied through this port.\n\nOn service startup, you will need to access http://127.0.0.1:8001 to log in, so the service can get and cache your refresh token, if the service is restarted, you will need to log in again.\n\nIf you set your refresh token in the `.env`file, then you're no longer need to log in. If you don't know how to get the refresh token, you can set `SPOTIFY_REFRESH_TOKEN_OUTPUT`, then access the login page, after logged in successfully, the refresh token will be printed to the service console. You can then set it in the `.env` file and restart the service.\n\nBy default, the proxy server will forward all routes to Spotify API (https://api.spotify.com), you can specify which routes to forward in the `routes.yaml` file.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffulygon%2Fspotify-proxy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffulygon%2Fspotify-proxy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffulygon%2Fspotify-proxy/lists"}