Migrating from Avalon

Warning

This guide should only be followed for testing and local development.

This does not describe how to actually migrate something from Avalon.

If you want to import a collection on Avalon into Archipelago, first you must download the collection and its metadata using pyavalon.

Here is a guide on downloading entire collections from Avalon.

Preparing the csv for migration

Linking to Avalon

To link between your Archipelago object and the original Avalon object, you will use the website_url column. You can acquire the Avalon urls for each digital object by using the CONCAT function. For example:

=CONCAT("https://avalon.library.tamu.edu/media_objects/",[cell containing the work id of the item]")

How to upload these files?

Because these values are being downloaded to your device, you will use a zip file to upload. Remember that zip files have a maximum size of 512MB, so you will likely need to split your migration into batches.

Note

AudioObject must be a mp3. If you upload mp4s, Archipelago thinks you have a video, even though you set the type as AudioObject. Your “video” won’t show up in the audio player, but it appears under the Download dropdown menu. If you change the object type to VideoObject, the file will show up in the video player, but it will not be in sync with the transcript.

Adding Transcripts/Captions

You can add transcripts and captions to an item by using the “transcripts” and “captions” columns on the template.