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.
How it works
There are three pieces, and each has one job:
- 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.
- 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.
- 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
- A Jellyfin 12 server, and an administrator account on it.
- The movie in your Jellyfin library. Jellyfin usually recognises it on its own; the plugin uses that to find it.
- A few minutes. Disc menus are in early alpha: they work, but expect some rough edges.
Disc menus only work with Jellyfin servers, not Emby or Plex.
Step 1: Install the plugin
- In Jellyfin, open Dashboard ▸ Plugins ▸ Repositories and add this address:
https://raw.githubusercontent.com/AsterMediaPlayer/aster-companion-plugins/main/manifest.json - Open the Catalogue, find Aster Disc, and install it.
- 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 says | What it means |
|---|---|
| Bound | All good. The menu found its movie and is ready to watch. |
| Waiting for the title | The 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 review | It 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.
- Change a button: pick it in the list on the left, then change its words or what it plays in the form underneath.
- Move things around: press Arrange, then drag buttons and pictures around the preview.
- Pick a background: use a picture of the movie from your library or from TMDB, upload your own, choose a plain colour, or loop the movie's trailer behind the menu.
- Add music and sounds: play the movie's theme song, upload a track, and choose a click or chime for the buttons.
- Need more room? Open full size opens the editor in its own window.
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
- Menus are safe to share. A menu only describes buttons and looks. It never includes your file names, folders or server details, and it can't contain programs.
- Pictures and sounds you upload are public. Anyone who can reach your server and knows the exact address can open them. Only upload things you're allowed to share.
- Don't share studio artwork, music or video in menus you give to other people.
- Anime works too, including libraries run by Shoko and Shokofin.
- Some backgrounds load from the internet. TMDB pictures come from TMDB's servers, and trailer backgrounds can come from YouTube. Pictures from your own library or your own uploads don't.
- Optional: fanart.tv pictures. Paste a free fanart.tv key on the Aster Disc page to choose from fanart.tv's artwork in the editor with the Fanart… button.
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].
