Python module and CLI for the LRCLIB API
Verified details
These details have been verified by PyPIProject links
GitHub Statistics
Maintainers
Project description
LRCUP
Python CLI and library for interacting with the LRCLIB.net API.
Also includes tools for embedding lyrics, along with general LRC tools.
Installation
Install via PyPI:
pip install lrcup
CLI Usage
# Upload a synced/unsynced LRC file:
lrcup upload example.lrc
# Upload lyrics from an already embedded track:
lrcup upload file.flac
# Embed lyrics into a file:
lrcup embed lyrics.lrc track.flac
# Search for lyrics and download them:
lrcup search never gonna give you up
# Search and embed lyrics for a given folder:
lrcup autosearch --embed /mnt/music/
# Search and embed lyrics for a given folder, also save lrc files:
lrcup autosearch --embed --download /mnt/music/
Module Usage
The class method names are based off of the LRCLIB API endpoints.
Please refer to them for more information.
from lrcup import LRCLib
lrclib = LRCLib()
# Fetch synced lyrics via search
results = lrclib.search(
track = "Never Gonna Give You Up",
artist = "Rick Astley"
)
print(results[0].syncedLyrics)
# Fetch synced lyrics directly
track = lrclib.get(
track = "Never Gonna Give You Up",
artist = "Rick Astley",
album = "Whenever You Need Somebody",
duration = 215
)
if track is not None:
print(track.syncedLyrics)
# Publish synced lyrics
lrclib.publish(
token = lrclib.request_challenge(),
track = "Never Gonna Give You Up",
artist = "Rick Astley",
album = "Whenever You Need Somebody",
duration = 215,
plain_lyrics = "*Rickrolling*",
synced_lyrics = "[00:00.00] *Rickrolling*"
)
Project details
Verified details
These details have been verified by PyPIProject links
GitHub Statistics
Maintainers
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
lrcup-0.10.1.tar.gz
(25.4 kB
view details)
Built Distribution
lrcup-0.10.1-py3-none-any.whl
(10.5 kB
view details)
File details
Details for the file lrcup-0.10.1.tar.gz.
File metadata
- Download URL: lrcup-0.10.1.tar.gz
- Upload date:
- Size: 25.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.12.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
69fcb813a64c4e86d215db86c224d229bb802fe29523f3e18b678a1880e95fcc
|
|
| MD5 |
59766e614311e7eaeb83fbe03df14851
|
|
| BLAKE2b-256 |
2e7164b73e13089c583743e593cde6c711596ea644b6930b7da84ff1a7f2cfd0
|
Provenance
The following attestation bundles were made for lrcup-0.10.1.tar.gz:
Publisher:
publish.yml on iiPythonx/lrcup
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
lrcup-0.10.1.tar.gz -
Subject digest:
69fcb813a64c4e86d215db86c224d229bb802fe29523f3e18b678a1880e95fcc - Sigstore transparency entry: 332421614
- Sigstore integration time:
-
Permalink:
iiPythonx/lrcup@1b60bc69c0fc44b65e56c8614febd4d0eff2755c -
Branch / Tag:
refs/heads/main - Owner: https://github.com/iiPythonx
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@1b60bc69c0fc44b65e56c8614febd4d0eff2755c -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file lrcup-0.10.1-py3-none-any.whl.
File metadata
- Download URL: lrcup-0.10.1-py3-none-any.whl
- Upload date:
- Size: 10.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.12.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cd7eb7b0608a3b4585b4cbf90ffc8b7f098c6af9a0f732824b5866c2a483dc15
|
|
| MD5 |
741fb70594bddd96fcd095d51b80dcef
|
|
| BLAKE2b-256 |
dae68bc8708dd92d20c75635e58dc6a8909d7bc9853bd898ff38fd1d39117340
|
Provenance
The following attestation bundles were made for lrcup-0.10.1-py3-none-any.whl:
Publisher:
publish.yml on iiPythonx/lrcup
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
lrcup-0.10.1-py3-none-any.whl -
Subject digest:
cd7eb7b0608a3b4585b4cbf90ffc8b7f098c6af9a0f732824b5866c2a483dc15 - Sigstore transparency entry: 332421649
- Sigstore integration time:
-
Permalink:
iiPythonx/lrcup@1b60bc69c0fc44b65e56c8614febd4d0eff2755c -
Branch / Tag:
refs/heads/main - Owner: https://github.com/iiPythonx
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@1b60bc69c0fc44b65e56c8614febd4d0eff2755c -
Trigger Event:
workflow_dispatch
-
Statement type:
