A little help
getting settled.

Getting started

Does ChannelDeck include TV channels?

No. ChannelDeck is a player for sources you are authorized to use. It does not sell subscriptions or provide access to television services.

How do I add a playlist?

On Apple TV, open Settings → Add playlist. On Mac, choose Add Playlist. Give it a name and enter its HTTP or HTTPS M3U address. ChannelDeck can use an XMLTV guide from your playlist, or you can enter one separately.

Can I try it without a provider account?

Our public demo M3U uses licensed Big Buck Bunny footage with fictional channel names. Copy that link into the playlist field. These are finite videos, not television services. On Apple TV, choose Playlist / custom URL and leave the guide URL blank. See the complete demo instructions.

Why is my guide empty or showing the wrong programme?

Guide coverage depends on your source. Check that the guide is current and the channel has a matching entry. For Open-EPG, review uncertain matches in the guide settings. Automatic mode is the default in the Apple TV editor; Mac starts with Playlist / custom URL. Fictional demo videos have no live schedule.

How much can I rewind?

Apple TV retains up to five or ten minutes, depending on your setting and available storage. Mac playback can offer a five-minute rolling window. History contains only media received since tuning; it cannot recover earlier broadcasts. On Apple TV, switching, stopping or leaving the app clears it.

Where are the Apple TV controls?

Click the Siri Remote centre button to show controls. Use Timeline to choose a point in retained history. Go Live returns to the newest live media. Swipe right for the channel drawer. Mini player keeps playing while you browse inside ChannelDeck.

What if a channel will not play?

Check the source address, provider access and network connection. Retry, then try another channel to see whether the issue is source-specific. Some formats, codecs or restricted streams are unsupported. If the problem continues, contact us with the error text and your device details, without credentials.

Where is the Apple TV download?

The App Store release is still being prepared. There is no public purchase link yet. The Mac DMG installs only the Mac app.

How do I install the Mac preview?

Download the signed DMG from the notarized preview release, open it and drag ChannelDeck into Applications. It requires an Apple silicon Mac and macOS 15 or later. Confirm the normal first-open prompt.

Can I report a bug publicly?

Yes, through GitHub issues . Issues are public, so use email for anything private and never post provider credentials.