README.md

ThemerrDB

ThemerrDB is a database for movie and video game theme songs.

The database is created using codeless contributions.

You can view the entire database at ThemerrDB.

Database Growth

Movies

Movie Collections

TV Shows

Games

Game Collections

Game Franchises

Contributing

Important

Theme submissions are currently disabled until a critical issue is fixed. Thank you for your patience.

Adding/Updating Theme Song

1. Read our Theme Guidelines.

2. Create a new request

3. Add the requested URLs to the issue.

Warning

YouTube URLs should only contain the video ID parameter. i.e. https://www.youtube.com/watch?v={VIDEO_ID} or https://youtu.be/{VIDEO_ID}

🔗 See YouTube Share for further instruction.

4. Submit the issue.

A label will be added to the request. i.e. request-theme.

The workflow will automatically determine the type of theme to add.

A workflow will run. If necessary the title of the issue will be updated. Additionally, a comment will be added to the issue. If there are any issues with the YouTube URL, the comment will contain the error message in the first section. The remaining information in the comment is to assist with the review process.

Content Review

Submitted "issues" will be reviewed by a developer/moderator. Once approved we will add a label, i.e. approve-theme. At this point, the workflow will run and attempt to update the database in the database branch.

Daily updates

The database will be pushed to the gh-pages branch, once daily at UTC 12:00. Theme songs will not be available until they are published.

How to use the database in your own project

1. Determine the media type. Supported types are shown in the table.

   Type	Databases
   games	igdb
   game_collections	igdb
   game_franchises	igdb
   movies	themoviedb, imdb
   movie_collections	themoviedb
   tv_shows	themoviedb

2. Determine the id of the item from the main database.

   • Games
     • igdb
   • Movies
     • imdb
     • themoviedb
   • TV Shows
     • themoviedb

3. Access the item on ThemerrDB at the following url:

   https://app.lizardbyte.dev/ThemerrDB/<media_type>/<database>/<item_id>.json

Note

Not all movies will be available in the imdb database directory. This is due to the fact that the imdb_id is missing from the item's entry in themoviedb.

4. Within the downloaded json file there is a key named youtube_theme_url that contains the YouTube video URL to the theme song.
5. Extract the audio from the YouTube video using your preferred method. Some suggestions are listed in the table below.

language	library
C#	YoutubeExplode
JavaScript	ytdl-core
Python 2.6+	youtube_dl
Python 3.7+	YT-DLP

Projects using ThemerrDB

• Themerr-jellyfin
• Themerr-kodi
• Themerr-plex

Something missing? Let us know by opening a PR to update the README.