Parekio

Using Parekio

The Mac app keeps your library; the Parekio channel on the Roku plays it.

Parekio lives in the menu bar. Its menu shows whether it’s serving, your Mac’s address and the PIN, what’s playing and any import in progress. From there you can open the Library, add media, start or stop serving, pick the Roku’s theme, open Settings, update a Roku channel you installed from the Mac (the store app updates itself) and Check for Updates… to Parekio itself. While Parekio is making captions, the menu says which video it’s on.

Cache shows how much space thumbnails, converted subtitles and audio, and keyframe indexes take. Show in Finder opens the folder; Clear Cache… asks first, then removes them. Parekio rebuilds what it needs as you browse; your library and settings are never touched.

Closing a window doesn’t stop Parekio; your Roku can keep watching. Only Quit stops it.

The Library window

Open it from the menu, or by opening Parekio from Applications. The sidebar lists Movies, TV, Music, Photos and Home Videos, plus Needs Attention when something needs you, and any other folders in your library.

Details pages

Double-click any movie, show, episode, album, photo album or video to open its page, laid out like the Roku’s and drawn in your Roku theme. More Info shows the file and how it plays. Fix Match, Edit Details, Refresh Metadata, Reveal in Finder and Move to Trash are on the page.

A show’s episodes appear as a grid of stills, with lengths, ✓ for watched and a bar for part-watched, or as a list. Shows with more than three seasons get a season pulldown.

Playing on the Mac

Photos on the Mac

Slideshows

Start one from the Photos header, the bar under an open photo, or Slideshow ▸ Start Slideshow (⌥⌘S). It plays the photos you’ve selected or, with none selected, the whole folder (and its subfolders, if you like). It opens full screen in a window of its own, or inside the Library window when Start in full screen is off; the Full Screen button moves between the two.

Slideshow Settings slides in as a column on the left (the gear button, Slideshow ▸ Show Slideshow Settings or ⌥⌘,; Esc or ✕ closes it). The Roku’s slideshows use the same settings.

Timing
1 to 60 seconds per photo, or Manually, when only the arrows move on.
Transition
Crossfade (the default), Fade Through Black, Slide, Slide Up, Zoom, Blur Dissolve, None or Random, and how long it takes. Custom sets how a photo comes in and how the last one goes out (fade, slide, zoom in or out, blur), at the same time or one after the other.
Ken Burns
On by default: each photo drifts and zooms slowly. Choose zooming in, out, alternating or random, the most it zooms, and whether it pans. A landscape photo fills the screen and moves within itself, so its edges never show; a portrait photo stays whole.
Look
A black background, or a blurred copy of the photo behind photos that don’t fill the screen. Captions: none, the date taken, the file name, or both.
Order
Shuffle, Loop, include photos in subfolders, and start in full screen. Restore Defaults puts everything back.

Captions

Parekio uses subtitle files beside your videos (Arrival (2016).en.srt) and subtitles inside them. Captions are off until you want them: CC over a video on the Mac, ✱ ▸ Subtitles on the Roku, or always on in Settings ▸ Playback.

Automatic captions. For a video with no English subtitles, Parekio can listen to its sound and write English captions, using macOS’s own speech recognition on your Mac. Nothing is uploaded, and nothing is written next to your files; the captions are kept in Parekio’s cache. They appear as English (auto) among the subtitles, on the Mac and on the Roku.

Adding media

Drop files or folders anywhere on the Library window, or use + (⌘O) or Add Media… in the menu. Drop on a section in the sidebar to say what it is (“these are TV episodes”), or on a show or album to add to it.

Nothing moves yet. The review sheet lists everything first:

Choose Copy (the default) or Move, and whether to rename to library names, then click Import. Imports run one at a time in the background and survive a restart. Each file is copied and checked before it’s put in place; with Move, the original goes to the Trash only after its copy checks out.

Didn’t match? When TMDB finds nothing for some videos, the sheet asks whether they’re home videos and offers Move to Home Videos.

How files are named

KindWhere it goes
MovieMovies/Arrival (2016)/Arrival (2016).mkv
SubtitlesMovies/Arrival (2016)/Arrival (2016).en.srt
EpisodeTV/Northern Line (2019)/Season 02/Northern Line - S02E05 - The Signal Box.mkv
MusicMusic/Ella Ruiz Quartet/Night Ferry (2019)/01 - Harbour Lights.flac
PhotosPhotos/Lisbon Trip/IMG_0001.HEIC
Home videoHome Videos/2024/Lisbon Trip/IMG_0042.MOV (its own name)

Turn off Rename to library names to keep original file names in the same folders.

Home Videos

Your own videos live in Home Videos, in folders nested however you like. They keep their file names and are never looked up online.

Posters and details

With a TMDB key, matched movies and shows get posters, backdrops, descriptions, cast, ratings and episode stills. They’re saved in a hidden .parekio folder beside the media, so Finder shows only your files (⇧⌘. in Finder shows hidden files).

On a movie’s or show’s Details page, or in the info column:

Anything Parekio couldn’t match on its own appears in Needs Attention.

Organize…

Library ▸ Organize… offers to rename files already in the library to library names. It lists only files whose names would change, and nothing happens until you click Organize. Folders left empty go to the Trash.

Settings

General
Your library folder, Launch at Login, whether to start serving when Parekio opens, the Roku theme, and Check for updates automatically (with Check for Updates…).
Playback
Captions always off or always on, and Automatic Captions: off, Home Videos, or all videos without English subtitles.
Sharing
The PIN (a new one signs out every Roku) and the network ports. Change the port if another app uses it.
Metadata
Your TMDB key, language and region, artwork downloads, and matching on import.
Conversion
ffmpeg status, the cache (its size, Show and Clear Cache), and Open Log to see how every file was played.
About
Version and credits.

Slideshow options have their own column: see Slideshows.

Getting the Roku app

Parekio for Roku is free in the Roku Streaming Store: on the Roku, search for Parekio and choose Add app, or add it to your Roku account. Open it, choose your Mac, and enter the PIN shown in Parekio’s menu. More about adding it.

Home

Parekio’s Home lists the sections that have something in them: Movies, TV, Music, Photos, Home Videos and Other folders, and About Parekio at the bottom. On the right, Continue holds the last five things you stopped part-way through; press Right to reach it and OK to carry on.

Themes

The Parekio channel comes in eight looks: Default, Daylight, Midnight, Forest, Cinema, Neon, Sixties and Seventies. Choose one on your Mac, from Roku Theme in the Parekio menu or in Settings ▸ General. The Roku switches when it connects, or the next time you’re back on Home; it never changes in the middle of something you’re watching. Every theme keeps the same layout and is checked for legibility from across the room. See them all.

Browsing

Details

Movies and episodes open a Details screen with the backdrop, facts and description, and:

Left and Right step to the previous or next movie, or episode in the season, without going back. In an episode list, the Play key plays straight away.

Playing

Music

An album opens with its cover, title, artist, year, track count and length across the top, Play and Shuffle buttons, and the tracks full width below. OK on a track plays the album from there; Shuffle plays it in a random order.

The Now Playing screen shows what’s up next and moves on by itself when a track ends:

Photos

Folders open into their own folders, and photos show as thumbnails. OK shows a photo full screen; Left and Right step through. Videos in a photo album play like any other video.

Slideshows. In a folder, Play (or ✱ ▸ Start Slideshow) starts one from the highlighted photo. It follows the Mac’s Slideshow Settings, as the theme does: timing, transition, Ken Burns, blurred background, captions, shuffle and loop. While it plays:

Remote keys

KeyWhat it does
OKOpen, or choose the highlighted button
BackUp one level; at Home, asks before leaving Parekio
✱Options: view and sort in lists, Start Slideshow in Photos, audio and subtitles while playing; speed, shuffle and loop in a slideshow
PlayPlay the highlighted episode or movie; start, pause or carry on a slideshow
Left RightPrevious / next movie or episode on Details; photos in the viewer and slideshows; tracks in Now Playing
Rewind Fast FwdSeek in video; 10 seconds back or ahead in music; previous / next photo

What plays how

Your Mac decides for each file. More Info, on the Mac and on the Roku, says which of these happens, and why.

HowWhat it meansTypical files
DirectlyThe Roku plays the file as it is. Best quality, no work for the Mac.MP4, M4V, MOV, MKV with H.264 or HEVC video and AAC, Dolby Digital or Dolby Digital Plus audio; MP3, AAC, FLAC, ALAC, WAV music
RepackagedThe video and audio are fine but the container isn’t; the Mac rewraps them as it plays. No quality loss.TS files with H.264 or HEVC; MKV with audio the Roku can’t decode, which is converted while the video is copied
ConvertedThe Mac re-encodes the video with its hardware encoder as you watch. HDR stays HDR.AVI (Xvid/DivX), WMV, MPEG-2, AV1, 10-bit H.264; 4K H.264 (from GoPros and some phones), sent at 1080p
Converted (music)Converted once to lossless FLAC, then played like any file.OGG, Opus, WMA, APE, WavPack, AIFF

Surround sound stays surround: 5.1 audio the Roku can’t pass through is converted to Dolby Digital Plus 5.1. DTS is passed through to a receiver that decodes it. Picture-based subtitles (from Blu-ray and DVD rips) aren’t supported; text subtitles are.