{"id":27213400,"url":"https://github.com/trimpsuz/spotify-widget","last_synced_at":"2026-05-05T21:33:07.909Z","repository":{"id":285645437,"uuid":"958202590","full_name":"Trimpsuz/spotify-widget","owner":"Trimpsuz","description":"Discord-style widget for Spotify","archived":false,"fork":false,"pushed_at":"2025-04-09T12:17:13.000Z","size":285,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-09T13:26:19.316Z","etag":null,"topics":["bun","hono","spotify","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Trimpsuz.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}},"created_at":"2025-03-31T20:10:37.000Z","updated_at":"2025-04-09T12:17:17.000Z","dependencies_parsed_at":"2025-04-01T23:22:30.238Z","dependency_job_id":"8277e1b8-3a53-4bf6-8fae-8f21f43e29ff","html_url":"https://github.com/Trimpsuz/spotify-widget","commit_stats":null,"previous_names":["trimpsuz/spotify-widget"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Trimpsuz%2Fspotify-widget","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Trimpsuz%2Fspotify-widget/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Trimpsuz%2Fspotify-widget/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Trimpsuz%2Fspotify-widget/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Trimpsuz","download_url":"https://codeload.github.com/Trimpsuz/spotify-widget/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248144892,"owners_count":21055005,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["bun","hono","spotify","typescript"],"created_at":"2025-04-10T02:40:58.774Z","updated_at":"2026-05-05T21:33:07.904Z","avatar_url":"https://github.com/Trimpsuz.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Spotify widget\n\n[![Stars](https://img.shields.io/github/stars/Trimpsuz/spotify-widget?style=flat)](https://github.com/Trimpsuz/spotify-widget/stargazers)\n[![License](https://img.shields.io/badge/License-AGPLv3-purple.svg?label=license)](LICENSE)\n\nDiscord-style widget for Spotify\n\n#\n\n[![](https://spotify.trimpsuz.dev/widget?paused=true\u0026progressBar=true\u0026lastPlayed=true)](https://spotify.trimpsuz.dev/redirect?paused=true\u0026lastPlayed=true\u0026mode=track)\n\n\u003e [!IMPORTANT]\n\u003e Since 9.3.2026 Web API now requires a Spotify Premium subscription.\n\n## Usage\n\n1. Clone the repository\n ```sh\n git clone https://github.com/Trimpsuz/spotify-widget\n ```\n2. Install the dependencies\n ```sh\n bun install\n ```\n3. Visit the **[Spotify developer dashboard](https://developer.spotify.com/dashboard)** and **create a new app**\n4. Set the **redirect URI** to `https://your.domain/callback` and enable the **Web API**\n5. Go to the settings of the app and copy the **Client ID**\n6. Create a file `.env`, and enter the **Client ID**, **Redirect URL** and the port you wish to use as in **[.env.example](.env.example)**\n7. Start the server\n ```sh\n bun start\n ```\n8. Visit the **Spotify OAuth URL** printed to the console and authorize the app\n9. The `/widget` and `/redirect` routes are now accessible\n\n## Query parameters\n\n| Route | Name | Possible values | Description |\n| -------- | ----------- | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| widget | paused | `true`, `false` or missing | If not true, ignores the current track if it is paused |\n| widget | progressBar | `true`, `false` or missing | If true, the progress bar will be shown on the currently playing track. If paused, the progress bar will be static |\n| widget | lastPlayed | `true`, `false` or missing | If true, the last played track will be used when a currenly playing track is not found |\n| redirect | paused | `true`, `false` or missing | If not true, ignores the current song if it is paused. Should be set to the same value as `widget` for expected behaviour |\n| redirect | lastPlayed | `true`, `false` or missing | If true, the last played track will be used when a currenly playing track is not found. Should be set to the same value as `widget` for expected behaviour |\n| redirect | mode | `track`, `artist` or `album` | Defines where the redirect should lead to |\n\n## License\n\n- The project is licensed under AGPL 3.0. See the [LICENSE](LICENSE) file for more details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrimpsuz%2Fspotify-widget","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftrimpsuz%2Fspotify-widget","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrimpsuz%2Fspotify-widget/lists"}