Skip to main content

syncedlyrics_aio

Get an LRC format (synchronized) lyrics for your music with aiohttp support.

Downloads

Installation

pip install syncedlyrics_aio

Usage

CLI

syncedlyrics_aio "SEARCH_TERM"

By default, this will prefer time synced lyrics, but use plaintext lyrics, if no synced lyrics are available. To only allow one type of lyrics specify --plain-only or --synced-only respectively.

Available Options

Flag Description
-o Path to save .lrc lyrics, default="{search_term}.lrc"
-p Space-separated list of providers to include in searching
-l Language code of the translation (ISO 639-1 format)
-v Use this flag to show the logs
--plain-only Only look for plain text (not synced) lyrics
--synced-only Only look for synced lyrics
--enhanced Searches for an Enhanced (word-level karaoke) format. If it isn't available, search for regular synced lyrics.
-d The duration of track in ms. Keep default if unknow. Only for netease and tencent
-m Max deviation for lyrics in ms, ignore if duration is default

Python

import syncedlyrics_aio

loop = asyncio.get_event_loop()
lrc = loop.run_until_complete(syncedlyrics_aio.search("[TRACK_NAME] [ARTIST_NAME]"))
if lrc:
    print(lrc)

Or with options:

syncedlyrics_aio.search("...", plain_only=True, save_path="{search_term}_1234.lrc", providers=["NetEase"], duration=213000)

Providers

Feel free to suggest more providers or make PRs to fix the broken ones.

License

MIT

Citation

If you use this library in your research, you can cite as follows:

@misc{syncedlyrics,
  author = {Momeni, Mohammad},
  title = {syncedlyrics},
  year = {2022},
  publisher = {GitHub},
  journal = {GitHub repository},
  howpublished = {\url{https://github.com/moehmeni/syncedlyrics}},
}

Metadata

Release files for syncedlyrics_aio 1.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for syncedlyrics_aio 1.0.2
File Size Uploaded
syncedlyrics_aio-1.0.2.tar.gz 15.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for syncedlyrics_aio 1.0.2
File Interpreter ABI Platform
syncedlyrics_aio-1.0.2-py3-none-any.whl Python 3 none any Details

Total release size: 35.9 kB

Release files / syncedlyrics_aio-1.0.2.tar.gz

Download URL syncedlyrics_aio-1.0.2.tar.gz
Size 15.1 kB
Tags Source
SHA-256 checksum
How to use checksums
d3985b3904006e275a46ea4bc319a0f7707ef8822a54148b67ac43a08289e89c
BLAKE2b-256 checksum
How to use checksums
16e048f1a0119b2df67b6ded9ef19e8b5bf06afe7819c6f0e7f6d21e5790d45e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.8.3 CPython/3.12.4 Linux/6.5.0-1024-azure

Release files / syncedlyrics_aio-1.0.2-py3-none-any.whl

Download URL syncedlyrics_aio-1.0.2-py3-none-any.whl
Size 20.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
229426faae2a8893d14a8fb13934547977e7ca568f51b551037b68f6536aa4b0
BLAKE2b-256 checksum
How to use checksums
400d7d1cc7dcd432958f9b5515e4894ea34728ef4834b05a4c85a1b71fe95c5c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.8.3 CPython/3.12.4 Linux/6.5.0-1024-azure

Release history Release notifications | RSS feed

This release

1.0.2 This release

2 release files

1.0.1

2 release files

0.5.5

2 release files

0.5.4

2 release files

0.5.3

2 release files

0.5.2

2 release files

0.5.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page