Client library for the Frame.io API
Project description
python-frameio-client
Frame.io
Frame.io is a cloud-based collaboration hub that allows video professionals to share files, comment on clips real-time, and compare different versions and edits of a clip.
Overview
Installation
via Pip
$ pip install frameioclient
via Source
$ git clone https://github.com/frameio/python-frameio-client
$ pip install .
Note: The Frame.io Python client may not work correctly in Python 3.8+
Documentation
Usage
Note: A valid token is required to make requests to Frame.io. Go to our Developer Portal to get a token!
In addition to the snippets below, examples are included in /examples.
Get User Info
Get basic info on the authenticated user.
from frameioclient import FrameioClient
client = FrameioClient("TOKEN")
me = client.users.get_me()
print(me['id'])
Create and Upload Asset
Create a new asset and upload a file. For parent_asset_id you must have the root asset ID for the project, or an ID for a folder in the project. For more information on how assets work, check out our docs.
import os
from frameioclient import FrameioClient
client = FrameioClient("TOKEN")
# Create a new asset manually
asset = client.assets.create(
parent_asset_id="1234abcd",
name="MyVideo.mp4",
type="file",
filetype="video/mp4",
filesize=os.path.getsize("sample.mp4")
)
# Create a new folder
client.assets.create(
parent_asset_id="",
name="Folder name",
type="folder" # this kwarg is what makes it a folder
)
# Upload a file
client.assets.upload(destination_id, "video.mp4")
