# \[WS\] Internet Music Video Database (IMVDb)
**URL:** https://community.mp3tag.de/t/ws-internet-music-video-database-imvdb/71292
**Category:** Broken Web Sources
**Created:** [May 17, 2026, 9:23pm UTC](https://community.mp3tag.de/t/ws-internet-music-video-database-imvdb/71292 "2026-05-17T21:23:37Z")
**Posts on this page:** 2
**Page:** 1
### Author:  [@arb](https://community.mp3tag.de/u/arb)
#### Post date: [May 17, 2026, 9:23pm UTC](https://community.mp3tag.de/t/ws-internet-music-video-database-imvdb/71292/1 "2026-05-17T21:23:37Z")
Hello! I've been maintaining the [TMDb web source](https://community.mp3tag.de/t/ws-themoviedb/48029/12) for a while and found another very similar database tailored to music videos:
> **[IMVDb | The Internet Music Video Database](https://imvdb.com/)**
>
> A music video database of credits, trivia, and more. Submit a new video or add information to an existing one.
The website's search engine is _very_ good: it lets you search by the [title](https://docs.mp3tag.de/mapping/#title), [artist](https://docs.mp3tag.de/mapping/#artist) and/or [director](https://docs.mp3tag.de/mapping/#artist:~:text=iTunes-,DIRECTOR,-%C2%A9dir) of a music video. The intent is to supply more information about the people who worked on a music video along with the basics for a music library. It can even save metadata about where you can view it online, via YouTube or Vimeo.
> **Installation and Maintenance**
>
> #### For new users:
>
> Please refer to [this topic](https://community.mp3tag.de/t/freedb-and-web-sources/2748/4) on how to navigate to Mp3tagβs **configuration folder**.
>
> - There's three different files that make up a web/tag source:
>
> - From your IMVDB zip file, copy over all files into the **sources** folder. Please do not rename or remove `IMVDB#Results.inc` and `IMVDB#Settings.settings` as they are essential for the web source to work.
>
> - **This requires a IMVDB API key** , though registration is **[pretty easy](https://imvdb.com/developers/api)**. You then need to paste it into every .src file you use:
>
> - **Now** , you are able to try out the source in Mp3tag from **Tag Sources** in the toolbar! Try it with your favourite music video or musician. Have a look at the **Files** section for what .srcβs are available.
>
> ### For current users:
>
> - Whenever a file is updated as shown in the Changelog or README.txt, youβll again need to paste your API key/default language/any personal modifications to the newer versions.
>
> - If you know how to develop in the web sources framework, you are welcome to edit or reverse-engineer all files as you wish (edit tag labels, add/remove functionality, add settings translations etc.). For personal use and learning, go ahead! π€
>
> - I (@arb) am currently maintaining this source so please **be fair** : post any changes or updates you've made to the scripts in this topic to keep it all together or [message me privately](https://community.mp3tag.de/new-message?username=arb&title=IMVDB). Credit will always be given in the changelog to everyone with work added into a release and help given where possible.
> **Files**
>
> ### Essential
>
>  **Results** generates metadata from queries made by most .srcβs. It works in the background so you won't see it in Mp3tag.
>  **Settings** saves your preferences between all .srcβs and shows a tooltip for more information when you hover your cursor over a label.
> _Reminder: Both files **must** be saved in the **sources** folder and kept the same name for the script to work._
>
> ### Search
>
> These .src's are your starting points to find content and grab metadata from possible results:
>
>  **Search or ID** - a combination of the below **Search**.src's and finding by ID using an `IMVDB` tag; it prioritises using ID over a search term if both are supplied in a search. This may be preferable for users that want a one-click solution instead of several .src's or want to quickly revisit.
>  **Title** - finds by title if saved in your media with a `TITLE` tag. This might be handy if you want to limit you search terms.
>  **Artist** - finds by an album artist/artist with an `ALBUMARTIST`/`ARTIST` tag.
>  **Director** - finds by a director with a `DIRECTOR` tag.
>
> ### For most files:
>
> - The scripts will let you know of any errors. You can select βBackβ to return to the previously displayed prompt and try again or use given metadata.
>
> - The script can take 3-5 seconds between prompts as the website's connection is a bit slow... (you can check the bottom left of Mp3tag to see when a connection is made).
>
> - Settings can be localised by copying the `βen": [`] section in `"localizations": {}`, run it through a translator of your choice and refine as needed.
>
> ### Icons
>
> Mp3tag v3.34 for Windows added custom toolbars which uses **.ico** files to add an icon to your functionality. They share the same name as the script they're paired with but swap them about if you want!:
>
> - Save the icons somewhere handy on your device (the **sources** folder is convenient but it won't save your .ico files when using **Save configuration...** )
> - Go to View -\> Toolbars and select either Mp3tag's main toolbar or a fresh new custom toolbar for your own use.
> - Select a script, give it a tooltip to remind you of what it does and find the .ico/.icl to load in the icons and assign it to that script.
>
> ### Other
>
> **README** is simply a quick reference for more information when needed, it is not essential but worth keeping around.
> **Tag Mappings**
>
> Iβve used Mp3tag's [tag mappings](https://docs.mp3tag.de/mapping/) as a basis for naming labels, as they create compatibility with several different tagging syntaxes, not just ID3. They are closer to .mp4's tagging standard but I took cues from .mkv's standard to prioritise much wider compatibility.
>
> Tags can be renamed afterwards using Mp3tag's **Options** , remapped through TMBD settings or manually with Mp3tag's own functionality to assist you. Apologies however if what is supplied from this suite doesnβt 100% match your workflow.
>
> ### Web Sources
>
> #### Basic
>
> | TAG NAME | EXISTING? | PURPOSE |
> | --- | --- | --- |
> | - | β | Localised artwork for movie/per season |
> | [ACTOR](https://www.matroska.org/technical/tagging.html) | β MKV | Cast of a music video |
> | [ALBUMARTIST](https://docs.mp3tag.de/mapping/#albumartist) | β | Main musician/band |
> | [ARTIST](https://docs.mp3tag.de/mapping/#artist) | β | All musicians including album/featured artists |
> | [COMMENT](https://docs.mp3tag.de/mapping/#comment) | β | Can be used for anything; used to list metadata that isn't displayed or indexed by file explorers |
> | [COPYRIGHT](https://docs.mp3tag.de/mapping/#copyright) | β | Combination of `TVNETWORK` and `PUBLISHER` |
> | [COUNTRY](https://www.matroska.org/technical/tagging.html) | β MKV | Production country as text |
> | COUNTRYID | β | Custom tag for origin country as ISO 3166-1 |
> | [DIRECTOR](https://docs.mp3tag.de/mapping/#:~:text=iTunes-,DIRECTOR,-%C2%A9dir) | β MP4 | Director and co-directors |
> | ERROR: | β | Only used to inform of errors, please uncheck |
> | [INVOLVEDPEOPLE](https://docs.mp3tag.de/mapping/#involvedpeople) | β | Job:Person 1;Job:Person 2 (Complete list of credits for a music video) |
> | ORIGTITLE | β | Custom tag based on [`ORIGALBUM`](https://docs.mp3tag.de/mapping/#origalbum); a copy of `TITLE` that could be used to store the title of the song it's based on in its original language/stylisation |
> | [PRODUCER](https://www.matroska.org/technical/tagging.html) | β MKV | Producer or co-producers |
> | [RELEASETIME](https://docs.mp3tag.de/mapping/#releasetime) | β | YYYY-MM-DD |
> | [TITLE](https://docs.mp3tag.de/mapping/#title) | β | Title of music video |
> | [IMVDB](https://www.matroska.org/technical/tagging.html) | β | Custom tag based on [`TMDB`/`IMDB`](https://www.matroska.org/technical/tagging.html) |
> | [IMVDBURL](https://www.matroska.org/technical/tagging.html) | β | Custom tag based on [`TMDBURL`/`IMDBURL`](https://www.matroska.org/technical/tagging.html) |
> | [YEAR](https://docs.mp3tag.de/mapping/#year) | β | YYYY; can be set to YYYY-MM-DD |
>
> #### External ID (from Settings or .src)
>
> | TAG NAME | EXISTING? | PURPOSE |
> | --- | --- | --- |
> | YOUTUBE | β | Custom tag with same function as `IMVDB` |
> | YOUTUBEURL | β | Custom tag with same function as `IMVDBURL` |
> | VIMEO | β | Custom tag with same function as `IMVDB` |
> | VIMEOURL | β | Custom tag with same function as `IMVDBURL` |
>
> #### Settings -\> Remap -\> MP4
>
> | TAG NAME | EXISTING? | PURPOSE |
> | --- | --- | --- |
> | EDITOR | β | Custom tag following the format of `ACTOR`, `DIRECTOR` and `PRODUCER` |
> | [ITUNESMEDIATYPE](https://docs.mp3tag.de/mapping/#:~:text=video%20(0/1)-,ITUNESMEDIATYPE,-%5B3%5D) | β MP4 | Denotes if "Movie" or "TV Show" when first imported into Apple software; can set to use "Short Film" and "TV Movie" depending on runtime per movie/episode |
> | [ITUNMOVI](https://exiftool.org/TagNames/QuickTime.html#:~:text='iTunMOVI',iTunMOVI) | β MP4 | XML formatted `COPYRIGHT`, `ACTOR`, `DIRECTOR`, `PRODUCER` and `WRITER`; can be read as a tag/atom by Plex/Apple software |
> | WRITER | β | Custom tag following the format of `ACTOR`, `DIRECTOR` and `PRODUCER` |
>
> #### Settings -\> Remap -\> MKV
>
> | TAG NAME | EXISTING? | PURPOSE |
> | --- | --- | --- |
> | [CONTENT\_TYPE](https://www.matroska.org/technical/tagging.html) | β MKV | Proper formatting for `ITUNESMEDIATYPE` |
> | [EDITED\_BY](https://www.matroska.org/technical/tagging.html) | β MKV | Proper formatting for `EDITOR` |
> | [WRITTEN\_BY](https://www.matroska.org/technical/tagging.html) | β MKV | Proper formatting for `WRITER` |
>
> #### Settings -\> Remap -\> Maximum Compatibility
>
> | TAG NAME | EXISTING? | PURPOSE |
> | --- | --- | --- |
> | - | - | All tags available from Basic, MP4 and MKV as separate tags |
> **Tag Compatibility**
>
> #### Windows File Explorer
>
> | TAG NAME | COLUMN NAME | MP4 | MKV |
> | --- | --- | --- | --- |
> | - | Cover Art | | |
> | [ALBUM](https://docs.mp3tag.de/mapping/#album) | Album | β | |
> | [ALBUMSORT](https://docs.mp3tag.de/mapping/#albumsort) | Sort album | β | |
> | [ALBUMARTIST](https://docs.mp3tag.de/mapping/#albumartist) | Album artist | β | |
> | [ALBUMARTISTSORT](https://docs.mp3tag.de/mapping/#albumartistsort) | Sort album artist | β | |
> | [ARTIST](https://docs.mp3tag.de/mapping/#:~:text=RIFF%20INFO-,ARTIST,-Internal) | Contributing artists | β | |
> | [ARTISTSORT](https://docs.mp3tag.de/mapping/#artistsort) | Sort contributing artists | β | |
> | [COMMENT](https://docs.mp3tag.de/mapping/#comment) | Comments | β | β |
> | [COMPOSER](https://docs.mp3tag.de/mapping/#composer) | Composers | β | β |
> | [COMPOSERSORT](https://docs.mp3tag.de/mapping/#composer) | Sort composer | β | |
> | [DESCRIPTION](https://docs.mp3tag.de/mapping/#description) | Description | β | |
> | [COPYRIGHT](https://docs.mp3tag.de/mapping/#copyright) | Copyright | | β |
> | [DIRECTOR](https://docs.mp3tag.de/mapping/#:~:text=iTunes-,DIRECTOR,-%C2%A9dir) | Directors | | β |
> | [GENRE](https://docs.mp3tag.de/mapping/#genre) | Genre | β | β |
> | [KEYWORDS](https://www.matroska.org/technical/tagging.html) | Tags | | β |
> | [LAW\_RATING](https://www.matroska.org/technical/tagging.html) | Parental rating | | β |
> | [PRODUCER](https://www.matroska.org/technical/tagging.html) | Producer | | β |
> | [RELEASETIME](https://docs.mp3tag.de/mapping/#releasetime) | Date | | β |
> | [SUBTITLE](https://docs.mp3tag.de/mapping/#subtitle) | Subtitle / Episode name | | β |
> | [TITLE](https://docs.mp3tag.de/mapping/#title) | Title | β | β |
> | [TITLESORT](https://docs.mp3tag.de/mapping/#titlesort) | Sort title | β | |
> | [TRACK](https://docs.mp3tag.de/mapping/#track) | # | β | |
> | [TVEPISODE](https://docs.mp3tag.de/mapping/#:~:text=Total%20Track%20Number-,TVEPISODE,-tves) | Episode number | β | β |
> | [TVSEASON](https://docs.mp3tag.de/mapping/#:~:text=tvnn-,TVSEASON,-tvsn) | Season number | β | β |
> | [WRITTEN\_BY](https://www.matroska.org/technical/tagging.html) | Writers | | β |
> | [YEAR](https://docs.mp3tag.de/mapping/#year) | Year | β | |
>
> #### Apple Software (iTunes, Apple Music, Apple TV etc.)
>
> | TAG NAME | COLUMN NAME | MP4 | MKV |
> | --- | --- | --- | --- |
> | - | Cover Art | β | |
> | [ALBUM](https://docs.mp3tag.de/mapping/#album) | Album (iTunes/Apple Music) | β | |
> | [ALBUMSORT](https://docs.mp3tag.de/mapping/#albumsort) | Sort Album (iTunes/Apple Music) | β | |
> | [ALBUMARTIST](https://docs.mp3tag.de/mapping/#albumartist) | Album Artist (iTunes/Apple Music) | β | |
> | [ALBUMARTISTSORT](https://docs.mp3tag.de/mapping/#albumartistsort) | Sort Album Artist (iTunes/Apple Music) | β | |
> | [ARTIST](https://docs.mp3tag.de/mapping/#:~:text=RIFF%20INFO-,ARTIST,-Internal) | Artist (iTunes/Apple Music) / Director; not recommended as this can be accessed from `ITUNMOVI` | β | |
> | [ARTISTSORT](https://docs.mp3tag.de/mapping/#artistsort) | Sort Artist (iTunes/Apple Music) / Sort Director | β | |
> | [COMMENT](https://docs.mp3tag.de/mapping/#comment) | Comments | β | |
> | [COMPOSER](https://docs.mp3tag.de/mapping/#composer) | Composer (iTunes/Apple Music) | β | |
> | [COMPOSERSORT](https://docs.mp3tag.de/mapping/#composer) | Sort Composer (iTunes/Apple Music) | β | |
> | [DESCRIPTION](https://docs.mp3tag.de/mapping/#description) | Description | β | |
> | [GENRE](https://docs.mp3tag.de/mapping/#genre) | Genre | β | |
> | [GROUPING](https://docs.mp3tag.de/mapping/#grouping) | Grouping | β | |
> | [ITUNESADVISORY](https://docs.mp3tag.de/mapping/#:~:text=apID-,ITUNESADVISORY,-%5B1%5D) | Title π
΄ (iTunes/Apple Music) / Title π
² (iTunes); only in List view, `ITUNEXTC` will override this in iTunes | β | |
> | [ITUNESHDVIDEO](https://docs.mp3tag.de/mapping/#:~:text=iTunes%20Genre%20ID-,ITUNESHDVIDEO,-hdvd) | `HD` icon | β | |
> | [ITUNESMEDIATYPE](https://docs.mp3tag.de/mapping/#:~:text=video%20(0/1)-,ITUNESMEDIATYPE,-%5B3%5D) | Categorises file into Movie, TV Show or Home Videos on first import | β | |
> | [ITUNEXTC](https://exiftool.org/TagNames/QuickTime.html#:~:text='iTunEXTC',ContentRating) | Title `Rating` | β | |
> | [ITUNMOVI](https://exiftool.org/TagNames/QuickTime.html#:~:text='iTunMOVI',iTunMOVI) | Movie/episode overview; how Apple stores and displays `COPYRIGHT`, `ACTOR`, `DIRECTOR`, `PRODUCER` and `WRITER` | β | |
> | [PODCASTDESC](https://docs.mp3tag.de/mapping/#podcastdesc) | Movie/episode overview; more detailed version of the Description column | β | |
> | [TITLE](https://docs.mp3tag.de/mapping/#title) | Title | β | |
> | [TITLESORT](https://docs.mp3tag.de/mapping/#titlesort) | Sort Title | β | |
> | [TRACK](https://docs.mp3tag.de/mapping/#track) | Track (iTunes/Apple Music) | β | |
> | [TVEPISODE](https://docs.mp3tag.de/mapping/#:~:text=Total%20Track%20Number-,TVEPISODE,-tves) | Episode Number | β | |
> | [TVEPISODEID](https://docs.mp3tag.de/mapping/#:~:text=TV%20Episode-,TVEPISODEID,-tven) | Episode Code | β | |
> | [TVSEASON](https://docs.mp3tag.de/mapping/#:~:text=tvnn-,TVSEASON,-tvsn) | Season | β | |
> | [TVSHOW](https://docs.mp3tag.de/mapping/#:~:text=TV%20Season-,TVSHOW,-tvsh) | Show | β | |
> | [TVSHOWSORT](https://docs.mp3tag.de/mapping/#:~:text=Show-,TVSHOWSORT,-sosn) | Sort Show | β | |
> | [YEAR](https://docs.mp3tag.de/mapping/#year) | Year / Release Date | β | |
> **Limitations**
>
> As far as I'm aware, there's no other software that lets you save metadata directly into your media with data supplied from IMVDB. There are however limitations with this script to consider:
>
> - This is based on English, please let me know if any issues occur for other languages.
>
> - This can only make one query at a time so a script will retrieve tags for one music video. You can however batch/bulk tag multiple files with the same metadata.
>
> - Auto-tagging is not possible, you must search for your desired content then choose which tags to save (the search fields can enter _some_ data for you if already saved in your file like `TITLE`, `IMVDB`, `DIRECTOR` etc.).
>
> - [Sources](https://docs.mp3tag.de/tag-sources/) canβt save or manipulate external files so it canβt sort folder hierarchies, export XML or save/delete image files for you. This must be done manually or by using [Actions](https://docs.mp3tag.de/actions/)/[Export](https://docs.mp3tag.de/export/)/[Tools](https://docs.mp3tag.de/customization/options/tools/).
>
> - IMVDB does contain metadata that isn't retrievable through the API:
>
> - IMVDB doesnβt offer some metadata that other databases do:
>
> - IMVDB does offer metadata that I wasn't sure how to implement for media files:
>
> - IMVDB is subject to user contribution. For the most part it's a good resource however accuracy, translations and completion can vary even for popular content. If you notice any mistakes, it may be a good idea to update faulty data yourself using your account on IMVDB where possible.
>
> - User contributions also means data can constantly change, for newer content still in production and even with older completed entries. Due to this and other restrictions, I havenβt added support for certain metadata:
>
> - You can choose to map tags for **.mp4** or **.mkv** : it is completely up to you what video format you use. Look into what you use to play your media and how you organise/sort/find your media then work from there to decide:
>
> - I donβt own a Mac or Apple TV and have limited experience with Plex/Kodi/Emby/Jellyfin etc. However if any issues appear in the Mac version of Mp3tag or otherwise things don't seem right, please let me know and I will try to solve it regardless.
> **Changelog for v1.00.0 (Last updated: 17/05/2026)**
>
> ### 1.00.0
>
> [2026-05-17] v1.00.0 Initial release:
> [@arb]
>
> ###New files:
>
> - "IMVDB#Search or ID", search by title, artist or director
> tags or get data straight from source using IMVDB tag
> - "IMVDB#Search - Title", search by title only
> - "IMVDB#Search - Artist", search by artist only
> - "IMVDB#Search - Director", search by director only
> - "IMVDB#Results.inc", shared [ParserScriptAlbum] for .src's
> - "IMVDB#Settings.settings", configure .src's/.inc
> - "IMVDB#\_\_\_.ico" named per .src, icons for toolbar customisation
Please keep me up to date with any issues! π€
[Internet Music Video Database (IMVDB) v1.00.0.zip](https://community.mp3tag.de/uploads/short-url/1KnWZ31Pl5d9WMJosLYUqbeiurl.zip) (158.9 KB)
---
### Author:  [@arb](https://community.mp3tag.de/u/arb)
#### Post date: [October 10, 2026, 2:23pm UTC](https://community.mp3tag.de/t/ws-internet-music-video-database-imvdb/71292/2 "2026-10-10T14:23:27Z")
Sadly the source has stopped working and returns `403: Forbidden`, meaning the API key isn't being sent. I think previously the API didn't check for a key until a recent update to the website.
The only way is to [send the API key as part of a header](https://imvdb.com/developers/api#:~:text=com/api/v1-,API%20Headers,-Here%20are%20the) rather than a URL parameter, which Mp3tag doesn't currently give us the ability to do. I've reached out to the IMVDb developers but no response as of yet.
If there's any advice on work-arounds or solutions to get this working again, it'd be much appreciated as I was gearing up for more updates to this source. Until then, please could I ask this be moved into [Broken Web Sources](https://community.mp3tag.de/c/development/broken-web-sources/31).