Helpful Tips

  • Logging into AVAnnotate requires a GitHub account.

  • AVAnnotate does not store uploaded media; instead, it references media files via URL or manifest. Collect the project’s audiovisual media URLs, file paths, and manifests in a document before pasting them into AVAnnotate. See AV Formats and Support for a list of supported AV file paths/URL types, and our Privacy Statement for information about GitHub’s privacy policies.

  • It is highly recommended that project authors create spreadsheets for events, tags, and annotations using spreadsheet software (Excel, Google Sheets, etc.) to upload before customizing a project via the AVAnnotate editing interface. See Spreadsheet Templates for spreadsheet templates, documentation, and examples.

  • GitHub can be slow and generating web pages can take time and be finicky. If uploading several unique annotation sets to a single project, it is recommended to upload one set at a time, build the associated project page(s), and assess if the page build has been successful before uploading more annotation sets. Once it is determined that tags and annotation pages are building successfully, users might toggle off ‘Auto Generate Pages’ under a project’s ‘Settings’ before making multiple changes and toggling it back on when ready for the application to build online project pages. See Projects for more information.

  • Tags are a powerful way for users to sort, filter, and discover annotations across an entire project. Tags should be clear, succinct, and triple-checked for typos and capitalization errors before introducing them in a project. Ideally tags and tag groups are uploaded before uploading any annotations with those tags.