This repository contains a collection of scripts for interacting with the Aviary Platform via its public API. These scripts are designed to help external users import and export audiovisual assets and metadata to and from Aviary efficiently and securely.
Aviary is a platform that allows libraries, archives, museums, and other cultural heritage organizations to manage, describe, and provide time-based access to their audiovisual materials. Aviary makes content discoverable through transcription, indexing, and search tools—all within a user-friendly, browser-based interface.
This repository provides example and utility scripts that demonstrate how to:
- Import media files and metadata into Aviary collections
- Export metadata and asset information from Aviary
- Automate common workflows using the Aviary API
The scripts are written in Python and use the Aviary RESTful API.
- Python 3.7+
- An Aviary account with API access
- Your organization’s Aviary base URL (e.g.,
https://yourorganization.aviaryplatform.com) - An Aviary API key
Before running a script, you will typically need to update the following:
base_url: Your organization’s Aviary instance URLtoken: Your Aviary API key- Input/output paths or CSV file locations as needed
Each script includes inline comments to guide configuration.
Aviary Full Package Import– Upload complete Aviary packages, including resources, media files, indexes, transcripts, and supplemental files to an existing collection. The process replicates the normal Aviary Package Import process available with the Aviary web user interface (without requiring the user to zip the package and upload it). See more information about the Aviary Package Import here.Media Files Import– Upload media files to attach to existing resources.Transcript Download– Batch export and download all formats of transcripts for media files listed on a CSV.
📌 See individual script files for usage instructions.
Media Files Import and Aviary Full Package Import upload local media files straight to Aviary's storage. Files up to 100 MB (MULTIPART_THRESHOLD) are sent in a single request. Larger files are sent as a multipart (chunked) upload in 100 MB chunks (PART_SIZE), and each chunk is retried on its own if it fails, so files up to 25 GB upload without loading the whole file into memory. Set MULTIPART_UPLOAD = False in the script to always use the single-request upload (max 5 GB per file).
You can explore the Aviary API documentation and try requests using the live demo at:
🔗 https://www.aviaryplatform.com/api/v1/documentation
This repository is provided under the MIT License. See LICENSE for details.
For issues related to Aviary accounts, configuration, or permissions, please contact Aviary support.