playr guide

It applies to playr version 2.0.

Get playr

playr requires a Mac with Apple silicon and macOS 26. To install it, open the downloaded file and move playr to your Applications folder. Premiere Pro is required only if you send clips to it.

You can use playr free for 7 days on each Mac. One license covers college football and men’s and women’s college basketball.

If you already have a license, sign in to your account.

Before the game

Set each camera’s clock

playr matches each clip to a play by the time the camera recorded it, so each camera’s clock must match the local time at the game.

  1. Open playr and read the clock in the toolbar.

  2. Set each camera’s clock to that time, to the second if the camera allows it.

  3. Set each camera’s time zone and daylight saving setting for the game’s location.

Hold the pointer over the toolbar clock to see its time zone and whether daylight saving time is in effect. Before you open a folder, the clock shows the time in your Mac’s time zone. After you set up a folder’s game, it shows the local time at the game. If your Mac is in a different time zone from the game, set each camera to the local time at the game.

To correct a camera’s clock later, see The camera clock.

Use one folder per camera

Copy each camera’s footage into a separate folder on your Mac, and open the folders in playr one at a time. Each folder has its own camera name, such as CAM A.

Flag clips while you shoot

After a play you want to keep, film a clip of two seconds or less. playr marks the clip before it as Select. See Flag clips.

Operating playr

You can use playr during the game. Open the clips you have, and add more as you shoot.

  1. Open the folder

    Choose File > Open Footage Folder… ⌘O and select one camera’s folder.

  2. Set up the game

    Under Sport, choose Football, Men’s basketball or Women’s basketball. Confirm the Game date, Time zone and Camera. Choose Your team, then the Game. The Opponent’s short name, such as MIA, appears in every clip name. Click Set Up Game.

    playr renames each clip and moves it into a folder for its period, such as Q1 or H1, inside the camera’s folder.

    If the game has no play-by-play, choose Quarter times only (no play-by-play) under Label clips by, and enter the time each quarter started. For men’s basketball, the option is Half start times only (no play-by-play). You can change these settings later in Game > Game Settings… ⇧⌘,.

  3. Review Decide clips

    A clip marked Decide requires you to confirm or choose its play. Click Decide above the list ⌃3 to show only those clips. Watch each clip, then click Use This Play Return, Not a Play ⇧⌘B or Choose Play… ⇧⌘M.

    When a clip could show more than one play, the card lists each play with a checkbox. Select the plays the clip shows and click Use 2 Plays, or click Clip Covers All 2 Plays if it shows all of them.

    In basketball, a clip is marked Decide when a key moment falls at the very start or end of the clip. The card lists the moments without suggesting one, so it has no Use This Play button. Select the moments the clip shows, or click Not a Play or Choose Play… instead.

    Choose Play… lists the game’s plays. Click a play to select it, and click it again to deselect it. Each change takes effect immediately, and ⌘Z undoes the last one. In basketball, the list shows every event in the game, with key moments in bold. Two lines mark where the clip starts and ends. A play that falls within the clip but is missing from its name is labeled On clip, not in name.

  4. Choose the plays in a clip’s name

    When a clip contains two or more plays, each play listed under the video has a checkbox. Selecting or deselecting a play renames the clip immediately. Press ⌘Z to undo the change.

    A deselected play stays with the clip and appears on an Also: line in the lists. In football, every play is selected by default. In basketball, your team’s moments are selected by default.

  5. Mark Selects

    Mark the clips you want to keep as Select ⌘4 and the clips you won’t use as Reject ⌘5. Only Selects are sent to Premiere.

  6. Describe a clip

    Type a description in the Describe this clip field under the video. Press ⌘L to move to the field. playr saves the description when you press Return or move to another clip, and adds it to the clip’s name.

    In a game with play-by-play, type =22 followed by a space to insert #22 and that player’s last name. Type ==22 to insert the full name.

Add more clips

To add clips filmed later in the game, copy them into the same folder and choose File > Add Clips… ⌘I. Then click Add.

To send your Selects to Premiere Pro, see Sending to Premiere.

Clip names

By default, a clip’s name is its Date, Opponent, Quarter, Camera, Clip number, Play, Description and Rating, separated by underscores.

20260119_MIA_Q4_CAM A_087_#15 Mendoza run 12 yd TD_end zone angle_amazing.mp4

The clip number has three digits and counts up through each period. The period is one of the following:

FootballPRE, Q1, Q2, HALF, Q3, Q4, OT, POST
Men’s basketballPRE, H1, HALF, H2, POST, then OT and 2OT
Women’s basketballPRE, Q1, Q2, HALF, Q3, Q4, POST, then OT and 2OT

In men’s basketball, the Quarter part is named Half. A basketball clip that runs past the end of a period stays in the period of the play it is named for.

Change the parts

Choose Game > Clip Names… and select the parts to include. Use the arrows to move a part earlier or later. Clip number cannot be removed, which keeps every clip name unique.

The Between parts setting can be Underscore, Hyphen or Space, and Date format can be 20260912 or 2026-09-12. Click Use These Names to rename the files.

Play text

New folders use Last names by default.

StyleFootballBasketball
Full names#22 Jamal Haynes run 8 yd#3 Jalen Smith three, assist #5 Ty Lee
Last names#22 Haynes run 8 yd#3 Smith three, assist #5 Lee
Numbers only#22 run 8 yd#3 three, assist #5
Play typeRun 8 ydThree

Basketball play names

playr names a basketball clip for its key moments. A key moment is one of the following:

  • a made basket, with its type (jump shot, layup, dunk, tip-in, hook shot, three or alley-oop) and the assist
  • a steal or a block
  • a trip to the free throw line, named with the number made, as in #3 Smith free throws 2 of 2

An and-one or a buzzer beater is added to the basket’s name, as in #3 Smith layup and one, assist #11 Jones or #3 Smith three buzzer beater. A clip is never named for a miss, foul, rebound, other turnover, substitution or timeout alone. Choose Play… still lists these events, so you can choose one.

Your team’s moments take priority. A clip that contains any of them is named for those moments. A clip that contains only the other team’s moments is named for them, with that team’s short name first, as in NORF #23 dunk, assist #15. Multiple moments in one clip are joined with “then”, as in #3 Smith steal then dunk. A clip with no key moment has no play text.

In the example above, clip H1 · 003 contains two of the other team’s key moments, a steal and a dunk. In the Numbers only style, its name is:

20261117_NORF_H1_CAM A_003_NORF #15 steal then #23 dunk, assist #15.mp4

The Show every event switch adds all other events to the Plays tab and the Timeline. In Details, a court diagram replays each shot, as the field map does for a football play.

For a bench or crowd clip, Choose Play… offers the last key moment before the clip, with the options Bench Reaction and Crowd Reaction. Either option assigns the clip to that play and starts its description with “bench” or “crowd”.

Clips without a play

Empty parts are omitted from the name. A Decide clip has no play until you choose one, so its name ends at the clip number:

20260119_MIA_Q1_CAM A_005.mp4

A clip marked Not a Play is named the same way. Clips filmed before the game, at halftime or after the game are placed in PRE, HALF or POST and never have a play:

20260119_MIA_PRE_CAM A_003.mp4

If a name would be too long, playr shortens the play text at a word boundary, then the description.

The File card in Details shows the camera’s original file name and playr’s name for a clip.

Rename a clip in Finder

A clip you rename in Finder keeps its play and the name you gave it. It shows a Custom name tag, and changes in Clip Names do not affect it. To restore playr’s name, choose Clip > Use playr’s Name.

To change only the play text in a name, choose Clip > Custom Play Text… ⇧⌘L.

Share the naming setup with your crew

In Clip Names, click Share Naming Setup… to save your setup as a file, then send the file to your crew. Each shooter clicks Import Naming Setup…, chooses the file and clicks Use These Names. playr also applies the imported setup to new folders on that Mac.

Restore the camera file names

Choose File > Restore Camera Filenames… to return every clip to its original camera file name. To use playr with the folder again, reopen it.

The camera clock

If a camera’s clock did not match the local time at the game, set an offset. The offset shifts every clip in the folder by the same amount.

To open the Camera Clock, choose Game > Camera Clock… ⌘K or click the Camera Clock button in the toolbar.

Set the offset from a clip

  1. Select a clip whose play you know.

  2. Open the Camera Clock.

  3. Click Set Clock From a Clip… and choose the play the clip shows. For a more accurate offset, match several clips from different parts of the game.

  4. Under Offset, review the result and the number of clips that line up, then click Apply.

Clips that move to a different play are renamed. Press ⌘Z to undo the change.

Type the offset

  1. Open the Camera Clock.

  2. In the Offset box, enter the difference in seconds, m:ss or h:mm:ss, up to 14 hours.

  3. Choose behind or ahead, then click Apply.

Choose behind if the camera’s clock was earlier than the actual time, and ahead if it was later. For example, if the camera read 7:00:00 PM when the actual time was 7:01:30 PM, enter 1:30 and choose behind.

If you filmed a clock with the camera, click Read a Filmed Clock… to read the time from that clip. Click Clear to return to the camera’s recorded time.

Selects and ratings

Select ⌘4 marks a clip you want to keep and adds a green Finder tag to the file.

For a clip you won’t use, press Reject ⌘5, which adds a red Finder tag. Press the same shortcut again to remove the mark.

When you open a folder, playr reads any tags already on the files.

Flag clips

A clip of two seconds or less is a flag clip. playr marks the clip before it as Select. The flag clip itself is marked Reject and is never sent to Premiere.

When you add clips, the Clear existing Select and Reject tags checkbox removes tags already on the files. Flag clips still mark the clip before them.

Ratings

Use the buttons under the video to rate a clip Bad, Good ⌘1, Great ⌘2 or Amazing ⌘3. Click the rating again or press ⌘0 to clear it. The rating is added to the end of the clip’s name in lowercase, such as _great.

Sending to Premiere

  1. Open your project in Premiere Pro.

  2. In playr, choose File > Send Selects to Premiere… ⌘E.

  3. Confirm the Bin name and click Send.

Each clip keeps its playr file name, with its description in Premiere’s Description column and its play in the Log Note column. The bin links to the clips in your folder, so do not move them.

Your license

Choose playr > License… to view the license on this Mac. Your account page is at account.playr.vivin.media.

The trial

The trial lasts 7 days on each Mac and needs no payment card. It starts the first time playr goes online, and playr works offline after that. The playr menu shows the days remaining.

Deleting playr or erasing your Mac does not start a new trial. After the trial, playr needs a key or join code to open.

Enter a key

Your individual license key is emailed to you after payment. The key has 20 letters and numbers.

  1. Choose playr > License… in the menu bar.

  2. Paste the key into Key or join code.

  3. Click Continue.

If the trial has ended, the lock screen has the same field and Continue button.

Move to a new Mac

An individual key works on one Mac at a time.

  1. On the old Mac, choose playr > License… and click Release This Mac. playr stops working on that Mac immediately.

  2. If you no longer have the old Mac, sign in at account.playr.vivin.media and click Release next to it. The old Mac stops using the license the next time it goes online, or within 30 days at the latest.

  3. On the new Mac, enter the key.

You can add a key to at most 3 new Macs in any 30-day period. If you need more, email vivin@vivin.media.

Department join codes

A department license uses a join code in place of a key. The admin signs in at account.playr.vivin.media, copies the join code and shares it with the crew. A join code has 12 letters and numbers. Each shooter then completes these steps in playr:

  1. Choose playr > License…, type the code into Key or join code and click Continue.

  2. Enter your name so the admin can identify your Mac. A first name is sufficient. Click Join.

Department Macs have no Release This Mac button.

The account page lists every Mac that has joined. Clicking Make a new code replaces the join code, and Macs that have already joined remain on the license. After you click Remove, a Mac stops using the license the next time it goes online, or within 30 days at the latest.

Working offline

playr works without an internet connection once a game’s plays are loaded. It checks your license automatically whenever your Mac is online. After each check, your Mac can stay offline for up to 30 days.

From day 23, a notice at the top of the window reads “Connect to the internet in the next 7 days to keep using playr.” with the number of days remaining. After 30 days offline, playr shows “playr needs to check your license. Connect to the internet and playr unlocks by itself.” when it opens. If day 30 passes while playr is open, it keeps working until you quit.

When a license ends

A license ends when it is canceled and the paid period expires, or when it is refunded. If a card payment fails, playr keeps working for 7 days after the paid date while the payment is retried. If your license does not renew automatically, playr shows the end date in a notice starting 14 days before the license ends.

playr does not lock while it is open. It locks the next time you open it.

To use playr again, buy a license at account.playr.vivin.media or enter another key or join code.

Canceling and refunds

To cancel a license paid by card, sign in at account.playr.vivin.media and click Billing and receipts. The license remains active until the end of the paid period. To request a refund, email vivin@vivin.media within the refund window.

If something looks wrong

Clips are off by a whole number of hours

A camera with an incorrect daylight saving or time zone setting records every clip off by a whole number of hours. playr detects this and shows a message below the toolbar:

“Your camera looks exactly 1 hour behind. This usually means its daylight saving setting or time zone is wrong.”

Click Fix 1 Hour. playr shifts the clips and shows several of them with the plays they now match. Confirm that the matches are correct. A difference of two or more hours usually means the time zone is wrong, and the button reads Fix 2 Hours or Fix 3 Hours.

Click Not Now to hide the message for this folder. The message remains at the top of the Camera Clock.

Clips are placed before or after the game

When most of the clips you add fall outside the game, the camera clock is probably off by an amount other than whole hours. playr shows a message such as:

“Most of the new clips landed before kickoff. The camera clock may be off.”

The message can also say after the final whistle, or that most of the new clips need a play picked. In basketball, it says before tip-off or after the final buzzer, or “Few of the new clips hold a basket, steal or block.”

Click Check Camera Clock. playr selects a clip from the first period and opens the Camera Clock. Watch the clip, then set the offset from it as described in The camera clock. If the clips are still misplaced, check the game date and time zone in Game > Game Settings… ⇧⌘,.

A clip is missing

If a video file is in the folder but does not appear in playr, choose File > Add Clips… ⌘I.

A clip labeled File missing was moved or deleted in Finder. Return the file to the folder.

A play is missing

playr downloads new plays automatically during the game and for one day afterward. To download them immediately, choose Game > Get Latest Plays ⇧⌘R.

Plays couldn’t refresh

playr shows “Plays couldn’t refresh. Saved plays still work.” when it cannot reach the game’s play-by-play data, usually because your Mac is offline. Click Retry when your Mac is online again.

The Send to Premiere sheet shows a message

“3 Selects still need a play.” Some Selects are still Decide clips. You can send them without a play, or click Go to Clip to choose their plays first.

“Sent 12 of 15 clips to Premiere.” Some clips could not be read. The sheet lists them under These clips were skipped, each with the reason. Return the files to the folder and send again.

The key is already in use

If the old Mac was not released, the new Mac shows “This key is already in use on another Mac. Release it there or on your account page at account.playr.vivin.media first.” See Move to a new Mac.

The trial does not start

If your Mac is offline the first time you open playr, playr shows “Connect to the internet once to start your 7 day trial.” Connect to the internet and click Try Again.

Report a problem

When you choose Help > Report a Problem…, playr creates a small zip file that contains its recent log, the playr and macOS versions, the Mac model, and the open folder’s labels and game. The zip file never includes footage. playr then opens a new Mail message addressed to vivin@vivin.media with the zip file attached.

Describe what you were doing when the problem occurred. If Mail cannot open a message, playr shows the zip file in Finder so you can attach it to an email yourself.

Keyboard shortcuts

This list is also available in playr under Help > Keyboard Shortcuts.

Moving around
↑ or ↓Previous or next clip
⌘↑ or ⌘↓Previous or next clip, even while typing
⌃⌘1, ⌃⌘2, ⌃⌘3Timeline, Clips, Plays
⌃1, ⌃2, ⌃3All, Selects, Decide
⌃⌘RShow the current clip in the list
⌥⌘IShow or hide Details
Deciding
ReturnUse this play
Shift-ReturnClip covers all possible plays
⇧⌘BNot a play
⇧⌘MChoose play
⌥↑ or ⌥↓Previous or next play
⌥⌘RBack to playr’s pick
Tagging
⌘4Select (green)
⌘5Reject (red)
⌘1, ⌘2, ⌘3Good, Great, Amazing
⌘0Clear the rating
⌘LType a description
⇧⌘LType your own play text for the clip name
=22 in a descriptionPlayer number 22’s name
Playing
SpacePlay or pause
J, K, LBackward, stop, forward (press again to go faster)
K with J or LOne frame back or forward
Folder and game
⌘OOpen a footage folder
⌘IAdd clips
⇧⌘,Game settings
⌘KCamera clock
⇧⌘RGet latest plays
⌘ESend Selects to Premiere (File menu)
⌘Z or ⇧⌘ZUndo or redo