{"id":49764799,"url":"https://github.com/icedream/obs-spotify-lyrics","last_synced_at":"2026-05-11T10:24:27.777Z","repository":{"id":353164804,"uuid":"1216523080","full_name":"icedream/obs-spotify-lyrics","owner":"icedream","description":"Render Spotify track lyrics as a stream overlay","archived":false,"fork":false,"pushed_at":"2026-05-04T10:20:46.000Z","size":417,"stargazers_count":0,"open_issues_count":3,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-04T12:29:23.341Z","etag":null,"topics":["lyrics","obs-plugin","spotify"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/icedream.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-21T01:51:02.000Z","updated_at":"2026-05-04T10:20:50.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/icedream/obs-spotify-lyrics","commit_stats":null,"previous_names":["icedream/obs-spotify-lyrics"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/icedream/obs-spotify-lyrics","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/icedream%2Fobs-spotify-lyrics","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/icedream%2Fobs-spotify-lyrics/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/icedream%2Fobs-spotify-lyrics/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/icedream%2Fobs-spotify-lyrics/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/icedream","download_url":"https://codeload.github.com/icedream/obs-spotify-lyrics/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/icedream%2Fobs-spotify-lyrics/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32890458,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-10T13:40:02.631Z","status":"online","status_checked_at":"2026-05-11T02:00:05.975Z","response_time":120,"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":["lyrics","obs-plugin","spotify"],"created_at":"2026-05-11T10:24:27.077Z","updated_at":"2026-05-11T10:24:27.764Z","avatar_url":"https://github.com/icedream.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"assets/icon-app.svg\" width=\"96\" alt=\"\"\u003e\u003cbr\u003e\n  \u003ch1\u003eSpotify Lyrics for OBS\u003c/h1\u003e\n  \u003cp\u003eDisplay the currently playing Spotify track's lyrics as a customizable HTML widget right inside OBS Studio.\u003c/p\u003e\n  \u003ca href=\"https://github.com/icedream/obs-spotify-lyrics/releases/latest\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/icedream/obs-spotify-lyrics?style=for-the-badge\u0026label=%E2%86%93+Download+latest+release\u0026color=brightgreen\" alt=\"Download latest release\"\u003e\u003c/a\u003e\n\u003c/div\u003e\n\nhttps://github.com/user-attachments/assets/957da045-ad25-4af3-bd14-4dbf86f1158d\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/screenshots/windows-source-preview-opensans-nooutline.png\" width=\"800\" alt=\"Lyrics widget on stream showing three lines: two faded and one highlighted\"\u003e\n\u003c/p\u003e\n\nIf you as a streamer enjoy Karaoke and use Spotify for it, or if you just want\nto give your stream chat an opportunity to actually understand the lyrics of the\nSpotify tracks you listen to in the background, then this is the perfect\ncustomizable solution for you.\n\n## Installation\n\nPeople wanting to get an out-of-the-box working experience can just grab the\nOBS plugin/setup for their respective platform. See the\n[Requirements](#requirements) section for what you need to have set up first.\n\n## What's inside\n\nThis comes with everything necessary to render the lyrics of your Spotify tracks\nto the stream:\n\n1.  **Lyrics server** that talks to Spotify to download lyrics for the\n    currently playing song and then serves a WebSocket for the *HTML widget*\n2.  **Customizable HTML widget** that connects to above server to synchronize\n    and render lyrics on screen (you can [roll your own HTML](#roll-your-own-html),\n    too!)\n3.  **OBS plugin** that wraps the above into an easily usable all-in-one\n    package.\n\n## Requirements\n\nIf you want to use the OBS plugin's source, install a compatible **OBS Studio**\nversion. On Linux, make sure your OBS does ship **with the Browser source**!\n\nMake sure you're **logged in to Spotify through one of these browsers** for\nauto-detection of the Spotify token to work:\n\n- Firefox\n- Google Chrome\n- Chromium (the Snap version is also supported)\n- Microsoft Edge\n- Brave\n- Opera (normal or GX)\n\n**Login through the official Spotify app is *not* supported.**\n\nYou may need to close the browser before starting OBS for login token detection to work reliably.\n\n## Customization\n\nThe widget that is shipped with this plugin provides a few variables to tweak\nits look and feel.\n\nIf you use the built-in \"Spotify Lyrics\" source, it basically just acts as a\npre-configured Browser source that already has the default widget code ready to\ngo.\n\nThe \"Simple\" view gives you a clear list of all adjustable variables, pre-filled\nwith default values. Any change to these values is immediately reflected in the\npreview.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/screenshots/windows-source-settings.png\" width=\"500\" alt=\"Source settings panel showing live preview and per-line font, color and outline controls\"\u003e\n\u003c/p\u003e\n\nThings that can be adjusted include:\n\n- Colors (highlighted \u0026 adjacent lines)\n- Font face\n- Font sizes (highlighted \u0026 adjacent lines)\n- Various geometry such as row heights and paddings\n- Animation durations\n\nThese variables and even more can also be adjusted through custom CSS via the\n\"Custom CSS\" view, just as you may already be used to using the Browser source\ndirectly.\n\n### Roll your own HTML\n\nYou do not need to use the HTML widget that's shipped with this project. You can\nwrite your own HTML widget from scratch and simply reuse the WebSocket from the\nwebserver to provide you with the data from Spotify.\n\nThe original HTML widget file can be found [here](internal/widget/widget.html).\n\nFor documentation on how to talk to the WebSocket and what information it provides,\ncheck [`WebSocket.md`](WebSocket.md).\n\n## Configuration\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/screenshots/windows-plugin-settings.png\" width=\"500\" alt=\"Plugin settings dialog showing Spotify token, port and external server fields\"\u003e\n\u003c/p\u003e\n\n### Spotify authentication\n\nThe plugin requires a valid `sp_dc` cookie to talk to Spotify's API. The plugin\nby default auto-detects this from one of the above listed browsers if you're\nlogged in to Spotify.\n\nIf the auto-detection fails, a message box will remind you to insert the cookie\nyourself. For instructions on how to find it, see\nhttps://github.com/akashrchandran/syrics/wiki/Finding-sp_dc. Insert the value\ninto *Tools* → *Spotify Lyrics* → *sp_dc cookie*.\n\n### Webserver\n\nThe plugin uses an internal HTTP server to serve a WebSocket with the track\ninformation \u0026 lyrics and a built-in version of the widget. By default, it just\nuses any free port. You won't need to adjust this unless you decide to roll your\nown HTML/JavaScript that needs to access the WebSocket and needs a predictable\nport.\n\nYou can set the webserver port in *Tools* → *Spotify Lyrics* → *Port*.\n\nThe webserver can also be run as a separate application, completely detached\nfrom OBS, if so desired. If you choose to do so and still want to use the\n*Spotify Lyrics* source with it, you can select *External server* and provide\nthe URL to it here.\n\n## License\n\nThis project is licensed under the [GNU General Public License v3.0](LICENSE.txt).\n\n## Credits\n\nThe Spotify lyrics client in this project is inspired by\n[akashrchandran/spotify-lyrics-api](https://github.com/akashrchandran/spotify-lyrics-api),\na PHP implementation of the same Spotify internal lyrics API.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ficedream%2Fobs-spotify-lyrics","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ficedream%2Fobs-spotify-lyrics","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ficedream%2Fobs-spotify-lyrics/lists"}