{"id":16623457,"url":"https://github.com/rahuletto/lirics","last_synced_at":"2025-10-29T22:31:39.711Z","repository":{"id":231129198,"uuid":"780486167","full_name":"Rahuletto/lirics","owner":"Rahuletto","description":"Lirics is a self-hosting service that brings real-time Spotify lyrics to your screen with a beautiful, Apple Music-like aesthetic.","archived":false,"fork":false,"pushed_at":"2024-06-14T10:02:02.000Z","size":6410,"stargazers_count":7,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-08T01:42:26.293Z","etag":null,"topics":["api","lyrics","spotify"],"latest_commit_sha":null,"homepage":"https://lirics.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Rahuletto.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":"2024-04-01T15:28:30.000Z","updated_at":"2025-01-13T19:39:15.000Z","dependencies_parsed_at":"2024-04-02T16:01:40.669Z","dependency_job_id":"f35c745f-7503-4339-9be3-7a942da85398","html_url":"https://github.com/Rahuletto/lirics","commit_stats":null,"previous_names":["rahuletto/lirics"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rahuletto%2Flirics","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rahuletto%2Flirics/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rahuletto%2Flirics/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rahuletto%2Flirics/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Rahuletto","download_url":"https://codeload.github.com/Rahuletto/lirics/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238909403,"owners_count":19550840,"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":["api","lyrics","spotify"],"created_at":"2024-10-12T03:23:45.676Z","updated_at":"2025-10-29T22:31:38.510Z","avatar_url":"https://github.com/Rahuletto.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# lirics\nLirics is a self-hosting service that brings real-time Spotify lyrics to your screen with a beautiful, Apple Music-like aesthetic.\n\u003e As spotify made lyrics into a premium feature, I came up with this cool idea to display accurate timed-lyrics in Apple Music style.\n\n\u003e [!IMPORTANT]\n\u003e Thanks to [LRCLib](https://lrclib.net) api for providing lyrics\n\n### Features\n- Real-Time Lyric Display: See the lyrics of your favorite songs in real time as they play on Spotify.\n- Playback Control: Spotify Premium users can control playback directly from the app.\n- Interactive Lyrics: Click on any line of lyrics to jump to that specific part of the song.\n- Advanced Navigation: Easily seek 10 seconds forward or backward with intuitive controls.\n- PWA Support! Install the website as an app in supported browsers\n\n### Installation\nTo get started with Lirics, follow these steps:\n\n- Clone the repository: git clone https://github.com/Rahuletto/lirics.git\n- Navigate to the project directory: cd lirics\n- Get Spotify API key from [Spotify developer dashboard](https://developer.spotify.com/dashboard)\n- Setup the `.env` with the `NEXTAUTH_SECRET`, `SECRET`, `CLIENT_ID`, `REDIR`, `NEXTAUTH_URL` variables, Where\n  - - `NEXTAUTH_SECRET` is the [Encryption key for JWT](https://next-auth.js.org/configuration/options#secret) (haha fancy term?)\n    - `SECRET` and `CLIENT_ID` from Spotify api\n    - `REDIR` would be `https://{URL}/api/auth/callback/spotify` where URL is your hosted/localhost website\n    - `NEXTAUTH_URL` is self-explanatory, its the url of your site.\n- Install the necessary dependencies:\n  ```\n  npm install\n  ```\n- Start the application:\n  ```\n  npm run build \u0026\u0026 npm run start\n  ```\n\nOnce installed, you can access Lirics from your web browser. Ensure you have a Spotify Premium account to utilize playback controls within the app, other than that you can see timed lyrics without any subscription.\n\nThis can **only** be self-hosted as Spotify didnt approve my application for the API to be used by public\n\u003e Your application would be rejected if requested to be published to public for the reason `Synchronization: Spotify content is used in the background of visual media, such as advertising, film, TV programs, livestreams, slideshow videos, lyrics (etc.)`\n\n\n\u003e [!WARNING]\n\u003e This is not affiliated to Spotify\n\n\n### Screenshots\n\nLyrics\n| Desktop | Mobile |\n| ------- | ------ |\n| \u003cimg width=\"1200\" alt=\"image\" src=\"https://github.com/Rahuletto/lirics/assets/71836991/c3cf07a6-d937-469c-8097-c2cf2252aca8\"\u003e | \u003cimg width=\"300\" alt=\"image\" src=\"https://github.com/Rahuletto/lirics/assets/71836991/6004dd9d-6130-47a8-b4e0-df492d9d06eb\"\u003e |\n\n\nSharing page\n\n| Desktop | Mobile |\n| ------- | ------ |\n| \u003cimg width=\"1200\" alt=\"image\" src=\"https://github.com/Rahuletto/lirics/assets/71836991/bf9518fb-ccf8-4be1-83d4-b7dff5a1d5ad\"\u003e | \u003cimg width=\"300\" alt=\"image\" src=\"https://github.com/Rahuletto/lirics/assets/71836991/d2658e91-b920-495f-9a82-05d7deda6941\"\u003e |\n\n\nVideo\n\nhttps://github.com/Rahuletto/lirics/assets/71836991/0adf6cae-99e1-4cb8-8247-a3fe6e3600b4\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frahuletto%2Flirics","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frahuletto%2Flirics","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frahuletto%2Flirics/lists"}