https://github.com/curious-odd-man/lyrics-find-and-embed
Tool that can find and populate lyrics tags for songs in whole music library.
https://github.com/curious-odd-man/lyrics-find-and-embed
id3 lyrics-fetcher lyrics-finder lyrics-search music-library
Last synced: 7 months ago
JSON representation
Tool that can find and populate lyrics tags for songs in whole music library.
- Host: GitHub
- URL: https://github.com/curious-odd-man/lyrics-find-and-embed
- Owner: curious-odd-man
- License: apache-2.0
- Created: 2022-08-20T06:44:30.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2022-08-21T08:08:45.000Z (about 3 years ago)
- Last Synced: 2025-02-03T11:23:27.944Z (8 months ago)
- Topics: id3, lyrics-fetcher, lyrics-finder, lyrics-search, music-library
- Language: Python
- Homepage:
- Size: 102 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Overview
Tool will search for songs recursively in all directories starting with directory you pass as a parameter.
Tool will try several web sites to fetch html documents with lyrics and then try and extract lyrics from those.
It then will create 2 directories:
1. `00_html` - stores all extracted html documents
2. `00_lyrics` - stores all extracted lyrics
Files in those directories are to store intermediate results and do not retry same song several time in the same source.
Meaning you can easily run tool several times with same configuration and it will more or less continue where it left off.
# Notable configurations
In main.py:
1. `HTML_ROOT_DIR` - directory where to store HTML files
2. `LYRICS_ROOT_DIR` - directory wher to store extracted lyrics
3. `ignore_list` - list of artists that should be ignored (for example russian artist could not be found on any of used sites).
# How To Run
## Scraping and embedding
Please refer no configurations above before running tool. 100% you want to make changes there first.
Execute `main.py` and pass path to a library directory.
## Analysis
There is a test that can analyse your library and show how much songs you have with and without lyrics.
It is located in `src/unittest/AnalyseLibrary.py`
Change path in a variable `library_path` in that file and run it as unit tests.
# Note
Tool is not perfect. Some HTMLs could not be parsed. Feel free to make changes and submit PRs.