Beta: tvOS/iOS Movie Extras

As of the latest TestFlight beta and Channels DVR Server Prerelease, movie extras are now scanned in from your personal media and available in the app to watch.

What are Movie Extras?

Movie extras are the bonus features that come with many movies. These can include:

  • Behind-the-scenes footage
  • Trailers
  • Featurettes
  • Interviews with cast and crew
  • Deleted scenes
  • Gag reels
  • And more!

Support & Organization Conventions

Channels scans in movie extras just like it has done for trailers for years. The same filename conventions apply, but there's some added support.

You can have as many extras per type of extra that you want, and you can provide a custom title for each extra, using the organization conventions.

Extra Type Definitions

The following types of extras are supported. The table below details the suffix and directory names that will be used to organize them. These are case sensitive.

Suffix Directory Name
behindthescenes Behind The Scenes
featurette Featurettes
interview Interviews
deleted Deleted Scenes
gagreel Gag Reels
scene Scenes
short Shorts
trailer Trailers
other Other
extra Extras
special Specials

Inline

You can place extras in the same directory as the movie file itself. For example:

/Movies
  The Avengers (2012).mp4
  The Avengers (2012)-trailer.mp4
  The Avengers (2012)-A Visual Journey-featurette.mp4
  The Avengers (2012)-Avengers Assemble-featurette.mp4
  The Avengers (2012)-Directors Roundtable-interview.mp4
  The Avengers (2012)-Meet the Cast-interview.mp4
  The Avengers (2012)-gagreel.mp4

The base name of the extra has to match the movie file's base name in order to pair them to the movie. The extra type suffix is always appended to the end of the filename before the extension.

You can optionally apply descriptive text in between the two, which will be scanned in and used as a title for presentation in the UI.

Subdirectories

You can also organize your movies into their own directories, with their extras grouped inside it to keep your main movies directory a little cleaner.

For example:

/Movies
  /The Avengers (2012)
      The Avengers (2012).mp4
      The Avengers (2012)-trailer.mp4
      The Avengers (2012)-A Visual Journey-featurette.mp4
      The Avengers (2012)-Directors Roundtable-featurette.mp4
      The Avengers (2012)-Meet the Cast-interview.mp4
      The Avengers (2012)-Avengers Assemble-featurette.mp4
      The Avengers (2012)-gagreel.mp4

Extra Directories

You can also place extras into their own directories, which can be useful if you have a lot of extras for a particular movie. The directory name must match the the table names listed above.

Only use descriptive text in the filename when using this strategy, as the extra type is derived from the directory name.

When your movies are contained in their own directory, you can combine both strategies.

For example:

  /The Avengers (2012)
      The Avengers (2012).mp4
      The Avengers (2012)-trailer.mp4
      The Avengers (2012)-gagreel.mp4
      /Featurettes
          A Visual Journey.mp4
          Avengers Assemble.mp4
      /Interviews
          Meet the Cast.mp4
          Directors Roundtable.mp4

Scanning Them In

After you have added extras to your movie directories, refresh your movie's metadata via your Channels DVR Server's web admin. Your extras will be detected and displayed on the movie's page at the bottom in the Extras section.

If you your files already follow these naming conventions, you may already see your extras after updating to the latest pre-release.

Extras in Channels

When your movie has extras, they will be displayed in an Extras row below Credits. You can simply select one to watch it.

Trailers are not displayed in this list and instead are used to display the Trailer button on the movie's page (the popcorn button).

Only a single trailer is used, and Channels will choose the first one it finds within your extras.

The Match Content for Trailers setting has been renamed to Match Content for Extras and will affect the playback of both trailers and all extras.

Help & Feedback

Please give this a go and report any issues or feedback in this thread.

If you are having issues scanning in extras, please provide a sample filename and directory structure that you are using.

Have fun!

7 Likes

Thanks so much for adding this feature! It's been at the top of my wish list.

Any chance we could have an option to resume extras? Not an issue for most of them since they are often short, I just have a lot of lengthy ones (I have a lot of Criterion Collection & collectors edition movies) and sometimes those extras are over an hour or more in length so I don't always watch in one sitting. Just thought I would ask.

Love how they are presented!

With this initial delivery of extras, there won't be any progress tracked, so we won't be able to that. But we'll keep it in mind for the future.

2 Likes

Thanks! Great initial release, appreciate the addition!

Thanks so much!

Can there be a file extension filter so things like metadata files (.nfo) do not show up as playable? I have those additional files to keep information about each extra along with the main movie file. The metadata files for the main movie file are ignored already.

Are you saying it is detecting .nfo files as extras?

:thinking: It should only be capturing files with these extensions: "avi", "mp4", "mkv", "mov", "webm"

Please give an example of your filenames and directory structure, as instructed in the original post.

1 Like

root@channels:/mnt/syno_nfs/movies/Blazing Saddles (1974)# ls -lR
.:
total 7702032
-rw-rw-r-- 1 media users 7885176465 Jan  3  2019 'Blazing Saddles (1974) - HEVC.mkv'
-rw-rw-r-- 1 media users     993629 Feb  7  2021  clearlogo.png
drwxrwxrwx 1 media users         36 Aug 26 13:02 'Deleted Scenes'
-rw-rw-r-- 1 media users     191675 Feb  7  2021  fanart.jpg
drwxrwxrwx 1 media users        328 Aug 26 13:16  Featurettes
-rw-rw-r-- 1 media users     512244 Feb  7  2021  poster.jpg
drwxrwxrwx 1 media users         44 Dec 11  2018  Trailers

'./Deleted Scenes':
total 572032
-rw-rw-r-- 1 media users 585757539 Dec 11  2018 'Deleted Scenes.mkv'

./Featurettes:
total 612488
-rw-rw-rw- 1 media users 215350435 Jan  4  2019 'Back In The Saddle.mkv'
-rw-rw-rw- 1 media users      1297 May  2  2021 'Back In The Saddle.nfo'
-rw-rw-rw- 1 media users 196505967 Jan  4  2019 'Black Bart Tv Pilot.mkv'
-rw-rw-rw- 1 media users      1295 May  2  2021 'Black Bart Tv Pilot.nfo'
-rw-rw-r-- 1 media users 215310620 Dec 11  2018 'Intimate Portrait - Madeline Kahn.mkv'
-rw-rw-r-- 1 media users      1343 May  2  2021 'Intimate Portrait - Madeline Kahn.nfo'

./Trailers:
total 129748
-rw-rw-r-- 1 media users 132861015 Dec 11  2018 'Theatrical Trailer.mkv'
1 Like

Ah, great. It doesn’t look like we’re filtering by extension when looking through directories.

Good catch. We’ll get it fixed up.

3 Likes

Excellent! Thank you very much!

I hope that TV Extras are on the radar as well. I have many episode-level extras that just get matched as the episode, which really skews virtual channels.

1 Like

I would like to add supporf for TV show extras at season and episode levels.

1 Like

I have Pre-release server 2025.08.26.1317. I am using subdirectory named "Extras" to put ripped movie extras into it, but I am not having anything show up.

2 Likes

See first post

2 Likes

I am having trouble having Movie Extras show up in beta. I use the following structure:

  1. Main folder-Showtime (2002)

{6ABF31FE-EDC4-4124-942A-3E0BF744FACE}

2.) Next folder (after clicking)-Main movie file titled Showtime (2002) and a folder named Extras.
{95DB8FB4-9626-46CE-BC74-728D99F84586}

3.) Inside the folder called Extras, I have my movie extras named as follows:

1 Like

I tried the in-line method. Showtime (2002)-Audio Commentary-featurette and it is showing up under extras. However, it will not show the name "Audio Commentary". I also realized that it is case-sensitive, so if you capitalize the "F" in the word featurette, then it will not show up.

1 Like

It will show it on the server page on my PC as shown below, but the name "Audio Commentary" will not show on Iphone/Ipad apps.

{F60EB9F4-D2ED-45C3-9C32-70EE3B3F9603}

1 Like

Yes, this is a bug, we'll fix it up.

2 Likes

Thanks. Love the progress and the responsiveness. Excited for all the enhancements!

So you're saying this isn't working with the nested directories?

so you have:

/movies
  /Showtime (2002)
      Showtime (2002).mkv
      /Extras
          The Making of Showtime.mp4
          Theatrical Trailer.mp4

And they aren't showing up? In testing this myself, this does in fact work.

1 Like

This should be resolved in the latest pre-release:

2 Likes