Skip to main content

Download media and annotations

Tator provides the ability to download media and annotations for use on a local machine. Downloads can be done for a single media or in bulk on many media. When multiple files are being downloaded, Tator streams the files into a zip file on the client side, avoiding the need to package the files into an archive on the backend first. This tutorial will walk you through downloading individual media, multiple media, and annotations using the web interface, then show you how media can be downloaded in python using tator-py.

Download single media

Single media files can be downloaded by clicking the Download file button under the media card context menu. For videos, the highest resolution archival file will be downloaded if available, otherwise the highest quality streaming file will be downloaded. For images, the highest resolution image will be downloaded.

Download single media annotations

Media attribute values, localizations, and states for a single media can be downloaded using the Download metadata button under the media card context menu. This will download media types, localization types, and state types in JSON format, and media metadata, localizations, and states in both JSON and CSV format. All of these files are streamed into a zip file.

Download multiple media

All the media in the selected section can be downloaded by clicking the Download media button under the section context menu. Downloaded media may also be scoped by a search. All media files are streamed into a zip file.

Download multiple media annotations

Annotations for all media in a section can be downloaded by clicking the Download metadata button under the section context menu. Like media downloads, the downloaded metadata can be scoped by a media search. Media, localizations, states, and corresponding type information is all downloaded and streamed into a zip file.

Large downloads (>5,000 files or 60GB) will result in a warning in the web interface, which can be bypassed by the user. However, it is recommended that large downloads be done using the download_media utility as described in our developer guide.