Install Parekio
About 15 minutes, most of it waiting for downloads. You’ll need your Mac, your Roku remote and the TV.
Before you start
- A Mac with Apple silicon (M1 or later) running macOS 13 Ventura or later.
- A Roku player or Roku TV on the same network as the Mac.
- Your Mac’s administrator password (for installing ffmpeg through Homebrew).
- Optional: a free account at themoviedb.org for posters and descriptions.
1. Install the Mac app
- Download the Parekio disk image (
Parekio-2.0.1….dmg) and open it. - Drag Parekio onto the Applications folder in the window that appears.
- Open Parekio from Applications or Launchpad. macOS may ask “Are you sure you want to open it?” because it came from the internet: click Open. Parekio is signed and notarized by Apple.
The Parekio mark appears in your menu bar (top right of the screen). That’s where Parekio lives; it shows a Dock icon only while one of its windows is open.
2. The Setup Assistant
The first time you open it, Parekio opens the Setup Assistant, which walks through the steps below. Each step can be skipped and finished later: choose Setup Assistant… in the menu bar.
3. Your library
Parekio keeps everything in one folder with five sections: Movies, TV, Music, Photos and Home Videos.
- Create a New Library… makes a folder called “Parekio Library” wherever you choose, on your Mac or an external drive.
- Use an Existing Folder… uses a folder you already have. Missing sections are added; nothing you already have is moved or renamed.
4. ffmpeg
ffmpeg is a free tool that reads your files and converts the ones the Roku can’t play. Parekio installs it with Homebrew, the standard free package manager for the Mac.
- If Homebrew isn’t installed, click Install Homebrew…. Terminal opens with Homebrew’s official installer; it asks for your Mac password and takes a few minutes. When it finishes, return to the Setup Assistant and click Check Again.
- Click Install ffmpeg. You can watch Homebrew’s progress in the window.
Without ffmpeg, files the Roku plays natively still work, but nothing is converted.
5. Movie info (TMDB)
For posters, backdrops, descriptions and episode titles, Parekio uses TMDB, a free community movie database. You use your own free key; Parekio doesn’t include one.
- Create a free account at themoviedb.org and confirm your email.
- Open Settings ▸ API on the TMDB site and request a key for personal use.
- Copy either the API Key or the API Read Access Token.
- Paste it into the Setup Assistant (or Settings ▸ Metadata later) and click Test.
The key is kept in your Mac’s Keychain. It’s never shown in logs and never sent anywhere except TMDB. You can skip this step; titles then come from your file names.
6. The Roku app
Parekio for Roku is free in the Roku Streaming Store. Add it in either of these ways:
- On the Roku: open Streaming Store (or Search), find Parekio, and choose Add app.
- From a browser: add Parekio to your Roku account. It arrives on your Rokus within a few minutes. The Setup Assistant has a button for this too.
The Roku keeps the app up to date by itself.
Choose your Roku
The Setup Assistant looks for Rokus on your network and lists them. Pick yours, and it checks that Parekio is there; Open Parekio on the Roku starts it from your Mac. If your Roku isn’t found, make sure it’s on and connected, click Search Again, or type its IP address (on the Roku: Settings ▸ Network ▸ About).
Advanced: install from your Mac instead
For a Roku where Parekio isn’t offered in the Streaming Store, the Mac app can install the channel itself, over your network. This needs the Roku’s Developer Mode, and a Roku holds only one channel installed this way. In the Setup Assistant, open Advanced: install from this Mac instead.
Turn on Developer Mode
If Developer Mode is off, the Setup Assistant shows these steps too:
- On the Roku remote, press quickly and in order: Home Home Home Up Up Right Left Right Left Right. The TV shows Developer Settings.
- Choose Enable installer and restart, then accept the Developer Tools License Agreement.
- The Roku asks you to set a web server password. Choose one, type it twice, and write it down. This is the password Parekio asks for next. The user name is always
rokudev. - The Roku restarts. When it’s back on its Home screen, click Check Again in the Setup Assistant.
Install Parekio
Type the web server password and click Install Parekio. It takes a few seconds. The password is saved in your Mac’s Keychain so updates are one click.
Parekio then appears on your Roku’s Home screen. A Roku holds one channel installed this way, so installing it replaces any other developer channel on it.
7. Network permission
The first time Parekio starts serving, macOS asks two questions. Click Allow on both:
- “Allow incoming network connections?” (the firewall)
- “Find devices on your local network?” (Local Network)
Without both, the Roku can’t find or reach your Mac. If you clicked Don’t Allow, turn Parekio on again in System Settings ▸ Privacy & Security ▸ Local Network, and in Network ▸ Firewall ▸ Options.
8. Watch
- Open Parekio on your Roku. It finds your Mac by itself; with more than one, choose yours.
- The first time, enter the 4-digit PIN shown in Parekio’s menu.
- Choose Movies, TV, Music, Photos or Home Videos, and press OK.
Next: add your media.
Updating
- The Mac app: updates itself. When a new version is out, Parekio asks once and then offers Install Parekio … in its menu; choose Install and Relaunch and it downloads, quits and opens again in under a minute. Check for Updates… in the menu looks right away. Your library and settings stay. (Copies from 1.3 and earlier can’t update themselves: download the new version once and drag it into Applications.)
- The Roku app: from the Streaming Store, it updates itself; there’s nothing to do. If you installed it from your Mac instead (Developer Mode), each Parekio version carries the matching channel: when your Roku has an older one, the menu shows Update Roku Channel to …; choose it and the Roku updates in seconds.
Uninstalling
- Quit Parekio from its menu, then drag it from Applications to the Trash. Your library folder isn’t touched.
- Optional clean-up: delete
~/Library/Application Support/Parekio,~/Library/Caches/Parekio,~/Library/Caches/net.bcoleman.parekioand~/Library/Logs/Parekio. - On the Roku, highlight Parekio on the Home screen, press ✱ and choose Remove app. If you installed it from your Mac (Developer Mode), press the Developer Mode button sequence again and choose Disable installer and restart instead; that turns Developer Mode off and removes the channel.