python library for negromate songs database
Go to file
Ales (Shagi) Zabala Alava 915b352481 chore: Bump version 1.5 2024-08-30 17:22:36 +02:00
negromate/songs chore: Bump version 1.5 2024-08-30 17:22:36 +02:00
.gitignore Migrate setup to pep517 2020-11-02 16:54:09 +01:00
.pre-commit-config.yaml chore: update dependencies and code cleaning 2024-03-08 09:40:11 +01:00
CHANGELOG.md chore: Bump version 1.5 2024-08-30 17:22:36 +02:00
LICENSE.txt Initial Commit 2020-11-01 12:07:37 +01:00
README.md chore: update readme and fix dependencies 2024-08-30 17:22:36 +02:00
pyproject.toml chore: update dependencies and code cleaning 2024-03-08 09:40:11 +01:00
requirements.txt chore: update readme and fix dependencies 2024-08-30 17:22:36 +02:00
setup.cfg chore: update readme and fix dependencies 2024-08-30 17:22:36 +02:00

README.md

Negro Mate Songs

Negro Mate's song database library. Not very versatile without two another packages:

Provides the base negromate command to interact with a song repository.

negromate config: Write the configuration file
negromate songs: Update song database
negromate thumbnail: Generate cover and thumbnail for a song

Needs the following packages installed:

  • imagemagick
  • ffmpeg

Karaoke subtitle generation is currently broken, it worked with these packages on older systems:

  • xdotool
  • aegisub
  • xserver-xephyr

Song library structure

Each song is a folder containing at least a video file, a subtitles file and a metadata file:

song_name/
├── song_name.ass
├── song_name.mp4
└── metadata.json

Video and subtitles file has to be named like the folder. Supported subtitles:

  • ass (prefered)
  • src
  • vtt

The metadata json file

{
    "name": "Song name",
    "original": "Original song, Original author",
    "karaoke": true,
    "date": "XXXX-XX-XX"
    "author": "Author of the karaoke"
}
  • name: used as the title of the song.
  • original: for giving credit to original authors.
  • karaoke: if true, the ass subtitles file has karaoke level subtitles (syllable level timing) and automatik karaoke subtitles can be generated.
  • date: approx. creation date of this version
  • author: not required, used for givin credits to the author when it's different from the web authors.