Using Parekio
The Mac app keeps your library; the Parekio channel on the Roku plays it.
The menu bar
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.
- Switch between a thumbnail grid and a list, sort by title, year, date added or size, and search. Each section remembers its view; thumbnails are the default.
- Movies, albums, home videos and clips show their running time on the thumbnail.
- Double-click anything to open its page. More Info there shows the file’s details and exactly how the Roku will play it, and why.
- The sidebar’s button in the header hides or shows the sidebar.
- Space opens Quick Look, ⌘R reveals in Finder, ⌘⌫ moves to the Trash.
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
- Play on a Details page plays the movie or episode right in the Library window, or in a window of its own (⌘⇧P). Home videos play the same way. While something plays, the sidebar slides away.
- Resume works across devices: stop on the Roku and pick up on the Mac, or the other way round.
- When an episode ends you’re asked “Would you like to play the next episode?” Nothing plays on by itself.
- Captions are off unless you turn them on with the CC button over the video, or always on in Settings ▸ Playback. Forced subtitles (lines in another language) always show. Videos with no English subtitles can get automatic captions.
- Music plays on the album’s page, with no player window. The mini player under the cover has shuffle, back, play/pause, forward, a progress bar you can drag, mute, volume and stop. Double-click a track to play from it; the playing track is lit, and the sidebar shows what’s playing when you leave the album.
Photos on the Mac
- Photos are even, square thumbnails that fill the window edge to edge. Drag the size slider, or use ⌘= and ⌘−.
- Photos has folders, nested as deep as you like. New Folder… makes one inside the folder you’re in, the path at the top takes you back up, and right-click a folder to rename it. Drop photos on a folder to add them there.
- Open a photo to see it in the Library window, with Previous, Next and Random in its folder, plus Open in Preview, a window of its own, Full Screen, Reveal and Share.
- Slideshow in the Photos header or the photo’s bar plays them as a slideshow.
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.
- ← and → step back and forward at any time, Space pauses, Esc stops.
- The controls on screen turn shuffle and loop on or off, change the timing and open the settings. The Slideshow menu has the same, plus the transition.
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.
- In Settings ▸ Playback ▸ Automatic Captions, choose Off, Home Videos or All Videos Without English Subtitles. Parekio works through them in the background, one at a time; the menu shows its progress.
- To caption particular videos now, select them in the Library and choose Library ▸ Make English Captions.
- A short home video takes a second or two. The first time, macOS may download its English speech model.
- It needs macOS 26 or later. Speech-to-text isn’t perfect, especially with music or noise behind it.
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:
- Type: Movie, Episode, Music, Photo, Home Video or Skip. Change it if Parekio guessed wrong.
- Match: with a TMDB key, each movie and show is looked up. A clear match shows a small poster; otherwise you choose from the likely matches.
- Destination: where it will go in the library, with its new name.
- Status: New, Needs a match, Not media, or Already in library (Skip, Replace or Keep Both).
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.
How files are named
| Kind | Where it goes |
|---|---|
| Movie | Movies/Arrival (2016)/Arrival (2016).mkv |
| Subtitles | Movies/Arrival (2016)/Arrival (2016).en.srt |
| Episode | TV/Northern Line (2019)/Season 02/Northern Line - S02E05 - The Signal Box.mkv |
| Music | Music/Ella Ruiz Quartet/Night Ferry (2019)/01 - Harbour Lights.flac |
| Photos | Photos/Lisbon Trip/IMG_0001.HEIC |
| Home video | Home 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.
- The section shows folders first, then videos as a thumbnail grid: a frame from each video (skipping black openings), with its length. The list view adds the date and size.
- New Folder… makes a folder inside the one you’re in. Right-click for Rename…, Reveal in Finder and Move to Trash.
- Drop files on the section or on a folder to add them there. Dropped folders keep their structure.
- In the review sheet, a home video’s Folder menu picks an existing folder, the folders it came in, or a new one (type
2024/Lisbon Tripto nest).
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:
- Fix Match…: search TMDB and pick the right title, optionally renaming the files to match.
- Edit Details…: your own title, year, description and poster. Your edits survive refreshes.
- Refresh Metadata: fetch details and artwork again.
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
- Sections open as easy-to-read lists. Press ✱ ▸ View to switch to posters; titles and years show under the art. Each section remembers its view.
- Movies sort by title, year or recently added, or show unwatched only (✱).
- TV goes show ▸ season ▸ episode. Music goes artist ▸ album ▸ track. Home Videos and Photos go folder by folder; a photo folder’s tile shows its name and how many photos it holds.
- Back goes up one level and returns to the row you were on.
Details
Movies and episodes open a Details screen with the backdrop, facts and description, and:
- Resume from … and Play from start, or Play.
- Audio & Subtitles, when there’s a choice, to pick before you play.
- Mark as Watched / Unwatched.
- More Info: the full description, cast, genres, and the file itself: format, resolution, audio, subtitles, size, and whether it plays directly or is converted.
- Extras, when a movie has any.
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
- Video uses the Roku’s own player controls for pause, rewind, fast forward and seeking.
- ✱ opens Options: the audio track and subtitles, including English (auto) when the Mac has made captions. Changing the audio of a converted video restarts it at the same spot after a few seconds.
- Pausing shows a reminder that ✱ has Subtitles and Audio.
- Press Back to stop. Your place is saved and the video shows up in Continue, on the Roku and on the Mac.
- When an episode ends, Parekio asks “Would you like to play the next episode?” Choose Yes or No; nothing plays on by itself.
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:
- Left / Right: previous / next track. Previous starts the current track again if it’s more than a few seconds in.
- Rewind / Fast Fwd: back or ahead 10 seconds.
- Play/Pause toggles. While an album is shuffled, Now Playing says so.
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:
- Play pauses and carries on; Left / Right (or Rewind / Fast Fwd) step back and forward.
- OK pauses and shows or hides the photo’s details.
- ✱ changes this slideshow’s speed (3, 5 or 10 seconds), shuffle and loop.
- The Roku’s screensaver stays away until the slideshow ends; Back stops it.
Remote keys
| Key | What it does |
|---|---|
| OK | Open, or choose the highlighted button |
| Back | Up 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 |
| Play | Play the highlighted episode or movie; start, pause or carry on a slideshow |
| Left Right | Previous / next movie or episode on Details; photos in the viewer and slideshows; tracks in Now Playing |
| Rewind Fast Fwd | Seek 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.
| How | What it means | Typical files |
|---|---|---|
| Directly | The 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 |
| Repackaged | The 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 |
| Converted | The 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.