Help
Support
Aster Media Player for Apple TV, iPhone and iPad, free on the App Store. Mac is coming soon.
Contact us
If your question isn't answered below, email us. Please include your device, the Aster version (Settings ▸ About), which server you use (Jellyfin, Emby or Plex) and its version, and what you were doing when the problem happened.
Getting started
What do I need to use Aster?
A Jellyfin, Emby or Plex server that your device can reach, and an account on it. Emby and Plex have most features, and more will be added in later releases. Aster is a player: it doesn't include any media, and it doesn't provide a server.
How do I connect to Jellyfin or Emby?
Open Aster and enter your server's address, for example http://192.168.1.20:8096 at home or https://jellyfin.example.com from outside. Then sign in with your username and password for that server. If your server is on the same network, Aster may find it for you.
How do I sign in with Plex?
Choose Sign in with Plex. Aster shows a short code. On your phone or computer, go to plex.tv/link, sign in to Plex and enter the code. Aster then lists your Plex servers, and your Home profiles if you have them.
Common problems
I can't reach my server from outside my home.
On Plex, turn on Remote Access in your Plex server's settings. On Jellyfin or Emby, use your server's public https:// address, usually set up with a reverse proxy or a VPN; Jellyfin's and Emby's documentation both cover this.
At home, make sure the address includes the port (usually 8096 for Jellyfin and Emby) and the right http or https, and that the same address opens in a web browser on the same network.
Aster warned me that my server address isn't encrypted.
Addresses that start with http:// send everything unencrypted, including your sign-in, so anyone on the same network could read it. That's usually fine on a trusted home network, but avoid it on public Wi-Fi or over the internet. Switch to your server's https:// address if it has one.
Why does a video buffer or play at lower quality?
When your device can't play a file as it is, the server converts it on the fly, which takes CPU or GPU power on the server. A slow or busy server shows up as buffering or reduced quality. Check your user's streaming bitrate limit and the server's hardware acceleration settings.
On Plex, also check Settings ▸ Transcoder: the limit on simultaneous video transcodes can stop a converted stream from starting while others are playing.
Styled subtitles take a few seconds to appear on Plex.
For styled (ASS/SSA) subtitles, Aster reads the subtitle track out of the video file itself so it can show the original styling. That takes a few seconds when playback starts. Plain subtitles appear right away.
Which features work only with Jellyfin?
Disc menus and the companion server plugins are built for Jellyfin. Channels work on Jellyfin and Plex: on Plex, make them with the Channel Builder. Emby and Plex have most of the rest, and more will be added in later releases. On every device, Plex doesn't have music or Live TV yet.
The features page lists exactly what works with each server, on each device.
Jellyfin features
Do I need anything on my server for Channels, anime openings or disc menus?
Channels work with Jellyfin alone: a channel is a playlist with a few tags on it, and you can make and edit them in the app. The free Channels plugin is optional and adds an editor to your Jellyfin dashboard.
Anime openings and endings work without a plugin too. Aster looks for opening and ending chapter markers in your episodes and plays them from Watch OP and Watch ED when it finds them. The free Anime OP/ED plugin adds song details, full-length versions, music videos, and can cut missing themes from your episodes. The anime themes guide walks through setting it up.
Disc menus need our free companion plugin. See Install the server plugins below, and the disc menus guide for the rest.
How do I make my first channel?
Any video playlist can become a channel. Pick whichever way suits you:
- In Aster: create and edit channels from the Channels screen.
- In the Jellyfin dashboard, with the Channels plugin installed: open Channels, choose New Channel, and start from a show, genre, network, collection or playlist.
- By hand: add the tags
aster:channelandaster:number=101to a playlist in Jellyfin. Aster picks it up as channel 101.
Other people on your server only see a channel if its playlist is shared with them or public.
The channels guide explains every channel tag, with examples.
How do I add commercials between shows?
Make a playlist of clips and tag it aster:filler. Then tag each clip with what it is: aster:commercial, aster:promo, aster:trailer, aster:interstitial or aster:bumper. Untagged clips are skipped. Each channel then chooses which kinds to play, how long breaks run and how often they come.
Install the server plugins
Aster's server plugins for Jellyfin are free and open-source. You'll need an administrator account on your Jellyfin server to install them, and you only need the ones for the features you want.
| Plugin | What it adds | Needs |
|---|---|---|
| Aster Channels | A channel editor in your Jellyfin dashboard. Optional: channels work without it. | Jellyfin 12.1 |
| Aster OP-ED | Song details, full-length versions, music videos, theme music libraries and clip cutting for anime openings and endings. | Jellyfin 12 |
| Aster Disc | Stores your disc menus and serves them to Aster, plus the menu editor and community catalogue. Required for disc menus. Early alpha. | Jellyfin 12 |
- In Jellyfin, open Dashboard → Plugins → Repositories and add this repository:
https://raw.githubusercontent.com/AsterMediaPlayer/aster-companion-plugins/main/manifest.json - Open the Catalogue and install the plugins you want. Aster Channels and Aster Disc are under General, and Aster OP-ED is under Metadata.
- Restart Jellyfin.
- For Aster OP-ED, open Dashboard → Aster OP/ED and choose your themes folder. Keep it outside your library folders, so Jellyfin doesn't scan the themes as ordinary videos.
If you're signed in to Aster as a Jellyfin administrator, Aster can also install the plugins for you.
Supported systems
- iPhone and iPad: iOS and iPadOS 26.1 or later
- Apple TV: tvOS 26 or later
- Mac (coming soon): macOS 26 or later
More questions
Does Aster cost anything?
No. The app and its server plugins are free, with no subscriptions, paid tiers or ads. If you'd like to support development, you can donate.
Is Aster available for Windows, Linux or Android?
Yes. Android is out for phones, tablets and Android TV: download the APK (Android 8.0 or later); a Google Play listing is coming. Windows and Linux are out as betas, with the same features. Get Windows (an installer, or a portable .zip; Windows 10 version 1809 or later) or get Linux (packages for Debian and Ubuntu, Fedora and openSUSE, Arch, Flatpak, and a .tar.gz for anything else, on x64 and ARM64).
Source code and licenses
Aster is open-source. The app's source code is on GitHub at AsterMediaPlayer/Aster-Media-Player, under the Mozilla Public License 2.0. Its server plugins and Jellyfin skin are public there too.
Licenses for the open-source software used in the app are listed in the app under Settings ▸ About ▸ Open Source & Licenses.
