AVAnnotate Frequently Asked Questions
What do I need to use AVAnnotate?
To use AVAnnotate, you will need:
- a GitHub account
- a direct link to the file of your audio or video or a IIIF manifest for the recording.
- time-stamped annotations. You can add them one-at-a-time or upload spreadsheets containing information about the project’s Events, Tags, and Annotations.
What kinds of media are appropriate to annotate in AVAnnotate?
Anything that’s freely available online! That’s one answer. Ethical and responsible use would include open-access recordings and works released under Creative Commons licenses. Commercial films, streaming media, and other copyrighted videos may not be used without explicit permission to redistribute. When the rights status is unclear, permissions should be confirmed before proceeding. For more information on ethical use, please see our AVAnnotate User Guidelines and Resources
Where can I find audio or video files that provide direct links or IIIF manifests?
Many libraries, archives, and museums offer online AV files that are free and open to the public. They may also offer IIIF manifests for digitized audio and video recordings. The (Internet Archive)[https://archive.org/] is a great resource for finding direct links to AV (MP3s and MP4s) or IIIF manifests for audio and video files.
How do I decide what to annotate?
Annotate moments that support the project’s overall goals and purpose. Identify patterns, themes, transitions, gestures, sound changes, or tonal shifts. If everything is marked, nothing is meaningful. Focus on analytical relevance rather than exhaustiveness. See Approaches and Annotated Example Projects and tips for Researchers on our AVAnnotate User Guidelines.
How do I get started creating annotations?
Getting started is easy! You can create annotations using the AVAnnotate dashboard, or you can create your annotations in spreadsheets and upload them through the AVAnnotate dashboard. The spreadsheet templates are designed to help you get started. You can download a copy of each spreadsheet template (one for Events, Tags, and Annotations., respectively).
How many annotations should a project include?
There is no minimum or maximum, but clarity matters. A small number of well-defined annotations is more effective than hundreds of granular timestamps with no interpretive purpose. Aim for single-idea units: one annotation should explain one meaningful moment or feature.
Does each cell on my Annotations, Events, and Tags spreadsheet have to be filled in?
Yes! If there is any data in any cell, the whole column should be filled in. (AVAnnotate will let you ignore some columns completely too.)
How do I format multiple tags on a single annotation?
In the AVAnnotate editing interface, after adding tags and tag categories, multiple tags can be added to a single annotation by selecting them from the available tag list. For bulk uploading, adding multiple tags is a little different). In the “tags” column, tags and their corresponding categories should be separated by a vertical bar, like this: Tag 1 | Tag 2, and so on. For example, in “Zora Neale Hurston’s WPA Field Recordings in Jacksonville, FL (1939)”, the first annotation includes two tags: “Unknown” and “Singing,” which would show up in the template’s “Tag” column as Unknown | Singing.
How should I choose tag groups?
Tags should organize projects, not decorate them. Before starting an AVAnnotate project, define a small, coherent vocabulary to use for the project’s tags. If a project’s tag list grows too long, the tags become less effective. Tag categories should reflect conceptual priorities, not every minor detail.
What does “OAuth” mean, and what am I giving GitHub permission to access?
OAuth enables applications to interact with a user’s GitHub account, such as accessing repositories or user data, after the user grants permission. To create and edit an AVAnnotate project, the application must have permission to access the GitHub account where the repository will be created. See the AVAnnotate Privacy and Permissions Statement.
I received an email from GitHub stating “Run failed: Deploy main branch to GitHub Pages.” What should I do?
Nothing. This email is automatically generated by GitHub when an event is interrupted, but many activities are interrupted during the generation of an AVAnnotate project. If your project still works, please ignore these emails.