Help
Most problems are one of the cases below. If yours isn’t, write to us.
The Roku can’t find my Mac
- Check Parekio’s menu says Serving. If it says Stopped, choose Start Serving.
- Make sure the Mac and the Roku are on the same network (not a guest network).
- Check macOS allowed it: System Settings ▸ Privacy & Security ▸ Local Network has Parekio turned on, and the firewall allows incoming connections for it.
- On the Roku, choose Enter IP manually and type the address shown in Parekio’s menu, for example
192.168.1.20:8765.
If the Mac went to sleep, Parekio shows “Server unavailable”. Wake the Mac, then press OK on the Roku. To stop the Mac sleeping while you watch, open System Settings ▸ Energy (Energy Saver on older macOS) and turn on “Prevent automatic sleeping when the display is off”.
Setup and the Roku channel
The Setup Assistant can’t find my Roku
Make sure the Roku is on (not in deep standby) and on the same network, then click Search Again. Or type its IP address: on the Roku, Settings ▸ Network ▸ About.
The Setup Assistant says Parekio isn’t on my Roku
Add it from the Roku Streaming Store (search for Parekio on the Roku), or add it to your Roku account; then click Check Again. If your Roku’s Control by mobile apps setting is Limited, the Mac can’t see its apps: open Parekio on the TV instead.
Parekio disappeared from my Roku
If it came from the Streaming Store, add it again the same way, then choose your Mac and enter the PIN shown in Parekio’s menu. If you installed it from your Mac (Developer Mode), installing another developer channel replaces it and turning Developer Mode off removes it: install it again from the Setup Assistant’s Advanced section.
Developer Mode: the Roku rejects the password
Only for installing from your Mac (Install ▸ Advanced). It’s the web server password you set when you turned on Developer Mode, not your Roku account password. If you’ve forgotten it, press the Developer Mode button sequence again; Developer Settings lets you set a new one.
The Roku asks for a PIN again
The PIN was changed in Settings ▸ Sharing. Enter the PIN shown in Parekio’s menu now.
Playback
A file won’t play
Parekio shows the Roku’s error and how it tried to play the file. On the Mac, Settings ▸ Conversion ▸ Open Log lists every play decision and error. Common causes: ffmpeg isn’t installed (the menu says so), the file is damaged, or it only has picture-based subtitles you selected.
Converted videos stutter or take a while to start
Converting uses your Mac’s hardware encoder and is usually quick, but a busy Mac or Wi-Fi can slow it. Use a wired connection for the Mac if you can, and close heavy apps. Files that play directly never need converting.
There’s no sound
Some Rokus play multichannel AAC silently; Parekio converts those to Dolby Digital Plus 5.1 automatically. If a file is still silent, try another audio track with ✱ while it plays, and check your receiver or TV’s audio settings.
The next episode doesn’t start by itself
That’s on purpose. When an episode ends, Parekio asks “Would you like to play the next episode?”, on the Mac and on the Roku. Choose Yes to carry on.
Subtitles don’t appear
Captions are off by default. On the Mac, click CC over the video, or turn them always on in Settings ▸ Playback. On the Roku, press ✱ ▸ Subtitles while playing. Subtitle files must sit beside the video with the same name (Movie.srt or Movie.en.srt). Picture-based subtitles (PGS, VobSub) aren’t supported.
“English (auto)” captions are missing or wrong
Parekio makes these itself, from the sound, for videos with no English subtitles. They need macOS 26 or later and Settings ▸ Playback ▸ Automatic Captions set to Home Videos or All Videos; or select videos and choose Library ▸ Make English Captions. They’re made one video at a time in the background, and the menu shows which one it’s on. Videos with no speech get none. Speech recognition can mishear words over music or noise; picking a subtitle file of your own is always better when you have one.
A slideshow on the Roku isn’t using my settings
The Roku picks up the Mac’s Slideshow Settings when it connects, on Home, and each time it opens a Photos folder. If you’ve just changed them, press Back, open the folder again and start the slideshow. ✱ during a slideshow changes speed, shuffle and loop for that slideshow only.
Thumbnails look wrong, or the cache is large
Choose Cache ▸ Clear Cache… in Parekio’s menu (or Settings ▸ Conversion ▸ Clear Cache). Thumbnails, converted subtitles and audio, and keyframe indexes are rebuilt as they’re needed. Your library isn’t touched.
The library
A movie or show matched the wrong title
Double-click it in the Library window and choose Fix Match… on its page. Or use Edit Details… to type your own.
No posters appear
Add a TMDB key in Settings ▸ Metadata and click Test. Without one, Parekio uses titles from file names and typographic tiles.
Something is in Needs Attention
Needs Attention lists what Parekio couldn’t finish by itself: titles that need a match, music without tags, files in the wrong section, and imports that failed (with Retry). Each row says what to do.
An import says there isn’t enough space
Parekio needs the import’s size plus 1 GB free on the library’s drive. Free some space, or import fewer items.
I can’t see the posters in Finder
They’re in hidden .parekio folders beside your media so Finder stays tidy. Press ⇧⌘. in Finder to show hidden files.
The Mac app
Where is Parekio?
In the menu bar, top right: the Parekio mark, three stacked layers. Opening Parekio from Applications also opens its Library window.
“Port 8765 is already in use”
Another app is using that port. Choose a different one in Settings ▸ Sharing; the Roku finds the new port by itself.
The menu says ffmpeg isn’t found or won’t run
Open the Setup Assistant from the menu and use the ffmpeg step. If you installed ffmpeg some other way, an old Intel copy can be found first; installing through Homebrew fixes it.
Questions
Can I watch away from home?
No. Parekio serves your home network only, by design.
Can I use more than one Roku or Mac?
Yes, any Rokus in your home can install the Parekio channel and watch. If you run Parekio on more than one Mac, the channel lets you choose which to watch from.
Does Parekio send my data anywhere?
No. See the privacy policy: your library never leaves your network; only title look-ups go to TMDB, with your own key.
Where do I get Parekio for Roku?
From the Roku Streaming Store: search for Parekio on your Roku, or add it to your Roku account. It’s free and updates itself. It plays your Mac’s files over your home network, so it needs Parekio running on your Mac.
Does Parekio cost anything?
No. Parekio and the Parekio channel are free, with no subscription, account or ads.
Contact support
Send a message with the form below; a real person reads every one. It helps to include:
- Your Parekio version (Settings ▸ About) and your Roku model (Home ▸ About Parekio on the TV).
- What you did, what you expected, and what happened.
- The log, if it’s about playback or importing: Settings ▸ Conversion ▸ Open Log, then attach
Parekio.log. It lists file names from your library, so remove any you’d rather not share.