Quick Start: How to use AVAnnotate

LnRiLWdyaWQsLnRiLWdyaWQ+LmJsb2NrLWVkaXRvci1pbm5lci1ibG9ja3M+LmJsb2NrLWVkaXRvci1ibG9jay1saXN0X19sYXlvdXR7ZGlzcGxheTpncmlkO2dyaWQtcm93LWdhcDoyNXB4O2dyaWQtY29sdW1uLWdhcDoyNXB4fS50Yi1ncmlkLWl0ZW17YmFja2dyb3VuZDojZDM4YTAzO3BhZGRpbmc6MzBweH0udGItZ3JpZC1jb2x1bW57ZmxleC13cmFwOndyYXB9LnRiLWdyaWQtY29sdW1uPip7d2lkdGg6MTAwJX0udGItZ3JpZC1jb2x1bW4udGItZ3JpZC1hbGlnbi10b3B7d2lkdGg6MTAwJTtkaXNwbGF5OmZsZXg7YWxpZ24tY29udGVudDpmbGV4LXN0YXJ0fS50Yi1ncmlkLWNvbHVtbi50Yi1ncmlkLWFsaWduLWNlbnRlcnt3aWR0aDoxMDAlO2Rpc3BsYXk6ZmxleDthbGlnbi1jb250ZW50OmNlbnRlcn0udGItZ3JpZC1jb2x1bW4udGItZ3JpZC1hbGlnbi1ib3R0b217d2lkdGg6MTAwJTtkaXNwbGF5OmZsZXg7YWxpZ24tY29udGVudDpmbGV4LWVuZH1AbWVkaWEgb25seSBzY3JlZW4gYW5kIChtYXgtd2lkdGg6IDc4MXB4KSB7IC50Yi1ncmlkLC50Yi1ncmlkPi5ibG9jay1lZGl0b3ItaW5uZXItYmxvY2tzPi5ibG9jay1lZGl0b3ItYmxvY2stbGlzdF9fbGF5b3V0e2Rpc3BsYXk6Z3JpZDtncmlkLXJvdy1nYXA6MjVweDtncmlkLWNvbHVtbi1nYXA6MjVweH0udGItZ3JpZC1pdGVte2JhY2tncm91bmQ6I2QzOGEwMztwYWRkaW5nOjMwcHh9LnRiLWdyaWQtY29sdW1ue2ZsZXgtd3JhcDp3cmFwfS50Yi1ncmlkLWNvbHVtbj4qe3dpZHRoOjEwMCV9LnRiLWdyaWQtY29sdW1uLnRiLWdyaWQtYWxpZ24tdG9we3dpZHRoOjEwMCU7ZGlzcGxheTpmbGV4O2FsaWduLWNvbnRlbnQ6ZmxleC1zdGFydH0udGItZ3JpZC1jb2x1bW4udGItZ3JpZC1hbGlnbi1jZW50ZXJ7d2lkdGg6MTAwJTtkaXNwbGF5OmZsZXg7YWxpZ24tY29udGVudDpjZW50ZXJ9LnRiLWdyaWQtY29sdW1uLnRiLWdyaWQtYWxpZ24tYm90dG9te3dpZHRoOjEwMCU7ZGlzcGxheTpmbGV4O2FsaWduLWNvbnRlbnQ6ZmxleC1lbmR9IH0gQG1lZGlhIG9ubHkgc2NyZWVuIGFuZCAobWF4LXdpZHRoOiA1OTlweCkgeyAudGItZ3JpZCwudGItZ3JpZD4uYmxvY2stZWRpdG9yLWlubmVyLWJsb2Nrcz4uYmxvY2stZWRpdG9yLWJsb2NrLWxpc3RfX2xheW91dHtkaXNwbGF5OmdyaWQ7Z3JpZC1yb3ctZ2FwOjI1cHg7Z3JpZC1jb2x1bW4tZ2FwOjI1cHh9LnRiLWdyaWQtaXRlbXtiYWNrZ3JvdW5kOiNkMzhhMDM7cGFkZGluZzozMHB4fS50Yi1ncmlkLWNvbHVtbntmbGV4LXdyYXA6d3JhcH0udGItZ3JpZC1jb2x1bW4+Knt3aWR0aDoxMDAlfS50Yi1ncmlkLWNvbHVtbi50Yi1ncmlkLWFsaWduLXRvcHt3aWR0aDoxMDAlO2Rpc3BsYXk6ZmxleDthbGlnbi1jb250ZW50OmZsZXgtc3RhcnR9LnRiLWdyaWQtY29sdW1uLnRiLWdyaWQtYWxpZ24tY2VudGVye3dpZHRoOjEwMCU7ZGlzcGxheTpmbGV4O2FsaWduLWNvbnRlbnQ6Y2VudGVyfS50Yi1ncmlkLWNvbHVtbi50Yi1ncmlkLWFsaWduLWJvdHRvbXt3aWR0aDoxMDAlO2Rpc3BsYXk6ZmxleDthbGlnbi1jb250ZW50OmZsZXgtZW5kfSB9IA==

Step 1

Log into AVAnnotate with your GitHub credentials and create a new project

Navigate to the AVAnnotate application and sign in with your GitHub credentials. If you don’t have an account already, go to GitHub and create one by providing a username, email address, and password.

Select “Add,” and input the following information about your new project:

Title
Description
Language
Slug (no spaces or special characters!)
Author
Select a media player. For now, you should always select the AVAnnotate Viewer; in the future, there will be an option to include Aviary for video.

Step 2

Upload files containing Events, Tags, and Annotations

Download the AVAnnotate Tags template and add/edit your tags according to the columns. You can import this file at the beginning of your project from the initial “Add” page, or later using the “Tags” button.
- The Tags spreadsheet must be saved as .csv in order for the application to read it properly.
Download the AVAnnotate Event template and add/edit information about your audiovisual materials. Depending on your project, you may be annotating multiple Events, or the same Event may appear on multiple recordings. Regardless, the Events will all be contained in the same spreadsheet, but will require separate Annotation templates (see next step). Add your Event spreadsheet to the project using the “Import” button.
Download the AVAnnotate Event Annotations template and add/edit the annotations according to your project. Once you’ve imported your Annotations spreadsheet, you can edit and save annotations through the AVAnnotate interface.

Review the following drop-down options for more information about linking AV materials in the Events spreadsheet.

My file is online and I have a direct URL

If you can access a direct link to the audiovisual item, you can add that URL directly to AudiAnnotate to import the material. A direct link should open the item in a web browser as a standalone object. It should begin as a web address and end with the file format, e.g. .mp3, .mp4, .wav, etc.

Select “Create Item Manifest” in your project, and add the required metadata for your project. This includes a label, audio file URL, duration of audio, item homepage URL, provider name, and provider URL.

My file has an IIIF Manifest

Some institutions provide access to a IIIF manifest. In these cases, you can put the URL for the manifest directly into AudiAnnotate to import the material.

Select “Import Existing Manifest” in your project, and input the IIIF manifest URL.

What is a IIIF manifest?
A IIIF manifest includes the information you will provide when you build your project, upload a URL to an audiovisual item and associated metadata, and add annotation layers.

My file does not have a direct link or IIIF Manifest

If neither a direct link nor a IIIF manifest are available, you can create your own direct link by uploading the audiovisual item to the Internet Archive. This is the best option for audiovisual items in your personal collection or audiovisual items available for download online.

Follow the the instructions under “Creating a Direct Link.”

Step 3

Add pages to build context around your Events and Annotations

In the Events interface, select “Pages.” Pages associated with each Event’s annotations will auto-generate once you’ve completed steps 1 and 2, and now you can add additional pages of text and images. What appears on these Pages is entirely up to the user; users may add an introduction or conclusion to the project; build separate sections of an accompanying analytical essay; add context or pedagogical implications of the Events and annotations; explain the annotation choices made in the project; etc.

Step 4

Share your AVAnnotate project with the world!

You can read more about how to use AVAnnotate here: https://hipstas.github.io/ava_docs/, or watch the recorded workshop below:

Explore more work created with AVAnnotate

Anne Sexton, Sweetbriar College, 1966

This an annotated recording featuring Anne Sexton reading at Sweetbriar in 1966. The recording is held as part of the Anne Sexton Papers at the Harry Ransom Center at the University of Texas, Austin. The annotations were created by Dr. Tanya Clement.

Audio

LiteraturePoetry

More projects