Media stubs

From Official Kodi Wiki
(Redirected from Disc stubs)
Jump to navigation Jump to search
Home icon grey.png   ▶ Video library ▶ Management ▶ Media stubs


  • If you have a collection of DVD's and Bluray disks but do not want to rip them to a hard drive, then a Media Stub File allows you to add the collection of disks to the Kodi Video Library.
  • It is a simple text based file that is added to your Source in exactly the same way as any other Movie or TV Show, which is then scanned or scraped into the library.

Note: v18 and earlier required an installed and working optical drive to use this feature. From v19 and later, this requirement has been removed. [1]


The Media Stub File is a simple text file with the extension .disc instead of .txt extension. Once the file is saved correctly, Kodi will see this file as an unplayable media file.

  1. Create a blank text file and rename the filename in accordance with proper Movie and TV Show Naming Conventions.
  2. Rename the extension to .disc
  3. Place the file in the Source as you would any other movie in your Source.

  • Example 1- Media Stub file in a movie folder with local artwork, actors, Extras, NFO File, theme etc.
  • Example 2- Media Stub file without local information and ready for scraping.


Once the title is scanned into the library, it will be visible in the same way as any other title in the library. To view the title for playback...

  1. Select Play
  2. A box will display requesting you to insert the disk (as shown in the below image)
  3. Once the disk is inserted, press Play to commence playback.


The basic Stub File will display the default message Please insert the following disc: <movie name>

It is possible to add messages to the pop up box as shown in the above image. The above image uses the following code placed inside the stub file.

Note: Longer messages will automatically scroll.

  <title>Rogue Assassin aka WAR</title>
  <message>Released as Rogue Assassin in Australia, but as WAR globally
Bluray located in Storage 3, Drawer 2
Add what you like to the message.</message>
  • The <discstub></discstub> tag is required if using either of the next two tags
  • The <title></title> tag is optional and can be used to display an alternate name
  • The <message></message> tag is optional. Use only one set of <message> tags as multiples are ignored.

Adding/Removing File Extensions

This modification requires inserting the following code into the Advancedsettings.xml file.

The default filename extension for Disc Stubs is:


Using the following tags, it is possible to <add> additional or <remove> existing disc stub extensions to better suit your requirements.



Return to top