Skip to content
Richard edited this page Mar 24, 2023 · 42 revisions

Welcome to the MediaInfo for Emby wiki Page

image

THIS PLUGIN WILL REPLACE EMBEDDED TRACK TITLES TO YOUR MKV FILES THIS WILL ONLY WORK ON MKV FILES


1. Initial Setup

1.1 - Downloading Software - Links are provided on the MediaInfo Plugin Settings Page

For more Help on your specific system - PLEASE CHECK HERE

If you wish to contribute a guide to help other users, head to the forums and add your guide

image

First you will need to download MediaInfoCLI - it must be CLI version as the GUI version will not process the files. Example for Windows.

image

Then Download MKVToolNix PORTABLE - this is available in the windows store for a small fee or use the link provided.

image

Once downloaded, Select the file paths in the plugin to point to the respective files and Click save

Linux users may need to give elevated access rights for these to work.

image


2. Settings

Toggling the switches will autosave the selection (No need to click SAVE)

2.1 - Global Option to Enable MediaInfo.

image

With this enabled - the plugin will automatically set your settings to "Prefer Embedded Titles" - See Point 8 Below

Disabling this, is like removing the plugin, except it stays on your server and keeps your settings. Disabling this will also hide the Task in the Schedule Task Menu

2.2 - Auto Run Options

image

This will automatically run the library scan after MediaInfo task has completed.
If you have Real Time Monitoring enabled. The results will start to process in the background, however I have found that completing the Library scan ensures that all embedded titles have been updated in the Emby Client UI.

Real Time Monitoring - Once Emby has detected a new item has been added - MediaInfo Plugin will wait 3 minutes before it starts to process the file... these 3 minutes just allow Emby to finish up what it needs to do.

2.3 - Library Selection Options

Use the + to select which libraries are used for processing. This will only work on Types Movie and Episodes, this will not run on music or anything else that isn't in a Movie or TV Series Library. Scroll up/down to see all the libraries you have added if you have many.

https://github.com/Cheesegeezer/MediaInfoWiki/blob/main/lib_sel.jpg

2.4 - Item Tagging

Using this option will ADD the specialist Audio and Video details as Emby Tags to the item. These can then be used to further sort or filter items.

https://github.com/Cheesegeezer/MediaInfoWiki/blob/main/tagging.jpg

2.5 - Video Display Settings

These settings will adjust how the overall look will be displayed on your Emby Client image

For Example this is with all settings On for video

image

image

image

image

2.6 - Audio Settings

image

Abbreviate Names - This is mainly for AndroidTV or FireTV where there is limited space for displaying the track info. It uses some Abbreviation on Full names to shorten them. TrueHD will be shortened to THD for example. Some of the abbreviations are outside of the Plugin control such as the word 'Digital' - thus Dolby Digital 5.1 becomes Dolby 5.1 and Dolby Digital 5.1 Plus becomes Dolby Plus

Show Sample Rate - For the Audiophiles out there - Add the Sample Rate to the Audio Codec.

Show Bit Depth - For the Audiophiles out there - Add the Bit Depth to the Audio Codec.

Show the Default Track - If there is more than one Audio Track in the container, this will show which track is the default one. ie the one that will play without any manual selection. However, if there is only one Audio track in the file, even with this setting on, (Default) will not be shown to conserve space.

RBJTech Style Formatting - This puts the channels after the Codec followed by the Extensions for Audio Tracks in Square Brackets. For example, it will shows Dolby THD 7.1 [Atmos] instead of Dolby TrueHD Atmos 7.1. It's also a format that has been tested on Fire TV and Android TV to ensure that all named tracks display correctly in the limited space available.

2.7 - Exclude List

If you wish to exclude an Item from either a Reset, Refresh or initial update - then just add that Items unique emby Id into the list. For more than one item, separate them by commas. This is particularly useful if you wish to keep your own titles or for Imax Enhanced DTS:X tracks where there is a fault in correctly identifying the DTS:X track (mediaInfo issue not this plugin issue)

https://github.com/Cheesegeezer/MediaInfoWiki/blob/main/exclude.PNG

The Item Id can be found in a browser by looking at the browser address bar -

https://github.com/Cheesegeezer/MediaInfoWiki/blob/main/id.PNG

2.8 - Reprocess Items

As the name suggests, this is a way to reprocess an item(s) if the MKV attributes have changed. ie you have modified the video and/or audio attributes of the file. Add via as CSV if there are multiple entries. Use the Item Id.

https://github.com/Cheesegeezer/MediaInfoWiki/blob/main/reprocess.jpg

2.9 - Reset Options

image

The Main option here while you test to get it how you want to look is the REFRESH. This will clear the stored list(so items don't get reprocessed everytime) and just overwrite the existing embedded.

If you want to remove all the embedded track titles from your files, run the RESET option to clear them.

2.10 - MKV Version Check Overwrite

A check has been added to verify a known working version of MKVPROPEDIT. A previous version of this external app was released which destroyed the MKV header and thus we have blacklisted this version. However, for all NEW versions of MKVPROPEDIT since the plugin release, we are unable to verify it's function - thus, if you wish to use the very latest (to note, there is no need to, it will not add any functionality to this plugin ..) then you need to check this box to confirm you are now responsible for any testing ! Our recommendation is just keep a separate known working version and point the plugin to that during the setup.

https://github.com/Cheesegeezer/MediaInfoWiki/blob/main/mkvcheck.jpg


3. Running the Schedule Task

image

Once you have set all your options, Run the Schedule task. You can also edit the triggers and intervals to set it to run at set periods (Like normal)


4. Getting the titles to Display in Emby UI Clients

If MediaInfo Plugin global Enabled is set to on. The below setting is automatically set to ON (To mainly help simplify the input requirement from the user).

image

Just need to select Prefer Embedded Titles, which is from the Library setting and advanced Tab

4.1 - Android TV Specific Configuration (Playback Settings > Pre-Playback Media Selections)

Android TV (such as the Nvidia Shield) has an extra configuration that defaults to ON that shows the results of the Plugin -

https://github.com/Cheesegeezer/MediaInfoWiki/blob/main/Screenshot_20230317-133915.png

When selected, this shows the Title -

https://github.com/Cheesegeezer/MediaInfoWiki/blob/main/Screenshot_20230317-133827.png

If this is not selected, then the 'Title' information will not be shown -

https://github.com/Cheesegeezer/MediaInfoWiki/blob/main/Screenshot_20230317-134130.png

5. Failed Items

If updating the MKV fails for whatever reason (usually because the file is locked) then the Plugin will not add it to the processed list and thus it will try again on the next scheduled run.

If you note that an item has repeatedly not updated - then please look in the emby log for details of the failure - it will show as a 'Warn' log type - and then check emby has write access to that MKV file.

6. Known Issues

11.1 - Docker - 09/11/2022 - Now resolved - See here