{"id":13825165,"url":"https://github.com/moehmeni/syncedlyrics","last_synced_at":"2025-04-06T01:05:55.804Z","repository":{"id":65562151,"uuid":"570989207","full_name":"moehmeni/syncedlyrics","owner":"moehmeni","description":"Get an LRC format (synchronized) lyrics for your music","archived":false,"fork":false,"pushed_at":"2024-07-28T09:46:41.000Z","size":181,"stargazers_count":339,"open_issues_count":9,"forks_count":28,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-03-12T05:03:53.435Z","etag":null,"topics":["lrc","lyrics","lyrics-fetcher","lyrics-finder","lyrics-search","music","music-bot","music-player","synced-lyrics","synchronization"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/moehmeni.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":"2022-11-26T19:41:35.000Z","updated_at":"2025-03-11T20:39:16.000Z","dependencies_parsed_at":"2023-02-16T00:15:56.156Z","dependency_job_id":"4c366788-5f79-4dde-8e15-fc78f9b02601","html_url":"https://github.com/moehmeni/syncedlyrics","commit_stats":null,"previous_names":["0x7d4/syncedlyrics","rtcq/syncedlyrics","lo3me/syncedlyrics","moehmeni/syncedlyrics"],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moehmeni%2Fsyncedlyrics","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moehmeni%2Fsyncedlyrics/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moehmeni%2Fsyncedlyrics/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moehmeni%2Fsyncedlyrics/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/moehmeni","download_url":"https://codeload.github.com/moehmeni/syncedlyrics/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247419859,"owners_count":20936012,"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":["lrc","lyrics","lyrics-fetcher","lyrics-finder","lyrics-search","music","music-bot","music-player","synced-lyrics","synchronization"],"created_at":"2024-08-04T09:01:15.728Z","updated_at":"2025-04-06T01:05:55.784Z","avatar_url":"https://github.com/moehmeni.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# syncedlyrics\n Get an LRC format (synchronized) lyrics for your music.\n \n [![Downloads](https://static.pepy.tech/badge/syncedlyrics/month)](https://pepy.tech/project/syncedlyrics)\n\n## Installation\n```\npip install syncedlyrics\n```\n## Usage\n### CLI\n```\nsyncedlyrics \"SEARCH_TERM\"\n```\n\nBy default, this will prefer time synced lyrics, but use plaintext lyrics, if no synced lyrics are available.\nTo only allow one type of lyrics specify `--plain-only` or `--synced-only` respectively.\n\n#### Available Options\n| Flag | Description |\n| --- | --- |\n| `-o` | Path to save `.lrc` lyrics, default=\"{search_term}.lrc\" |\n| `-p` | Space-separated list of [providers](#providers) to include in searching |\n| `-l` | Language code of the translation ([ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes) format) |\n| `-v` | Use this flag to show the logs |\n| `--plain-only` | Only look for plain text (not synced) lyrics |\n| `--synced-only` | Only look for synced lyrics |\n| `--enhanced` | Searches for an [Enhanced](https://en.wikipedia.org/wiki/LRC_(file_format)#A2_extension:_word_time_tag) (word-level karaoke) format. If it isn't available, search for regular synced lyrics.\n\n### Python\n```py\n# This simple\nlrc = syncedlyrics.search(\"[TRACK_NAME] [ARTIST_NAME]\")\n\n# Or with options:\nsyncedlyrics.search(\"...\", plain_only=True, save_path=\"{search_term}_1234.lrc\", providers=[\"NetEase\"])\n\n# Get a translation along with the original lyrics (separated by `\\n`):\nsyncedlyrics.search(\"...\", lang=\"de\")\n\n# Get a word-by-word (karaoke) synced-lyrics if available\nsyncedlyrics.search(\"...\", enhanced=True)\n```\n\n## Providers\n- [Musixmatch](https://www.musixmatch.com/)\n- ~~[Deezer](https://deezer.com/)~~ (Currently not working anymore)\n- [Lrclib](https://github.com/tranxuanthang/lrcget/issues/2#issuecomment-1326925928)\n- [NetEase](https://music.163.com/)\n- [Megalobiz](https://www.megalobiz.com/)\n- [Genius](https://genius.com) (For plain format)\n- ~~[Lyricsify](https://www.lyricsify.com/)~~ (Broken duo to Cloudflare protection)\n\nFeel free to suggest more providers or make PRs to fix the broken ones.\n\n## License\n[MIT](https://github.com/rtcq/syncedlyrics/blob/master/LICENSE)\n\n## Citation\nIf you use this library in your research, you can cite as follows:\n```\n@misc{syncedlyrics,\n  author = {Momeni, Mohammad},\n  title = {syncedlyrics},\n  year = {2022},\n  publisher = {GitHub},\n  journal = {GitHub repository},\n  howpublished = {\\url{https://github.com/moehmeni/syncedlyrics}},\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmoehmeni%2Fsyncedlyrics","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmoehmeni%2Fsyncedlyrics","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmoehmeni%2Fsyncedlyrics/lists"}