This is a Stremio add-on with more than 83,000 music videos from The Internet Music Video Database.
If you just want to watch the videos provided by the add-on in Stremio, you don't need this. Simply open https://stremio-imvdb.tgr.ax and click the install button. Everything below is for running the addon server.
This add-on is a Python app that retrieves the YouTube IDs of music videos from IMVDb and provides them to Stremio. It supports in-memory caching, can be configured using environment variables and run in Docker.
The app has two main parts, add-on server and IMVDb client, both built using aiohttp. The server listens for HTTP requests from Stremio clients and dispatches calls to the client, which translates them to requests to the IMVDb API and web interface, parses the responses and caches the results.
The minimum version of Python is 3.7, lower versions haven't been tested.
Poetry is used for dependency management, but it isn't required (though recommended), you can instead just use pip.
Additionally, in order for this add-on to work, you will need an IMVDb App Key. To get it, register an app here.
First, clone the repo:
git clone https://github.com/axtgr/stremio-imvdb
cd stremio-imvdb
Then install the dependencies. If you have Poetry:
poetry install
Otherwise:
pip install .
If you are planning to change the code, you'll also want to do pre-commit install to install the pre-commit git hooks. This way, the code will be linted with Flake8 and formatted with Black before each commit.
Before running the app, set environment variables according to the example for your platform:
export STREMIO_IMVDB_APP_KEY="YOUR_APP_KEY"
set STREMIO_IMVDB_APP_KEY="YOUR_APP_KEY"
$env:STREMIO_IMVDB_APP_KEY="YOUR_APP_KEY"
| Variable | Default Value | Description |
|---|---|---|
| STREMIO_IMVDB_APP_KEY | Your IMVDb App Key (required) | |
| STREMIO_IMVDB_HOST | 0.0.0.0 | Host to listen to |
| STREMIO_IMVDB_PORT | 80 | Port to listen to |
| STREMIO_IMVDB_EMAIL | Contact email |
Using Poetry:
poetry run start
Otherwise:
python3 stremio_imvdb/addon.py
Or, if the above didn't work:
python stremio_imvdb/addon.py
The add-on will start listening on the specified host and port.
Even though the add-on provides correct YouTube IDs, Stremio sometimes struggles to load the streams for some unknown reason.
