Skip to content
This repository has been archived by the owner on Oct 13, 2024. It is now read-only.

LizardByte/ThemerrDB

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ThemerrDB

GitHub Workflow Status (update) GitHub last commit (gh-pages) GitHub last commit (database) Under Review GitHub closed issues by-label Codecov

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

TheMovieDB Movies IMDB Movies Movie Collections TV Shows Games Games Games

Movies

Movies

Movie Collections

Movie Collections

TV Shows

TV Shows

Games

Games

Game Collections

Game Collections

Game Franchises

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.

  1. 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.

  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.

  1. Within the downloaded json file there is a key named youtube_theme_url that contains the YouTube video URL to the theme song.
  2. 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

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