Parekio

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

1. Install the Mac app

  1. Download the Parekio disk image (Parekio-2.0.1….dmg) and open it.
  2. Drag Parekio onto the Applications folder in the window that appears.
  3. 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.

Tip. If your media is on an external drive, choose a folder on that drive. If the drive is unplugged, Parekio stops serving until it’s back, and any import waits for it.

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.

  1. 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.
  2. 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.

  1. Create a free account at themoviedb.org and confirm your email.
  2. Open Settings ▸ API on the TMDB site and request a key for personal use.
  3. Copy either the API Key or the API Read Access Token.
  4. 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:

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:

  1. On the Roku remote, press quickly and in order: Home Home Home Up Up Right Left Right Left Right. The TV shows Developer Settings.
  2. Choose Enable installer and restart, then accept the Developer Tools License Agreement.
  3. 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.
  4. The Roku restarts. When it’s back on its Home screen, click Check Again in the Setup Assistant.
Forgot the password? Press the same button sequence again. Developer Settings lets you change it; then type the new one into 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:

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

  1. Open Parekio on your Roku. It finds your Mac by itself; with more than one, choose yours.
  2. The first time, enter the 4-digit PIN shown in Parekio’s menu.
  3. Choose Movies, TV, Music, Photos or Home Videos, and press OK.

Next: add your media.

Updating

Uninstalling