Frame.io: import your project masters

The Frame.io connector pulls video files straight from Frame.io into Peithos, so review-and-approval footage becomes source-backed pages without a download-and-reupload dance. The connection is read only: Peithos browses your projects and copies only the files you choose.

What you need

A Frame.io V4 account, and an admin role in your Peithos workspace to connect it. Peithos signs you in through Adobe. To pull an original master, you need download permission on the project the file lives in; assets that require a watermark withhold the underlying file, so those cannot be imported.

Adding the app

1. Open Import in your workspace

   Sign in to Peithos and open the Import view. The Frame.io card sits with the other video sources. You need an admin role in the workspace to connect accounts.

2. Click Connect

   You are sent to Adobe's own sign-in and consent screen, since Frame.io authenticates through Adobe. It lists exactly what Peithos asks for: read access to your Frame.io content. Peithos never sees your Adobe password.

3. Approve and return

   After you approve, Adobe sends you back to Peithos and the card shows Connected. The refresh token is stored encrypted and used only on our servers.

   In Peithos

   1. Import
   2. Connected libraries
   3. Frame.io

   

Using the app

Once connected, the Frame.io card lets you browse down through your accounts, then workspaces, then projects, to the video files. Tick the files you want and add them to the import queue. Before anything runs, Peithos shows what the run produces and how it draws from your current allowance. When the import runs, Peithos resolves a fresh signed link to the original master, so processing starts from the real source, not a player re-encode.

Processing produces a transcript tied to exact timestamps, chapters, verbatim quotes, claims marked by how well they are sourced, and named speakers. Nothing publishes without your review and approval.

Troubleshooting

• The connect button says denied. Connecting is limited to workspace admins. Ask a workspace admin to connect, or to make you an admin.
• A file will not import. Pulling the original requires download permission on that project. If you lack download permission, or the asset requires a watermark, Frame.io withholds the file and Peithos cannot pull it.
• The connection shows needs attention. This means the token was revoked. Click Connect again to reauthorize; your imported videos are unaffected.
• Browsing comes back empty. If Frame.io is having trouble, the browse can return empty. Peithos retries later; wait a moment and try again.

Removing the app

Open the Frame.io card in Peithos and click Disconnect. This deletes the stored token from our systems immediately and stops all further access. You can also remove Peithos from your Adobe account's connected apps on the provider side.

After removal, Peithos can no longer see your Frame.io content. Videos you already imported remain in your Peithos library, because they are your workspace content; delete them there whenever you want, or ask us to. Reconnecting later starts a fresh authorization from the beginning.