Quick Start: How to use AudiAnnotate

LnRiLWdyaWQsLnRiLWdyaWQ+LmJsb2NrLWVkaXRvci1pbm5lci1ibG9ja3M+LmJsb2NrLWVkaXRvci1ibG9jay1saXN0X19sYXlvdXR7ZGlzcGxheTpncmlkO2dyaWQtcm93LWdhcDoyNXB4O2dyaWQtY29sdW1uLWdhcDoyNXB4fS50Yi1ncmlkLWl0ZW17YmFja2dyb3VuZDojZDM4YTAzO3BhZGRpbmc6MzBweH0udGItZ3JpZC1jb2x1bW57ZmxleC13cmFwOndyYXB9LnRiLWdyaWQtY29sdW1uPip7d2lkdGg6MTAwJX0udGItZ3JpZC1jb2x1bW4udGItZ3JpZC1hbGlnbi10b3B7d2lkdGg6MTAwJTtkaXNwbGF5OmZsZXg7YWxpZ24tY29udGVudDpmbGV4LXN0YXJ0fS50Yi1ncmlkLWNvbHVtbi50Yi1ncmlkLWFsaWduLWNlbnRlcnt3aWR0aDoxMDAlO2Rpc3BsYXk6ZmxleDthbGlnbi1jb250ZW50OmNlbnRlcn0udGItZ3JpZC1jb2x1bW4udGItZ3JpZC1hbGlnbi1ib3R0b217d2lkdGg6MTAwJTtkaXNwbGF5OmZsZXg7YWxpZ24tY29udGVudDpmbGV4LWVuZH1AbWVkaWEgb25seSBzY3JlZW4gYW5kIChtYXgtd2lkdGg6IDc4MXB4KSB7IC50Yi1ncmlkLC50Yi1ncmlkPi5ibG9jay1lZGl0b3ItaW5uZXItYmxvY2tzPi5ibG9jay1lZGl0b3ItYmxvY2stbGlzdF9fbGF5b3V0e2Rpc3BsYXk6Z3JpZDtncmlkLXJvdy1nYXA6MjVweDtncmlkLWNvbHVtbi1nYXA6MjVweH0udGItZ3JpZC1pdGVte2JhY2tncm91bmQ6I2QzOGEwMztwYWRkaW5nOjMwcHh9LnRiLWdyaWQtY29sdW1ue2ZsZXgtd3JhcDp3cmFwfS50Yi1ncmlkLWNvbHVtbj4qe3dpZHRoOjEwMCV9LnRiLWdyaWQtY29sdW1uLnRiLWdyaWQtYWxpZ24tdG9we3dpZHRoOjEwMCU7ZGlzcGxheTpmbGV4O2FsaWduLWNvbnRlbnQ6ZmxleC1zdGFydH0udGItZ3JpZC1jb2x1bW4udGItZ3JpZC1hbGlnbi1jZW50ZXJ7d2lkdGg6MTAwJTtkaXNwbGF5OmZsZXg7YWxpZ24tY29udGVudDpjZW50ZXJ9LnRiLWdyaWQtY29sdW1uLnRiLWdyaWQtYWxpZ24tYm90dG9te3dpZHRoOjEwMCU7ZGlzcGxheTpmbGV4O2FsaWduLWNvbnRlbnQ6ZmxleC1lbmR9IH0gQG1lZGlhIG9ubHkgc2NyZWVuIGFuZCAobWF4LXdpZHRoOiA1OTlweCkgeyAudGItZ3JpZCwudGItZ3JpZD4uYmxvY2stZWRpdG9yLWlubmVyLWJsb2Nrcz4uYmxvY2stZWRpdG9yLWJsb2NrLWxpc3RfX2xheW91dHtkaXNwbGF5OmdyaWQ7Z3JpZC1yb3ctZ2FwOjI1cHg7Z3JpZC1jb2x1bW4tZ2FwOjI1cHh9LnRiLWdyaWQtaXRlbXtiYWNrZ3JvdW5kOiNkMzhhMDM7cGFkZGluZzozMHB4fS50Yi1ncmlkLWNvbHVtbntmbGV4LXdyYXA6d3JhcH0udGItZ3JpZC1jb2x1bW4+Knt3aWR0aDoxMDAlfS50Yi1ncmlkLWNvbHVtbi50Yi1ncmlkLWFsaWduLXRvcHt3aWR0aDoxMDAlO2Rpc3BsYXk6ZmxleDthbGlnbi1jb250ZW50OmZsZXgtc3RhcnR9LnRiLWdyaWQtY29sdW1uLnRiLWdyaWQtYWxpZ24tY2VudGVye3dpZHRoOjEwMCU7ZGlzcGxheTpmbGV4O2FsaWduLWNvbnRlbnQ6Y2VudGVyfS50Yi1ncmlkLWNvbHVtbi50Yi1ncmlkLWFsaWduLWJvdHRvbXt3aWR0aDoxMDAlO2Rpc3BsYXk6ZmxleDthbGlnbi1jb250ZW50OmZsZXgtZW5kfSB9IA==

For more detailed instructions, navigate to the current working version of AudiAnnotate at https://hipstas.github.io/AudiAnnotate/.

Step 1

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

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

Select “New Project,” and add a title, description, and slug for your project.

Step 2

Add your audiovisual item.

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

Create your annotations.

You can use spreadsheet programs like Excel or Google sheets that export .tsv, .csv, or .xlsx files to create and organize annotations for AudiAnnotate.

Begin by creating a blank spreadsheet or use this template.

The first column should contain the beginning time (in HR:MIN:SEC format) of the annotations.
The second column should contain the end time (in HR:MIN:SEC format) of the annotation if necessary*.
The third column should contain the contents of your annotation.
The fourth column should contain the name of the layer. The layer column is where you can differentiate types of annotations.
The fifth column should contain the name of the index term. The index column is where you can reference annotations across items.

Once you have completed your annotations, download or save the particular tab of your spreadsheet you filled as either a .tsv, .csv, or .xlsx.

Step 4

Add your annotations to AudiAnnotate.

Select the title of the appropriate audiovisual file
Under “Add Annotations”, select “Choose file” and find your annotation file
Configure your file so the application knows how to read each column

Step 5

Customize your AudiAnnotate project.

Customizing a Project Landing Page | Customizing an Item Page | Creating a Page

AudiAnnotate projects are presented minimally by default. However, users can add contextual information (text, photos, links, etc.) to any project page through GitHub. To do so, you will need to have basic knowledge of either HTML or markdown. Learn more about HTML through this free tutorial or markdown in this free guide.

Step 6

Share your AudiAnnotate project with the world.

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