Guide Early alpha

Disc menus, made simple

For Jellyfin servers · Aster Disc plugin 0.7

Remember putting a DVD in? Before the movie started, you got a menu: Play Movie, Scene Selection, Special Features. When you copy a disc to your server, that menu gets left behind. Disc menus bring it back.

A disc menu in Aster, made for Big Buck Bunny (the free open movie from the Blender Foundation).

How it works

There are three pieces, and each has one job:

  1. The menuA small file that describes the menu: which movie it's for, what the buttons say, and what it looks like. Think of it as a recipe. It doesn't contain the movie.
  2. The pluginAster Disc runs on your Jellyfin server. It reads the recipe, finds that movie in your library, and connects each button to the right video.
  3. AsterShows the menu on your TV, phone or Mac, and plays whatever you pick.

Because a menu is just a recipe, people can share them. Someone makes a great menu for a movie, and anyone who owns that movie can use it.

What you need

Disc menus only work with Jellyfin servers, not Emby or Plex.

Step 1: Install the plugin

  1. In Jellyfin, open Dashboard ▸ Plugins ▸ Repositories and add this address: https://raw.githubusercontent.com/AsterMediaPlayer/aster-companion-plugins/main/manifest.json
  2. Open the Catalogue, find Aster Disc, and install it.
  3. Restart Jellyfin.

You'll now see three new pages in the dashboard's sidebar: Aster Disc (settings and status), Menu Catalogue (menus other people made) and Menu Editor (make your own).

If you're signed in to Aster as a Jellyfin administrator, Aster can also install the plugin for you.

Step 2: Get a menu

Pick whichever way suits you. Start with the first one: it's the easiest.

A. Use one someone else made Easiest

Open Menu Catalogue. It lists menus from the community catalogue and shows which ones are for movies you have. Click Install next to one. That's it.

Your library is never sent anywhere: the check for which movies you have happens on your own server.

B. Let the plugin start one for you

Open Menu Editor, press New…, and search for the movie. For a movie, choose the starter menu, and the plugin builds one from what you already have: a Play button, a Scene Selection button if the movie has chapters, and a button for each special feature it finds.

It's plain to begin with. You can dress it up next. For a TV series, start with an empty menu instead.

C. Make one from scratch

Same as B, but choose the empty menu. You get a single Play button and a blank page to design however you like.

Step 3: Check it worked

Open the Aster Disc page. The Menu Files table lists every menu and how it's doing:

It saysWhat it means
BoundAll good. The menu found its movie and is ready to watch.
Waiting for the titleThe menu is fine, but that movie isn't in your library, or Jellyfin hasn't recognised it yet. Add the movie and it connects by itself.
Needs reviewIt found the movie but couldn't connect everything, often because you have two copies of it. See Troubleshooting.
Not used (another menu wins)You have two menus for the same movie, and only one of them is used. Remove the one you don't want.

Just added something? Press Scan now to check again straight away.

Step 4: Watch it

Open the movie in Aster. When a movie has a disc menu, you can open it from the movie's page, then move around it and pick what to play.

In Jellyfin's own web app, a movie with a menu gets a Disc Menu button.

Making a menu your own

Open Menu Editor and pick your menu. On one side is the menu's settings; on the other is a live preview that works exactly like the real thing. Click around in it to try your menu.

Press Save when you're happy. Made a mistake? Ctrl+Z undoes it, and every save keeps a backup you can go back to.

Want to go further? The full menu reference explains everything a menu can do.

Special features and scenes

Special features

The Special Features buttons play the extras that came with your movie: behind-the-scenes, deleted scenes, trailers and so on. For these to work, Jellyfin has to know they're extras, which usually means putting them in folders like Featurettes or Deleted Scenes next to the movie. Jellyfin's guide lists the folder names.

The plugin connects each button to the right extra by what kind of extra it is and how long it runs. It never looks at file names, so a shared menu works however you named your files.

Scene selection

The Scene Selection screen is made from your movie's chapters, one button per chapter. To get a little picture on each button, run Extract chapter images in Jellyfin's Scheduled Tasks. Without it, the buttons show the chapter name and time.

Good to know

Troubleshooting

I don't see the menu for my movie.

Check the Menu Files table on the Aster Disc page. If it says Waiting for the title, Jellyfin hasn't matched the movie yet: open the movie in Jellyfin, choose Identify and pick the right one. Then press Scan now.

It says Needs review.

The most common reason is having the same movie twice, for example a DVD and a Blu-ray copy. The plugin won't guess which one you mean. Removing the extra copy from your library fixes it. To keep both, the menu reference explains how to pick one by hand.

A special features button doesn't play anything.

The plugin couldn't find a matching extra. Check the extra is in Jellyfin's extras folders, and that it's the same length as the one on the disc the menu was made from: a different cut won't match. Try Auto-Match on the Aster Disc page. In your own menus, you can point the button at a different extra in the Menu Editor.

Scene Selection has no pictures.

Run Extract chapter images in Jellyfin's Scheduled Tasks, then reopen the menu.

The editor won't save.

It shows what's wrong next to the problem: click the message to jump to it. The editor won't save a menu that wouldn't load, so nothing you save can break.

Words you'll see

Menu file
The recipe for one menu. Its name ends in .menu.json.
Bound
The menu has found its movie and connected its buttons.
Extras
Bonus videos that come with a movie, like behind-the-scenes or deleted scenes.
Chapters
Bookmarks inside a movie file. Scene Selection is built from them.
Catalogue
The shared collection of menus people have made, ready to install.

Still stuck? See the support page or email [email protected].