https://github.com/fashni/mxlrc-go
Fetch synced lyrics from Musixmatch and save it as *.lrc file, written in Go. Python version https://github.com/fashni/MxLRC
https://github.com/fashni/mxlrc-go
go golang lrc-files lrc-maker lyrics-fetcher lyrics-search musixmatch synced-lyrics
Last synced: 4 months ago
JSON representation
Fetch synced lyrics from Musixmatch and save it as *.lrc file, written in Go. Python version https://github.com/fashni/MxLRC
- Host: GitHub
- URL: https://github.com/fashni/mxlrc-go
- Owner: fashni
- License: mit
- Created: 2022-08-01T06:48:48.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2022-08-08T17:50:39.000Z (almost 4 years ago)
- Last Synced: 2025-12-17T15:23:37.248Z (7 months ago)
- Topics: go, golang, lrc-files, lrc-maker, lyrics-fetcher, lyrics-search, musixmatch, synced-lyrics
- Language: Go
- Homepage:
- Size: 28.3 KB
- Stars: 27
- Watchers: 3
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# MxLRC
[](https://github.com/fashni/mxlrc-go/actions/workflows/build.yml)
Command line tool to fetch synced lyrics from [Musixmatch](https://www.musixmatch.com/) and save it as *.lrc file.
---
## Python version
[Check it here](https://github.com/fashni/MxLRC)
---
## Download
### Standalone binary
**TBA**
### Build from source
Required Go 1.17+
```
go install github.com/fashni/mxlrc-go@latest
```
---
## Usage
```
Usage: mxlrc-go [--outdir OUTDIR] [--cooldown COOLDOWN] [--token TOKEN] SONG [SONG ...]
Positional arguments:
SONG song information in [ artist,title ] format (required)
Options:
--outdir OUTDIR, -o OUTDIR output directory [default: lyrics]
--cooldown COOLDOWN, -c COOLDOWN
cooldown time in seconds [default: 15]
--depth DEPTH, -d DEPTH (directory mode) maximum recursion depth [default: 100]
--update, -u (directory mode) update existing lyrics file
--bfs (directory mode) use breatdth-first-search traversal
--token TOKEN, -t TOKEN musixmatch token
--help, -h display this help and exit
```
## Example:
### One song
```
mxlrc-go adele,hello
```
### Multiple song and custom output directory
```
mxlrc-go adele,hello "the killers,mr. brightside" -o some_directory
```
### With a text file and custom cooldown time
```
mxlrc-go example_input.txt -c 20
```
### Directory Mode (recursive)
```
mxlrc-go "Dream Theater"
```
> **_This option overrides the `-o/--outdir` argument which means the lyrics will be saved in the same directory as the given input._**
> **_The `-d/--depth` argument limit the depth of subdirectory to scan. Use `-d 0` or `--depth 0` to only scan the specified directory._**
---
## How to get the Musixmatch Token
Follow steps 1 to 5 from the guide [here](https://spicetify.app/docs/faq#sometimes-popup-lyrics-andor-lyrics-plus-seem-to-not-work) to get a new Musixmatch token.
## Credits
* [Spicetify Lyrics Plus](https://github.com/spicetify/spicetify-cli/tree/master/CustomApps/lyrics-plus)