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

  1. 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.
  2. Open the playlist, choose Edit Metadata, and find Tags.
  3. Add the tag aster:channel, and a channel number such as aster:number=101. Save.
  4. 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

The basics

TagWhat it doesValues
aster:channelMakes 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:numberThe 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-nameWhat the channel is called in the guide.Any text. Default: the playlist's name.
aster:groupPuts 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:logoUses 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:userOnly 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.

TagWhat it doesValues
aster:mode

How the channel picks what plays next:

rotation: shows take turns, one episode each.

blocks: shows take turns, a few episodes in a row each.

shuffle: every movie and episode on its own, in a new order each day.

sequential: the playlist's own order, top to bottom, then round again.

airdate: everything in the order it first aired, across every show.

Default: rotation.
aster:blocksIn 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:reshuffleHow 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:seedDon't like the lineup? Change this number to deal a brand new one, for every device at once.A whole number. Default: 0.
aster:weightMakes 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.

TagWhat it doesValues
aster:genreAdds every movie and show in a genre, like Horror or Comedy. Add more than one to mix them.Genre names, separated by commas.
aster:typeWhether the genres add movies, shows, or both.all, movies or shows. Default: all.
aster:networkAdds every show from a TV network or movie studio, like NBC or Pixar.One name per tag, since studio names can contain commas.
aster:collectionAdds everything in one of your Jellyfin collections, like a Star Wars collection.One name per tag.
aster:libraryOnly takes titles from these libraries.Library names, separated by commas. Default: all libraries.
aster:yearsOnly 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:ratingOnly plays things with these age ratings, like G and PG for a kids' channel.Ratings, separated by commas. Default: any rating.
aster:min-lengthSkips anything shorter than this.Minutes, 1 to 600. Default: no limit.
aster:max-lengthSkips anything longer than this. For example, 30 keeps movies off a cartoon channel.Minutes, 1 to 600. Default: no limit.

Like real TV channels, a channel can show its logo faintly in a corner while you watch. It uses the playlist's picture.

TagWhat it doesValues
aster:bugShows the logo in a corner while the channel plays.on or off. Default: off.
aster:bug-locationWhich corner the logo sits in.top-left, top-right, bottom-left or bottom-right. Default: bottom-right.
aster:bug-sizeHow big the logo is. 100% is the normal size.25% to 300%. Default: 100%.
aster:bug-opacityHow see-through the logo is. Lower is more see-through; 100% is solid.5% to 100%. Default: 45%.
aster:bug-hideHides 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

  1. Make a Jellyfin playlist of short clips, and tag the playlist aster:filler.
  2. Tag each clip in it with what it is. A clip without one of these tags is never played.
Clip tagWhat it is
aster:commercialAds, like real TV commercials.
aster:promoAds for other shows, like "Coming up next…".
aster:trailerMovie trailers.
aster:bumperShort "We'll be right back" and "Now back to the show" clips.
aster:interstitialAnything 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.

TagWhat it doesValues
aster:filler-playlistsWhich 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-typesWhich kinds of clips this channel plays in its breaks.commercials, promos, trailers, bumpers, interstitials, separated by commas, or all. Default: all.
aster:break-lengthHow many minutes of commercials play in each break.0 to 30 minutes. Default: 2.
aster:promo-countHow many promos play in each break.0 to 5. Default: 1.
aster:trailer-countHow many trailers play in each break.0 to 5. Default: 1.
aster:interstitial-countHow many interstitials play in each break.0 to 5. Default: 1.
aster:bumpers-atWhere the bumpers go: at the start of a break (out), at the end (in), or both.both, out or in. Default: both.
aster:break-everyHow often a break comes. 1 means after every episode or movie; 3 means after every third.1 to 10 programmes. Default: 1.
aster:alignMakes 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-fitWith 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].