Guide
Making TV channels
For Jellyfin and Plex servers
In short: a channel is a Jellyfin video playlist with a few tags on it. Tag a playlist aster:channel and aster:number=101, and Aster plays it like live TV on channel 101, on a schedule every device sees the same.
On Plex? The same settings go in the playlist's description instead of its tags. The Channel Builder writes them for you: see Channels on Plex.
Make your first channel
Any video playlist can become a channel. Every way of making one writes the same tags to the same playlist, so you can mix them, and switch between them whenever you like.
In Aster
Create and edit channels from the Channels screen. Aster writes the tags for you.
In the Jellyfin dashboard
Install the free Aster Channels plugin, then open Dashboard ▸ Channels and choose New Channel. Start from a show, a genre, a network, a collection or one of your playlists. Pick a channel in the list to change its settings, and drag channels up or down to renumber them.
The plugin is optional. If you uninstall it, your channels keep working.
By hand, with tags
- In Jellyfin, make a playlist and add the episodes or movies you want on the channel. A playlist can also start empty and be filled automatically by a genre, network or collection.
- Open the playlist, choose Edit Metadata, and find Tags.
- Add the tag
aster:channel, and a channel number such asaster:number=101. Save. - Open Channels in Aster. The playlist is now channel 101.
Other people on your server only see a channel if its playlist is shared with them or public. Channels made with the plugin's New Channel are public.
Channels on Plex
Plex playlists don't have tags, so on Plex a channel's settings go in the playlist's description (Plex calls it the Summary), as one line: aster:channel, aster:number=7, aster:mode=shuffle. They're the same settings as below, separated by commas.
The easiest way is the Channel Builder: fill in a form, then copy the line into the playlist's description in Plex (open the playlist, choose Edit, and paste). Sign in with Plex there to pick names from your library, see and change what's in a playlist, or create a new channel in one step.
Commercial breaks aren't available on Plex channels yet, and a Plex playlist is only seen by the account that made it.
How channel tags work
Every channel setting is a tag on the playlist, written as aster:, the setting's name, = and a value:
aster:channel
aster:number=101
aster:mode=blocks
aster:genre=Comedy
- Upper and lower case don't matter:
aster:Mode=Blocksworks too. - A setting you leave out uses its default, shown in the tables below. So does a value Aster doesn't understand, such as
aster:mode=random. - Some settings take a list. You can add the tag once per item, or separate items with commas in one tag, as noted below.
- Tags from before the app was renamed, starting
asterfin:, still work. - Your own tags on the playlist, without
aster:, are left alone.
The basics
| Tag | What it does | Values |
|---|---|---|
| aster:channel | Makes the playlist a channel. Set it to off to hide the channel without losing its settings; turn it back on and everything comes back. | On its own means on. off hides it. |
| aster:number | The channel number, like 4 or 101. The guide lists channels in number order. Channels without a number go after the highest one, in name order. Try not to give two channels the same number. | A whole number above 0. |
| aster:channel-name | What the channel is called in the guide. | Any text. Default: the playlist's name. |
| aster:group | Puts the channel in a group in the guide, such as Kids or Movies. Groups appear in order of their lowest channel number. | Any text. Default: no group. |
| aster:logo | Uses the playlist's picture as the channel's logo in the guide. To change the logo, change the playlist's image in Jellyfin. | on or off. Default: off. |
| aster:user | Only these people see the channel in Aster. This only hides it in Aster: whoever the playlist is shared with can still open it in Jellyfin. | Jellyfin user names, separated by commas. Default: everyone. |
How a channel picks what plays
A channel's schedule is worked out the same way on every device, so everyone watching sees the same thing at the same time, just like real TV.
| Tag | What it does | Values |
|---|---|---|
| aster:mode |
How the channel picks what plays next:
| Default: rotation. |
| aster:blocks | In blocks mode, how many episodes of a show play before the next show gets a turn. Each time, the channel picks a number between the two you give. | A range like 3-6, or one number. 1 to 20. Default: 2-4. |
| aster:reshuffle | How long a shuffled order lasts before the channel mixes it up again. With day, tomorrow's lineup is different from today's. Weeks start on Monday, and months on the 1st. | day, week or month. Default: day. |
| aster:seed | Don't like the lineup? Change this number to deal a brand new one, for every device at once. | A whole number. Default: 0. |
| aster:weight | Makes a show come up more often. Friends:2 gives Friends twice as many turns as the other shows. Add one tag per show. | The show's name, a colon and 1 to 5. |
Filling a channel automatically
Besides what's in the playlist itself, a channel can add everything from a genre, a network or a collection. New things you add to your library show up on the channel by themselves. The other settings here narrow down what the channel plays.
| Tag | What it does | Values |
|---|---|---|
| aster:genre | Adds every movie and show in a genre, like Horror or Comedy. Add more than one to mix them. | Genre names, separated by commas. |
| aster:type | Whether the genres add movies, shows, or both. | all, movies or shows. Default: all. |
| aster:network | Adds every show from a TV network or movie studio, like NBC or Pixar. | One name per tag, since studio names can contain commas. |
| aster:collection | Adds everything in one of your Jellyfin collections, like a Star Wars collection. | One name per tag. |
| aster:library | Only takes titles from these libraries. | Library names, separated by commas. Default: all libraries. |
| aster:years | Only plays things that came out between these years. Handy for an 80s or 90s channel. | A range like 1980-1989, or one year. Default: any year. |
| aster:rating | Only plays things with these age ratings, like G and PG for a kids' channel. | Ratings, separated by commas. Default: any rating. |
| aster:min-length | Skips anything shorter than this. | Minutes, 1 to 600. Default: no limit. |
| aster:max-length | Skips anything longer than this. For example, 30 keeps movies off a cartoon channel. | Minutes, 1 to 600. Default: no limit. |
The corner logo
Like real TV channels, a channel can show its logo faintly in a corner while you watch. It uses the playlist's picture.
| Tag | What it does | Values |
|---|---|---|
| aster:bug | Shows the logo in a corner while the channel plays. | on or off. Default: off. |
| aster:bug-location | Which corner the logo sits in. | top-left, top-right, bottom-left or bottom-right. Default: bottom-right. |
| aster:bug-size | How big the logo is. 100% is the normal size. | 25% to 300%. Default: 100%. |
| aster:bug-opacity | How see-through the logo is. Lower is more see-through; 100% is solid. | 5% to 100%. Default: 45%. |
| aster:bug-hide | Hides the logo after this many seconds. It comes back when you tune in again or the next programme starts. | 1 to 3600 seconds, or off. Default: off (it stays). |
Commercial breaks
Breaks are short clips that play between programmes, like commercials on real TV. Setting them up takes two steps: a playlist of clips, and a few tags on the channel.
1. Make a filler playlist
- Make a Jellyfin playlist of short clips, and tag the playlist
aster:filler. - Tag each clip in it with what it is. A clip without one of these tags is never played.
| Clip tag | What it is |
|---|---|
| aster:commercial | Ads, like real TV commercials. |
| aster:promo | Ads for other shows, like "Coming up next…". |
| aster:trailer | Movie trailers. |
| aster:bumper | Short "We'll be right back" and "Now back to the show" clips. |
| aster:interstitial | Anything else short: music videos, cartoon shorts, public service ads. These also fill gaps when lining programmes up to the clock. |
2. Turn on breaks for a channel
A channel only has breaks once it names a filler playlist. The other break settings do nothing without one.
| Tag | What it does | Values |
|---|---|---|
| aster:filler-playlists | Which filler playlist the breaks take their clips from. Add the tag again for each extra playlist. | One playlist name per tag. Default: no breaks. |
| aster:filler-types | Which kinds of clips this channel plays in its breaks. | commercials, promos, trailers, bumpers, interstitials, separated by commas, or all. Default: all. |
| aster:break-length | How many minutes of commercials play in each break. | 0 to 30 minutes. Default: 2. |
| aster:promo-count | How many promos play in each break. | 0 to 5. Default: 1. |
| aster:trailer-count | How many trailers play in each break. | 0 to 5. Default: 1. |
| aster:interstitial-count | How many interstitials play in each break. | 0 to 5. Default: 1. |
| aster:bumpers-at | Where the bumpers go: at the start of a break (out), at the end (in), or both. | both, out or in. Default: both. |
| aster:break-every | How often a break comes. 1 means after every episode or movie; 3 means after every third. | 1 to 10 programmes. Default: 1. |
| aster:align | Makes programmes start at neat times, like 7:00 or 7:30, the way real TV does. The breaks stretch or shrink to fill the gap. 30 means on the hour and half hour. | 5, 10, 15, 20, 30 or 60 minutes, or off. Default: off. |
| aster:align-fit | With align on: best uses whole clips and gets as close to the mark as it can, but never starts a programme late. exact cuts the last clip short so the programme starts right on the dot. | best or exact. Default: best. |
Example channels
Saturday morning cartoons
An empty playlist that fills itself with 80s animation, with no movies, plus commercials from a filler playlist called Retro Ads, with shows starting on the half hour:
aster:channel
aster:number=12
aster:channel-name=Saturday Morning
aster:group=Kids
aster:mode=blocks
aster:blocks=2-3
aster:genre=Animation
aster:type=shows
aster:years=1980-1989
aster:max-length=30
aster:filler-playlists=Retro Ads
aster:filler-types=commercials,bumpers
aster:break-length=2
aster:align=30
Sitcom channel with a favourite
A playlist of sitcoms you picked yourself, where Friends comes up twice as often, with the channel's logo in the corner:
aster:channel
aster:number=4
aster:mode=rotation
aster:weight=Friends:2
aster:logo=on
aster:bug=on
aster:bug-location=bottom-right
Movie night
Every Pixar film, shuffled into a new order each week, with a trailer before each one:
aster:channel
aster:number=50
aster:mode=shuffle
aster:reshuffle=week
aster:network=Pixar
aster:filler-playlists=Trailers
aster:filler-types=trailers
aster:trailer-count=1
Troubleshooting
My channel doesn't show up in Aster.
Check that the playlist has the tag aster:channel and not aster:channel=off. If you're signed in as someone else, the playlist has to be shared with them or public, and if the channel has aster:user tags, their name has to be in them. Channels work with Jellyfin and Plex servers, not Emby. On Plex, the settings go in the playlist's description: check it starts with aster:channel, or make it with the Channel Builder.
The breaks never play, or some clips are missing.
The channel needs an aster:filler-playlists tag naming a playlist that's tagged aster:filler. Each clip in that playlist needs its own tag saying what it is, such as aster:commercial, and that kind has to be in the channel's aster:filler-types.
A setting doesn't seem to do anything.
A misspelled value falls back to the default, so check it against the tables above. In the Aster Channels plugin, the Tags section at the bottom of each channel shows exactly what's saved on the playlist.
Two channels have the same number.
Give one of them a different aster:number. In the plugin, you can drag channels up or down the list to renumber them.
Still stuck? See the support page or email [email protected].
