Our take
Quietno commits in the last 90 days- Activity
- 33
- Community
- 11
- Issues
- 21
- Pull requests
- 20
+5 stars in the last 30 days
- Fewer contributors than 86% of the projects we track
This is a focused way to retrieve Spotify lyrics in PHP, but its quiet recent development and reliance on one primary contributor make it important to verify that it meets your operational and licensing needs.
Good fit if
- You need Spotify lyric retrieval in a PHP application or a self-hosted API.
- You can supply an SP_DC cookie and accept the project's stated Spotify terms-of-service risk.
- You want the available line-synced data or its LRC, SRT, and plain-text formats.
Look elsewhere if
- You need a supported public service rather than deploying and maintaining your own instance.
- You require active recent maintenance: the project has had no commits in the last 90 days, and no issues or pull requests were closed or merged during that period.
- You need a contributor base broader than this project has, or cannot accept the licensing terms after resolving the README and repository license discrepancy.
All health signals
| Last commit | 2025-12-30 (10 months ago) |
|---|---|
| Commits, last 90 days | 0 |
| Releases, last 12 months | 2 (latest v2.2.0, 2025-12-30) |
| Contributors | 2 (top contributor: 99% of commits) |
| Issues closed, last 90 days | 0 |
| Pull requests merged, last 90 days | 0 |
| Project age | 4 years |
Checked on 2026-10-13 with the GitHub API.
Project history
Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.
Stars
641Forks
55Change since Nov 15, 2026: 0 stars·0 forks
Overview
spotify-lyrics-api retrieves lyrics for a Spotify track using its track ID or URL, with Musixmatch providing the lyric data. It returns synced or unsynced lyrics and can format results as ID3-style data, LRC, SRT, or plain text.
The project can run as a small HTTP service or be included in a PHP application through Composer. It is a self-hosted option rather than a hosted public API, and requires an SP_DC cookie.
Key Features
- Accepts a Spotify track ID or track URL through GET query parameters.
- Returns line-synced or unsynced lyric data with timing information where available.
- Offers
id3,lrc,srt, andrawresponse formats. - Provides a PHP package interface for retrieving and formatting lyrics.
- Supports deployment with Docker and local PHP development.
- Reports errors for missing input and unavailable lyrics.
Use Cases
- A PHP application can retrieve lyrics for a Spotify track and display them alongside playback.
- A self-hosting developer can run the Docker image to provide a private lyrics endpoint for their own tools.
- A developer building a lyric player can use timed lines to synchronize text with a track.
- A command-line or media workflow can consume LRC, SRT, or plain-text output instead of parsing the API response itself.
What you need
Detected in the repository
- PHP (from composer.json)
- A Dockerfile, so it can run in a container
- Automated checks on GitHub Actions
License in plain words
GPL-3.0strong copyleft
- Commercial use: yes
- Modify and redistribute: yes
- You must keep: the license notice
- Share your changes: yes, the full source of anything you distribute that includes it, under the GPL
- Includes an explicit patent grant from the contributors:
A summary, not legal advice: the LICENSE file is what applies.
Getting Started
Run the Docker image with your SP_DC cookie:
docker run -d -p 8080:8080 -e SP_DC=your_sp_dc_cookie akashrchandran/spotify-lyrics-api
Then request http://localhost:8080/?trackid=YOUR_TRACK_ID. See the README for response formats, Composer usage, and deployment details.
Considerations
The API requires an SP_DC cookie, and the README warns that the project may conflict with Spotify's terms of service. The README describes support for track IDs or links only, and notes that Spotify currently provides line-synced lyrics rather than word-synced lyrics.
Development is quiet, with no commits in the last 90 days. Although there have been releases within the past year, nearly all contribution activity comes from one person, and no issues or pull requests were closed or merged in that period. Also check the license before adopting: repository metadata lists GPL-3.0, while the README's license header refers to the GNU Affero General Public License version 3 or later.
Found this useful?
Share it with someone who would like spotify-lyrics-api.