negromate.songs 1.5

NegroMate karaoke song database library

Negro Mate Songs

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

• negromate.web: Static html compiler for the web of Negro Mage
• negromate.karaoke: Simple karaoke video browser

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.

Changelog

1.5

• Update readme and fix dependencies
• Fix typo

1.4

• Update dependencies and code cleaning

1.3

• New property for songs: has_subtitles
• Upgrade dependencies
• Add songs without ass file as pending
• Song folders must have a metadata.json file

1.2

• Get karaoke ass generator from negromate.web
• Add date to songs
• Convert to namespace package
• Add verbose flag
• Use configuration file for commands defaults

1.1

• Start with generic negromate command with entry points for other modules
• Move image generating code to utils
• Migrate setup to pep517