ChannelBox help
Everything you need to get your TV provider into ChannelBox and watch it like cable, on Windows or Mac. Most people are watching within two minutes.
After you buy, the thank-you page and your email both have your download link. The same link always gives you the newest version, so keep the email.
ChannelBox checks for new versions by itself; when one is out, Update available shows in the sidebar. Go to Settings → Updates. The first time, paste your ChannelBox key — it’s in your purchase email and on your download page (the download link works too). Then click Download and install: ChannelBox closes and the installer opens. Your playlists, favourites and settings stay.
You can also download again from your link any time and install over the top.
ChannelBox is a player — the channels come from your IPTV provider. Look in your provider’s welcome email for either an Xtream Codes login or an M3U playlist link. Xtream Codes is better if you have both: it brings movies, series, catch-up and the TV guide with it.
http://example.com:8080), your username and your password..xml or .xml.gz.
Just want to try it? In Settings, click Add free news channels. It adds seven news channels that the broadcasters stream free to the public — DW, France 24, Al Jazeera English, NHK World, CBS News 24/7, Bloomberg and TRT World. Delete it any time with the bin icon.
Add as many playlists as you like. They’re listed under Settings → Playlists; click one to switch to it. The tick shows the one you’re watching.
Passwords are locked away with your computer’s own protection (Windows data protection or the Mac Keychain) and only ever sent to your provider. See the privacy policy.
Live TV opens the guide: channels down the left, times across the top, and a red line at the current time. The channel you pick plays quietly in the preview at the top, with what’s on.

If your provider records a channel, the preview says Catch-up beside its name. Pick a show that has already aired and the button says Catch up — it plays from the start.
Your provider matches each channel to a guide listing, and now and then it picks the wrong one — a West-coast channel showing the East listings, or one city’s station showing another’s. Pick the channel and click Wrong guide? under the preview. ChannelBox suggests listings with a similar name; click the one that matches what’s on, or search for it. If the shows are right but at the wrong time, use the hour buttons to shift them. Only that channel changes, and Use the provider’s match puts it back.
The listings come from your provider and refresh on their own while ChannelBox is open, so there’s nothing to update. If you see “No guide information” on every channel, see If something isn’t working.
When a channel starts, the info banner shows its number, logo, the show with its times and progress, and what’s on next. It hides after a few seconds — move the mouse, click the picture or press I to bring it back.

Why a channel takes a second or two to start: ChannelBox stores a few seconds of the channel before it plays, then quietly builds that to about 15 seconds. That stored time is what carries you through your provider’s little gaps without freezing.
While you watch a channel, the buttons above the banner pause and rewind it, like a PVR.
The first time you pause or rewind a channel, ChannelBox starts keeping the last hour of it on your computer — that takes a second or two. To be able to rewind as soon as a channel starts, turn on Settings → Keep a rewind buffer on every channel.
Recordings in the sidebar lists what’s recording now, what’s coming up and what’s recorded. Click Watch to play one, the folder button to find the file, or the bin to delete it. Recordings start a minute early, run two minutes over, and are saved as MP4 files in Videos › ChannelBox Recordings (on a Mac, Movies › ChannelBox Recordings), so they play anywhere.
Keep ChannelBox open to record. It keeps the computer awake while it records, and asks before you quit in the middle of one. Each recording is its own connection to your provider: on a plan that allows one connection, you can record the channel you’re watching but not a different one at the same time.
Click Find a show above the guide, or press Ctrl+F (⌘+F on a Mac), and type part of a show’s name. ChannelBox searches every channel’s guide from now through the next three days. Click a result to see it in the guide, or use its bell and record buttons right there.
Remind me shows under the preview for any show that hasn’t started. A minute before it starts, a card pops up — even over the channel you’re watching — with Watch now. If ChannelBox is behind other windows, your computer shows a notification too.
Watch up to four channels at once. Click the four-squares button above the guide (it starts with the channel you’ve picked) or at the top while you watch.
Each channel in multi-view is its own connection to your provider, and many plans allow only one or two. If a square says it isn’t playing, that’s usually why.
While you watch, click the cast button at the top and pick your TV. It works with a Chromecast, a Google TV, and TVs with Chromecast built in. The TV and the computer have to be on the same network. The first time, your computer may ask whether ChannelBox can use the network — allow it.
The TV plays the channel from your computer, so leave ChannelBox open. Flip channels as usual and the TV follows; Stop casting brings the picture back to the computer. AirPlay isn’t supported.
Locked channels show “Locked” in place of their shows, have no preview, and ask for the PIN to watch. Locked movie and series categories are hidden until the PIN is typed. Once it’s typed, everything stays open until ChannelBox closes — or click Lock now in Settings. Changing what’s locked, changing the PIN, or turning the lock off all need the PIN.
If your provider includes on-demand, it shows up under Movies and Series in the sidebar. M3U playlists usually don’t include these; Xtream Codes logins usually do.
Click the star on any channel — in the guide preview or while watching — to add it to your favourites. The Favourites page in the sidebar lists them along with the channels you watched most recently, each with what’s on now. Click one to watch it; click its star to remove it.

In the guide, the ★ Favourites button shows only your favourites, so flipping channels skips the ones you never watch.
ChannelBox works like a cable remote. These work on Windows and Mac.
| Key | What it does |
|---|---|
| ↑ ↓ ← → | Move around the guide |
| Enter | Watch the selected channel or show |
| 0–9 | Type a channel number |
| Page Up Page Down | Channel up / down while watching; scroll the guide |
| ↑ ↓ or + − | Channel up / down while watching |
| I | Show the info banner |
| L | Channel list while watching |
| Space | Pause and play, live TV too |
| ← → | Back 10 seconds / ahead 30 while watching |
| End | Back to live after pausing or rewinding |
| R | Record the channel you’re watching |
| Ctrl+F (⌘+F) | Find a show in the guide |
| F | Full screen while watching |
| F11 | Full screen anywhere in the app |
| Esc | Close the channel list, then back to the guide |
Copy the server, username and password straight from your provider’s email — a missing :8080 or a space at the end is the usual cause. Include the http:// part. If it still won’t connect, check your subscription hasn’t run out by logging in on another device.
ChannelBox has already tried to re-tune it several times by itself, so the channel is most likely down at your provider. Try another channel; if every channel does it, check your internet connection and your subscription.
ChannelBox rides out short gaps, but it can’t fix a stream that keeps stopping for longer than its cushion. Try the channel again later or at a lower quality version if your provider has one (often marked SD or HD). A wired connection or sitting closer to the Wi-Fi router helps a lot. If it’s every channel, it’s usually your provider or your internet speed.
On its own ChannelBox plays one stream at a time — the guide preview stops the moment you start watching. Multi-view, casting and recording a different channel each add a connection while they run. If your provider still complains, another device (a TV box, phone or second computer) is probably using the same login. Close the app there.
ChannelBox has to be open, and the computer awake, when the show airs — a recording that was missed says so in Recordings. If the connection drops, ChannelBox picks the recording up again after a few seconds and joins the pieces. If your plan allows one connection, a recording of one channel can’t run while you watch another.
Make sure the TV is on and on the same Wi-Fi as the computer (not a guest network), then click Look again. On Windows, if a firewall message asked about ChannelBox, it needs to be allowed on private networks. Only Chromecast and Google TV devices are supported; AirPlay isn’t.
Get in touch and I’ll walk you through resetting it.
Channels with Dolby sound are converted automatically — you’ll see a short pause the first time. If there’s still nothing, check your computer’s volume and that the right speakers are chosen. If only one channel is silent, the sound may be missing at your provider.
Your provider has matched that channel to the wrong guide listing. Pick the channel, click Wrong guide? and choose the listing that matches what’s on. See Use the TV guide.
Go to Settings → Reload TV guide. With an M3U playlist, your provider may keep the guide at a separate link: ask them for the “EPG link”, delete the playlist and add it again with that link in the TV guide link box. A few channels never have listings — they show the channel name instead.
Go to Settings → Reload channels.
Download ChannelBox again from your original link — one purchase covers your Windows and Mac computers. Then add your provider again. Lost the link? Have it sent again.
I built ChannelBox and I’m happy to help you get it working. Get in touch and tell me what you see — a screenshot helps. Please don’t send your provider password.