---
id: syncedlyrics
version: "1.0.1"
license: MIT
license_treatment: permissive
maintenance: dormant
---

# syncedlyrics — Get an LRC format (synchronized) lyrics for your music

License: permissive · Maintenance: dormant · Downloads: 101.4K/mo

## What it is and what it does

syncedlyrics is a Python library and CLI tool that retrieves synchronized lyrics in LRC format from multiple online music providers. It wraps requests, beautifulsoup4, and rapidfuzz to search and parse lyrics, offering both a simple Python API and a command-line interface. You can search by track name and artist, optionally filter for synced-only or plain-text lyrics, request word-level karaoke formats, and save results to .lrc files.

The package supports several providers including Musixmatch, Lrclib, NetEase, Megalobiz, and Genius, though the documentation notes that some (Deezer, Lyricsify) are currently broken. It requires Python 3.8 or later and has low install friction. However, maintenance is dormant—the last commit was 2024-07-28—so provider integrations may break as external APIs change without timely fixes.

Use it for:

- Build a music player or karaoke app that displays synchronized lyrics alongside playback.
- Batch download LRC files for a music library to enable lyrics display in compatible media players.
- Integrate lyrics search into a music metadata tool or music discovery application.
- Create a CLI tool to fetch and save lyrics for offline use or archival purposes.
- Develop a translation workflow by fetching lyrics in multiple languages using the lang parameter.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Fetches synchronized lyrics in LRC format for music tracks from multiple online providers, with options for plain text or word-level karaoke formats.

Yes, if you need a straightforward way to fetch synchronized lyrics and can tolerate dormant maintenance. The low install friction, permissive MIT license, and broad provider support make it practical for music apps or CLI tools. However, be aware that provider breakage is likely without active maintenance—test each provider you rely on before deploying to production.

## Install

pip install syncedlyrics
uv add syncedlyrics
poetry add syncedlyrics

## Installing syncedlyrics

Before you install: Low install friction with three lightweight dependencies (requests, beautifulsoup4, rapidfuzz). Maintenance is dormant—last commit was 2024-07-28—but the repository remains unarchived with 512 stars. No recent updates means provider integrations may break as external APIs evolve.

License in practice: MIT license is permissive and imposes no restrictions on use, modification, or distribution in proprietary or open-source projects.

Quickstart:

pip install syncedlyrics

import syncedlyrics
lrc = syncedlyrics.search("Song Name Artist Name")
print(lrc)

Some providers (Deezer, Lyricsify) are noted as broken; availability depends on which providers are currently working.

Verify before relying:

- Current operational status of each provider—documentation lists Deezer and Lyricsify as broken, but reliability of others is unclear.
- Whether dormant maintenance will allow provider integrations to continue working as external APIs evolve.
- How frequently provider APIs change and whether the package will receive timely fixes.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: dormant
- Downloads: 101.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

synchronized lyrics lrc format, music lyrics downloader, lrc file generator, synced lyrics api, karaoke lyrics fetcher, lyrics search tool, music metadata lyrics, lyrics-fetching, lrc-format, music-metadata

[View on SkillFed](https://skillfed.io/packages/syncedlyrics) · [View on PyPI](https://pypi.org/project/syncedlyrics/)