Hello! I've been maintaining the TMDb web source for a while and found another very similar database tailored to music videos:
The website's search engine is very good: it lets you search by the title, artist and/or director 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 on how to navigate to Mp3tag’s configuration folder.
-
There's three different files that make up a web/tag source:
- .src’s are the basic files that lets you search for data then adjust it into usable tags for your files.
- .inc contains extra code that is shared across .src’s to save space.
- .settings lets you configure a web source with options.
-
From your IMVDB zip file, copy over all files into the sources folder. Please do not rename or remove
IMVDB#Results.incandIMVDB#Settings.settingsas they are essential for the web source to work. -
This requires a IMVDB API key, though registration is pretty easy. You then need to paste it into every .src file you use:
- Open each .src you have copied over using any basic text editor (Right click → Open with… → Notepad).
- In each .src, find
!!!YOUR_API_KEY!!!in[IndexUrl]and replace it with your API key (40 characters long).
-
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. 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 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 | MKV |
Cast of a music video |
| ALBUMARTIST | |
Main musician/band |
| ARTIST | |
All musicians including album/featured artists |
| COMMENT | |
Can be used for anything; used to list metadata that isn't displayed or indexed by file explorers |
| COPYRIGHT | |
Combination of TVNETWORK and PUBLISHER |
| COUNTRY | MKV |
Production country as text |
| COUNTRYID |  |
Custom tag for origin country as ISO 3166-1 |
| DIRECTOR | MP4 |
Director and co-directors |
| ERROR: |  |
Only used to inform of errors, please uncheck |
| INVOLVEDPEOPLE | |
Job:Person 1;Job:Person 2 (Complete list of credits for a music video) |
| ORIGTITLE | |
Custom tag based on 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 | MKV |
Producer or co-producers |
| RELEASETIME | |
YYYY-MM-DD |
| TITLE | |
Title of music video |
| IMVDB | |
Custom tag based on TMDB/IMDB |
| IMVDBURL | |
Custom tag based on TMDBURL/IMDBURL |
| 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 | 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 | 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 | MKV |
Proper formatting for ITUNESMEDIATYPE |
| EDITED_BY | MKV |
Proper formatting for EDITOR |
| WRITTEN_BY | 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 | Album | |
|
| ALBUMSORT | Sort album | |
|
| ALBUMARTIST | Album artist | |
|
| ALBUMARTISTSORT | Sort album artist | |
|
| ARTIST | Contributing artists | |
|
| ARTISTSORT | Sort contributing artists | |
|
| COMMENT | Comments | |
|
| COMPOSER | Composers | |
|
| COMPOSERSORT | Sort composer | |
|
| DESCRIPTION | Description | |
|
| COPYRIGHT | Copyright | |
|
| DIRECTOR | Directors | |
|
| GENRE | Genre | |
|
| KEYWORDS | Tags | |
|
| LAW_RATING | Parental rating | |
|
| PRODUCER | Producer | |
|
| RELEASETIME | Date | |
|
| SUBTITLE | Subtitle / Episode name | |
|
| TITLE | Title | |
|
| TITLESORT | Sort title | |
|
| TRACK | # | |
|
| TVEPISODE | Episode number | |
|
| TVSEASON | Season number | |
|
| WRITTEN_BY | Writers | |
|
| YEAR | Year | |
Apple Software (iTunes, Apple Music, Apple TV etc.)
| TAG NAME | COLUMN NAME | MP4 | MKV |
|---|---|---|---|
| - | Cover Art | |
|
| ALBUM | Album (iTunes/Apple Music) | |
|
| ALBUMSORT | Sort Album (iTunes/Apple Music) | |
|
| ALBUMARTIST | Album Artist (iTunes/Apple Music) | |
|
| ALBUMARTISTSORT | Sort Album Artist (iTunes/Apple Music) | |
|
| ARTIST | Artist (iTunes/Apple Music) / Director; not recommended as this can be accessed from ITUNMOVI |
|
|
| ARTISTSORT | Sort Artist (iTunes/Apple Music) / Sort Director | |
|
| COMMENT | Comments | |
|
| COMPOSER | Composer (iTunes/Apple Music) | |
|
| COMPOSERSORT | Sort Composer (iTunes/Apple Music) | |
|
| DESCRIPTION | Description | |
|
| GENRE | Genre | |
|
| GROUPING | Grouping | |
|
| ITUNESADVISORY | Title 🅴 (iTunes/Apple Music) / Title 🅲 (iTunes); only in List view, ITUNEXTC will override this in iTunes |
|
|
| ITUNESHDVIDEO | HD icon |
|
|
| ITUNESMEDIATYPE | Categorises file into Movie, TV Show or Home Videos on first import | |
|
| ITUNEXTC | Title Rating |
|
|
| ITUNMOVI | Movie/episode overview; how Apple stores and displays COPYRIGHT, ACTOR, DIRECTOR, PRODUCER and WRITER |
|
|
| PODCASTDESC | Movie/episode overview; more detailed version of the Description column | |
|
| TITLE | Title | |
|
| TITLESORT | Sort Title | |
|
| TRACK | Track (iTunes/Apple Music) | |
|
| TVEPISODE | Episode Number | |
|
| TVEPISODEID | Episode Code | |
|
| TVSEASON | Season | |
|
| TVSHOW | Show | |
|
| TVSHOWSORT | Sort Show | |
|
| 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,DIRECTORetc.). -
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/Export/Tools.
-
IMVDB does contain metadata that isn't retrievable through the API:
- genres
- keywords/#hashtags
- trivia
- products
- technical details (aspect ratio, runtime etc.)
- trailers, parodies, lyrics videos
-
IMVDB doesn’t offer some metadata that other databases do:
- localised metadata by language/region
- descriptions (i.e. synopses, overviews, outlines)
- content ratings
- lyrics, subtitles or closed captions
-
IMVDB does offer metadata that I wasn't sure how to implement for media files:
- behind the scenes (including Instagram posts)
-
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:
- user ratings (better leaving that for scraping)
- technical details like a file’s resolution (most software reads this natively anyway).
-
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:
- MP4 is more widely supported by all operating systems.
- Apple products only use MP4, not MKV.
- Certain MP4 metadata such as tags/keywords, content rating, directors, copyright etc. is editable from Windows File Explorer and other software, sadly not via Mp3tag.
- MKV has technical advantages with packaging multiple audio tracks, video tracks, subtitles and even fonts in one file.
- Most media libraries support scraping using MKV's, not MP4
- MKV metadata is barely used by anything.
-
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 (158.9 KB)