(logo)
(navigation image)
Home Donate | Forums | FAQs | Contributions | Terms, Privacy, & Copyright | Contact | Jobs | Bios

Search: Advanced Search

UploadAnonymous User (login or join us) 

Advanced Use of the Contribution Engine

The Internet Archive Contribution Engine supports some advanced functionality to enable high volume contributors to more easily (and less interactively) upload and import content into the Archive. The advanced functionality consists of several parts:

  1. Uploading files into a directory for an item via FTP using your username and password
  2. Each item to be imported must have an XML file describing the item and an XML file describing the item files
  3. Calling a URL telling the contribution engine that you are done uploading a specific directory. Results are returned in XML for easy parsing.

In the following sections, the XML formats will be discussed and examples will be given.

Preparing the item metadata

First of all, every item in the Archive must have a unique identifier. This identifier is used to locate the item on our servers and provide the content to the users. When you upload a directory, the name of the directory is the unique identifier used. Identifiers can only contain letters, numbers, underscores, dashes, and dots (nothing else!)

For the sake of clarity, we will use an example of a movie called "My Home Movie". Assume the movie is one file named MyHomeMovie.mpeg, is encoded in the MPEG2 format, has a running time of 2:30, and was directed by "Joe Producer". The unique identifier is MyHomeMovie.

In order to avoid manual intervention with the website, you will need to specify all of the above information using two XML files. The files must be named IDENTIFIER_meta.xml and IDENTIFIER_files.xml where IDENTIFIER is the unique identifier (in our example these files would be called MyHomeMovie_files.xml and MyHomeMovies_meta.xml).

The item metadata file (MyHomeMovies_meta.xml) would look like this:

<metadata>
  <collection>opensource_movies</collection>
  <mediatype>movies</mediatype>
  <title>My Home Movie</title>
  <runtime>2:30</runtime>
  <director>Joe Producer</director>
</metadata>    

All items must have the collection, mediatype, and title field supplied. You can include whatever other fields you like. Some fields will be displayed on the website. For movies these include: date, producer, production_company, director, contact, sponsor, description, runtime, color, sound, shotlist, segments, credits, and country. For audio these include: creator, description, taper, source, runtime, date, and notes. Any other fields will be kept in the XML file and will, in the future, be shown on the website. For a good example check this metadata file.

You can also select a Creative Commons license for your item by adding a field called licenseurl to your metadata file. Choose the URL from the list below, based on the type of license you want:

http://creativecommons.org/licenses/publicdomain/%2location
Atribuição-Uso Não-Comercial 2.5 Brasilhttp://creativecommons.org/licenses/by-nc/2.5/br/
Attributionhttp://creativecommons.org/licenses/by/2.5/
Attribution 1.0 Finlandhttp://creativecommons.org/licenses/by/1.0/fi/
Attribution 2.0 Austriahttp://creativecommons.org/licenses/by/2.0/at/
Attribution 2.0 Belgiumhttp://creativecommons.org/licenses/by/2.0/be/
Attribution 2.0 Chilehttp://creativecommons.org/licenses/by/2.0/cl/
Attribution 2.0 England & Waleshttp://creativecommons.org/licenses/by/2.0/uk/
Attribution 2.0 Francehttp://creativecommons.org/licenses/by/2.0/fr/
Attribution 2.0 Germanyhttp://creativecommons.org/licenses/by/2.0/de/
Attribution 2.0 Italyhttp://creativecommons.org/licenses/by/2.0/it/
Attribution 2.0 Koreahttp://creativecommons.org/licenses/by/2.0/kr/
Attribution 2.0 Taiwanhttp://creativecommons.org/licenses/by/2.0/tw/
Attribution 2.1 Japanhttp://creativecommons.org/licenses/by/2.1/jp/
Attribution 2.5 Argentinahttp://creativecommons.org/licenses/by/2.5/ar/
Attribution 2.5 Australiahttp://creativecommons.org/licenses/by/2.5/au/
Attribution 2.5 Brazilhttp://creativecommons.org/licenses/by/2.5/br/
Attribution 2.5 Canadahttp://creativecommons.org/licenses/by/2.5/ca/
Attribution 2.5 China Mainlandhttp://creativecommons.org/licenses/by/2.5/cn/
Attribution 2.5 Colombiahttp://creativecommons.org/licenses/by/2.5/co/
Attribution 2.5 Croatiahttp://creativecommons.org/licenses/by/2.5/hr/
Attribution 2.5 Denmarkhttp://creativecommons.org/licenses/by/2.5/dk/
Attribution 2.5 Hungaryhttp://creativecommons.org/licenses/by/2.5/hu/
Attribution 2.5 Indiahttp://creativecommons.org/licenses/by/2.5/in/
Attribution 2.5 Israelhttp://creativecommons.org/licenses/by/2.5/il/
Attribution 2.5 Italyhttp://creativecommons.org/licenses/by/2.5/it/
Attribution 2.5 Macedoniahttp://creativecommons.org/licenses/by/2.5/mk/
Attribution 2.5 Malaysiahttp://creativecommons.org/licenses/by/2.5/my/
Attribution 2.5 Maltahttp://creativecommons.org/licenses/by/2.5/mt/
Attribution 2.5 Mexicohttp://creativecommons.org/licenses/by/2.5/mx/
Attribution 2.5 Netherlandshttp://creativecommons.org/licenses/by/2.5/nl/
Attribution 2.5 Peruhttp://creativecommons.org/licenses/by/2.5/pe/
Attribution 2.5 Portugalhttp://creativecommons.org/licenses/by/2.5/pt/
Attribution 2.5 Sloveniahttp://creativecommons.org/licenses/by/2.5/si/
Attribution 2.5 South Africahttp://creativecommons.org/licenses/by/2.5/za/
Attribution 2.5 Spainhttp://creativecommons.org/licenses/by/2.5/es/
Attribution 2.5 Swedenhttp://creativecommons.org/licenses/by/2.5/se/
Attribution 2.5 Switzerlandhttp://creativecommons.org/licenses/by/2.5/ch/
Attribution 2.5 UK: Scotlandhttp://creativecommons.org/licenses/by/2.5/scotland/
Attribution 3.0http://creativecommons.org/licenses/by/3.0/
Attribution 3.0 Croatiahttp://creativecommons.org/licenses/by/3.0/hr/
Attribution 3.0 Germanyhttp://creativecommons.org/licenses/by/3.0/de/
Attribution 3.0 Greecehttp://creativecommons.org/licenses/by/3.0/gr/
Attribution 3.0 Luxembourghttp://creativecommons.org/licenses/by/3.0/lu/
Attribution 3.0 Netherlandshttp://creativecommons.org/licenses/by/3.0/nl/
Attribution 3.0 New Zealandhttp://creativecommons.org/licenses/by/3.0/nz/
Attribution 3.0 Philippineshttp://creativecommons.org/licenses/by/3.0/ph/
Attribution 3.0 Puerto Ricohttp://creativecommons.org/licenses/by/3.0/pr/
Attribution 3.0 Serbiahttp://creativecommons.org/licenses/by/3.0/rs/
Attribution 3.0 United Stateshttp://creativecommons.org/licenses/by/3.0/us/
Attribution-No Derivative Works 2.0 Chilehttp://creativecommons.org/licenses/by-nd/2.0/cl/
Attribution-No Derivative Works 2.0 Koreahttp://creativecommons.org/licenses/by-nd/2.0/kr/
Attribution-No Derivative Works 2.1 Japanhttp://creativecommons.org/licenses/by-nd/2.1/jp/
Attribution-No Derivative Works 2.5 Argentinahttp://creativecommons.org/licenses/by-nd/2.5/ar/
Attribution-No Derivative Works 2.5 Australiahttp://creativecommons.org/licenses/by-nd/2.5/au/
Attribution-No Derivative Works 2.5 Bulgariahttp://creativecommons.org/licenses/by-nd/2.5/bg/
Attribution-No Derivative Works 2.5 Canadahttp://creativecommons.org/licenses/by-nd/2.5/ca/
Attribution-No Derivative Works 2.5 Colombiahttp://creativecommons.org/licenses/by-nd/2.5/co/
Attribution-No Derivative Works 2.5 Croatiahttp://creativecommons.org/licenses/by-nd/2.5/hr/
Attribution-No Derivative Works 2.5 Denmarkhttp://creativecommons.org/licenses/by-nd/2.5/dk/
Attribution-No Derivative Works 2.5 Indiahttp://creativecommons.org/licenses/by-nd/2.5/in/
Attribution-No Derivative Works 2.5 Malaysiahttp://creativecommons.org/licenses/by-nd/2.5/my/
Attribution-No Derivative Works 2.5 Mexicohttp://creativecommons.org/licenses/by-nd/2.5/mx/
Attribution-No Derivative Works 2.5 Peruhttp://creativecommons.org/licenses/by-nd/2.5/pe/
Attribution-No Derivative Works 2.5 Polandhttp://creativecommons.org/licenses/by-nd/2.5/pl/
Attribution-No Derivative Works 2.5 Portugalhttp://creativecommons.org/licenses/by-nd/2.5/pt/
Attribution-No Derivative Works 2.5 Sloveniahttp://creativecommons.org/licenses/by-nd/2.5/si/
Attribution-No Derivative Works 2.5 South Africahttp://creativecommons.org/licenses/by-nd/2.5/za/
Attribution-No Derivative Works 2.5 Swedenhttp://creativecommons.org/licenses/by-nd/2.5/se/
Attribution-No Derivative Works 2.5 Switzerlandhttp://creativecommons.org/licenses/by-nd/2.5/ch/
Attribution-No Derivative Works 2.5 UK: Scotlandhttp://creativecommons.org/licenses/by-nd/2.5/scotland/
Attribution-No Derivative Works 3.0 http://creativecommons.org/licenses/by-nd/3.0/
Attribution-No Derivative Works 3.0 Croatiahttp://creativecommons.org/licenses/by-nd/3.0/hr/
Attribution-No Derivative Works 3.0 Ecuadorhttp://creativecommons.org/licenses/by-nd/3.0/ec/
Attribution-No Derivative Works 3.0 Germanyhttp://creativecommons.org/licenses/by-nd/3.0/de/
Attribution-No Derivative Works 3.0 Greecehttp://creativecommons.org/licenses/by-nd/3.0/gr/
Attribution-No Derivative Works 3.0 Netherlandshttp://creativecommons.org/licenses/by-nd/3.0/nl/
Attribution-No Derivative Works 3.0 Philippineshttp://creativecommons.org/licenses/by-nd/3.0/ph/
Attribution-No Derivative Works 3.0 Puerto Ricohttp://creativecommons.org/licenses/by-nd/3.0/pr/
Attribution-No Derivative Works 3.0 Serbiahttp://creativecommons.org/licenses/by-nd/3.0/rs/
Attribution-No Derivative Works 3.0 United Stateshttp://creativecommons.org/licenses/by-nd/3.0/us/
Attribution-NoDerivshttp://creativecommons.org/licenses/by-nd/2.5/
Attribution-NoDerivs 2.0 Austriahttp://creativecommons.org/licenses/by-nd/2.0/at/
Attribution-NoDerivs 2.0 Belgiumhttp://creativecommons.org/licenses/by-nd/2.0/be/
Attribution-NoDerivs 2.0 England & Waleshttp://creativecommons.org/licenses/by-nd/2.0/uk/
Attribution-NoDerivs 2.0 Francehttp://creativecommons.org/licenses/by-nd/2.0/fr/
Attribution-NoDerivs 2.0 Germanyhttp://creativecommons.org/licenses/by-nd/2.0/de/
Attribution-NoDerivs 2.0 Italyhttp://creativecommons.org/licenses/by-nd/2.0/it/
Attribution-NoDerivs 2.5 Brazilhttp://creativecommons.org/licenses/by-nd/2.5/br/
Attribution-NoDerivs 2.5 Netherlandshttp://creativecommons.org/licenses/by-nd/2.5/nl/
Attribution-NoDerivs 2.5 Spainhttp://creativecommons.org/licenses/by-nd/2.5/es/
Attribution-NoDerivs-NonCommercialhttp://creativecommons.org/licenses/by-nd-nc/1.0/
Attribution-NonCommercialhttp://creativecommons.org/licenses/by-nc/2.5/
Attribution-NonCommercial 2.0 Francehttp://creativecommons.org/licenses/by-nc/2.0/fr/
Attribution-NonCommercial 2.0 Germanyhttp://creativecommons.org/licenses/by-nc/2.0/de/
Attribution-NonCommercial 2.0 Italyhttp://creativecommons.org/licenses/by-nc/2.0/it/
Attribution-NonCommercial 2.0 UK: England & Waleshttp://creativecommons.org/licenses/by-nc/2.0/uk/
Attribution-NonCommercial 2.1 Australiahttp://creativecommons.org/licenses/by-nc/2.1/au/
Attribution-NonCommercial 2.5 http://creativecommons.org/licenses/by-nc/2.5/ch/
Attribution-NonCommercial 2.5 Canadahttp://creativecommons.org/licenses/by-nc/2.5/ca/
Attribution-NonCommercial 2.5 Netherlandshttp://creativecommons.org/licenses/by-nc/2.5/nl/
Attribution-NonCommercial 2.5 Spainhttp://creativecommons.org/licenses/by-nc/2.5/es/
Attribution-NonCommercial-NoDerivshttp://creativecommons.org/licenses/by-nc-nd/2.5/
Attribution-NonCommercial-NoDerivs 2.0 Austriahttp://creativecommons.org/licenses/by-nc-nd/2.0/at/
Attribution-NonCommercial-NoDerivs 2.0 Belgiumhttp://creativecommons.org/licenses/by-nc-nd/2.0/be/
Attribution-NonCommercial-NoDerivs 2.0 Chilehttp://creativecommons.org/licenses/by-nc-nd/2.0/cl/
Attribution-NonCommercial-NoDerivs 2.0 England & Waleshttp://creativecommons.org/licenses/by-nc-nd/2.0/uk/
Attribution-NonCommercial-NoDerivs 2.0 Francehttp://creativecommons.org/licenses/by-nc-nd/2.0/fr/
Attribution-NonCommercial-NoDerivs 2.0 Germanyhttp://creativecommons.org/licenses/by-nc-nd/2.0/de/
Attribution-NonCommercial-NoDerivs 2.0 Italyhttp://creativecommons.org/licenses/by-nc-nd/2.0/it/
Attribution-NonCommercial-NoDerivs 2.0 South Koreahttp://creativecommons.org/licenses/by-nc-nd/2.0/kr/
Attribution-NonCommercial-NoDerivs 2.1 Australiahttp://creativecommons.org/licenses/by-nc-nd/2.1/au/
Attribution-NonCommercial-NoDerivs 2.1 Japanhttp://creativecommons.org/licenses/by-nc-nd/2.1/jp/
Attribution-NonCommercial-NoDerivs 2.5 Brazilhttp://creativecommons.org/licenses/by-nc-nd/2.5/br/
Attribution-NonCommercial-NoDerivs 2.5 Canadahttp://creativecommons.org/licenses/by-nc-nd/2.5/ca/
Attribution-NonCommercial-NoDerivs 2.5 Croatiahttp://creativecommons.org/licenses/by-nc-nd/2.5/hr/
Attribution-NonCommercial-NoDerivs 2.5 Italyhttp://creativecommons.org/licenses/by-nc-nd/2.5/it/
Attribution-NonCommercial-NoDerivs 2.5 Netherlandshttp://creativecommons.org/licenses/by-nc-nd/2.5/nl/
Attribution-NonCommercial-NoDerivs 2.5 Spainhttp://creativecommons.org/licenses/by-nc-nd/2.5/es/
Attribution-NonCommercial-ShareAlikehttp://creativecommons.org/licenses/by-nc-sa/2.5/
Attribution-NonCommercial-ShareAlike 2.0 Belgiumhttp://creativecommons.org/licenses/by-nc-sa/2.0/be/
Attribution-NonCommercial-ShareAlike 2.0 Chilehttp://creativecommons.org/licenses/by-nc-sa/2.0/cl/
Attribution-NonCommercial-ShareAlike 2.0 England & Waleshttp://creativecommons.org/licenses/by-nc-sa/2.0/uk/
Attribution-NonCommercial-ShareAlike 2.0 Francehttp://creativecommons.org/licenses/by-nc-sa/2.0/fr/
Attribution-NonCommercial-ShareAlike 2.0 Germanyhttp://creativecommons.org/licenses/by-nc-sa/2.0/de/
Attribution-NonCommercial-ShareAlike 2.0 Italyhttp://creativecommons.org/licenses/by-nc-sa/2.0/it/
Attribution-NonCommercial-ShareAlike 2.1 Australiahttp://creativecommons.org/licenses/by-nc-sa/2.1/au/
Attribution-NonCommercial-ShareAlike 2.1 Japanhttp://creativecommons.org/licenses/by-nc-sa/2.1/jp/
Attribution-NonCommercial-ShareAlike 2.5 http://creativecommons.org/licenses/by-nc-sa/2.5/ch/
Attribution-NonCommercial-ShareAlike 2.5 Brazilhttp://creativecommons.org/licenses/by-nc-sa/2.5/br/
Attribution-NonCommercial-ShareAlike 2.5 Netherlandshttp://creativecommons.org/licenses/by-nc-sa/2.5/nl/
Attribution-NonCommercial-ShareAlike 2.5 Spainhttp://creativecommons.org/licenses/by-nc-sa/2.5/es/
Attribution-Noncommercial 1.0 Finlandhttp://creativecommons.org/licenses/by-nc/1.0/fi/
Attribution-Noncommercial 2.0 Austriahttp://creativecommons.org/licenses/by-nc/2.0/at/
Attribution-Noncommercial 2.0 Belgiumhttp://creativecommons.org/licenses/by-nc/2.0/be/
Attribution-Noncommercial 2.0 Chilehttp://creativecommons.org/licenses/by-nc/2.0/cl/
Attribution-Noncommercial 2.0 Koreahttp://creativecommons.org/licenses/by-nc/2.0/kr/
Attribution-Noncommercial 2.1 Japanhttp://creativecommons.org/licenses/by-nc/2.1/jp/
Attribution-Noncommercial 2.5 Argentinahttp://creativecommons.org/licenses/by-nc/2.5/ar/
Attribution-Noncommercial 2.5 Australiahttp://creativecommons.org/licenses/by-nc/2.5/au/
Attribution-Noncommercial 2.5 Bulgariahttp://creativecommons.org/licenses/by-nc/2.5/bg/
Attribution-Noncommercial 2.5 China Mainlandhttp://creativecommons.org/licenses/by-nc/2.5/cn/
Attribution-Noncommercial 2.5 Colombiahttp://creativecommons.org/licenses/by-nc/2.5/co/
Attribution-Noncommercial 2.5 Croatiahttp://creativecommons.org/licenses/by-nc/2.5/hr/
Attribution-Noncommercial 2.5 Hungaryhttp://creativecommons.org/licenses/by-nc/2.5/hu/
Attribution-Noncommercial 2.5 Indiahttp://creativecommons.org/licenses/by-nc/2.5/in/
Attribution-Noncommercial 2.5 Macedoniahttp://creativecommons.org/licenses/by-nc/2.5/mk/
Attribution-Noncommercial 2.5 Malaysiahttp://creativecommons.org/licenses/by-nc/2.5/my/
Attribution-Noncommercial 2.5 Mexicohttp://creativecommons.org/licenses/by-nc/2.5/mx/
Attribution-Noncommercial 2.5 Peruhttp://creativecommons.org/licenses/by-nc/2.5/pe/
Attribution-Noncommercial 2.5 Polandhttp://creativecommons.org/licenses/by-nc/2.5/pl/
Attribution-Noncommercial 2.5 Portugalhttp://creativecommons.org/licenses/by-nc/2.5/pt/
Attribution-Noncommercial 2.5 Sloveniahttp://creativecommons.org/licenses/by-nc/2.5/si/
Attribution-Noncommercial 2.5 South Africahttp://creativecommons.org/licenses/by-nc/2.5/za/
Attribution-Noncommercial 2.5 Swedenhttp://creativecommons.org/licenses/by-nc/2.5/se/
Attribution-Noncommercial 2.5 Taiwanhttp://creativecommons.org/licenses/by-nc/2.5/tw/
Attribution-Noncommercial 2.5 UK: Scotlandhttp://creativecommons.org/licenses/by-nc/2.5/scotland/
Attribution-Noncommercial 3.0http://creativecommons.org/licenses/by-nc/3.0/
Attribution-Noncommercial 3.0 Germanyhttp://creativecommons.org/licenses/by-nc/3.0/de/
Attribution-Noncommercial 3.0 Greecehttp://creativecommons.org/licenses/by-nc/3.0/gr/
Attribution-Noncommercial 3.0 Netherlandshttp://creativecommons.org/licenses/by-nc/3.0/nl/
Attribution-Noncommercial 3.0 New Zealandhttp://creativecommons.org/licenses/by-nc/3.0/nz/
Attribution-Noncommercial 3.0 Philippineshttp://creativecommons.org/licenses/by-nc/3.0/ph/
Attribution-Noncommercial 3.0 Puerto Ricohttp://creativecommons.org/licenses/by-nc/3.0/pr/
Attribution-Noncommercial 3.0 United Stateshttp://creativecommons.org/licenses/by-nc/3.0/us/
Attribution-Noncommercial-No Derivative Works 1.0 Finlandhttp://creativecommons.org/licenses/by-nd-nc/1.0/fi/
Attribution-Noncommercial-No Derivative Works 2.5 Argentinahttp://creativecommons.org/licenses/by-nc-nd/2.5/ar/
Attribution-Noncommercial-No Derivative Works 2.5 Australiahttp://creativecommons.org/licenses/by-nc-nd/2.5/au/
Attribution-Noncommercial-No Derivative Works 2.5 China Mainlandhttp://creativecommons.org/licenses/by-nc-nd/2.5/cn/
Attribution-Noncommercial-No Derivative Works 2.5 Colombiahttp://creativecommons.org/licenses/by-nc-nd/2.5/co/
Attribution-Noncommercial-No Derivative Works 2.5 Denmarkhttp://creativecommons.org/licenses/by-nc-nd/2.5/dk/
Attribution-Noncommercial-No Derivative Works 2.5 Hungaryhttp://creativecommons.org/licenses/by-nc-nd/2.5/hu/
Attribution-Noncommercial-No Derivative Works 2.5 Indiahttp://creativecommons.org/licenses/by-nc-nd/2.5/in/
Attribution-Noncommercial-No Derivative Works 2.5 Israelhttp://creativecommons.org/licenses/by-nc-nd/2.5/il/
Attribution-Noncommercial-No Derivative Works 2.5 Macedoniahttp://creativecommons.org/licenses/by-nc-nd/2.5/mk/
Attribution-Noncommercial-No Derivative Works 2.5 Malaysiahttp://creativecommons.org/licenses/by-nc-nd/2.5/my/
Attribution-Noncommercial-No Derivative Works 2.5 Maltahttp://creativecommons.org/licenses/by-nc-nd/2.5/mt/
Attribution-Noncommercial-No Derivative Works 2.5 Mexicohttp://creativecommons.org/licenses/by-nc-nd/2.5/mx/
Attribution-Noncommercial-No Derivative Works 2.5 Peruhttp://creativecommons.org/licenses/by-nc-nd/2.5/pe/
Attribution-Noncommercial-No Derivative Works 2.5 Portugalhttp://creativecommons.org/licenses/by-nc-nd/2.5/pt/
Attribution-Noncommercial-No Derivative Works 2.5 Sloveniahttp://creativecommons.org/licenses/by-nc-nd/2.5/si/
Attribution-Noncommercial-No Derivative Works 2.5 South Africahttp://creativecommons.org/licenses/by-nc-nd/2.5/za/
Attribution-Noncommercial-No Derivative Works 2.5 Swedenhttp://creativecommons.org/licenses/by-nc-nd/2.5/se/
Attribution-Noncommercial-No Derivative Works 2.5 Switzerlandhttp://creativecommons.org/licenses/by-nc-nd/2.5/ch/
Attribution-Noncommercial-No Derivative Works 2.5 Taiwanhttp://creativecommons.org/licenses/by-nc-nd/2.5/tw/
Attribution-Noncommercial-No Derivative Works 2.5 UK: Scotlandhttp://creativecommons.org/licenses/by-nc-nd/2.5/scotland/
Attribution-Noncommercial-No Derivative Works 3.0http://creativecommons.org/licenses/by-nc-nd/3.0/
Attribution-Noncommercial-No Derivative Works 3.0 Austriahttp://creativecommons.org/licenses/by-nc-nd/3.0/at/
Attribution-Noncommercial-No Derivative Works 3.0 Croatiahttp://creativecommons.org/licenses/by-nc-nd/3.0/hr/
Attribution-Noncommercial-No Derivative Works 3.0 Ecuadorhttp://creativecommons.org/licenses/by-nc-nd/3.0/ec/
Attribution-Noncommercial-No Derivative Works 3.0 Germanyhttp://creativecommons.org/licenses/by-nc-nd/3.0/de/
Attribution-Noncommercial-No Derivative Works 3.0 Greecehttp://creativecommons.org/licenses/by-nc-nd/3.0/gr/
Attribution-Noncommercial-No Derivative Works 3.0 Luxembourghttp://creativecommons.org/licenses/by-nc-nd/3.0/lu/
Attribution-Noncommercial-No Derivative Works 3.0 Netherlandshttp://creativecommons.org/licenses/by-nc-nd/3.0/nl/
Attribution-Noncommercial-No Derivative Works 3.0 New Zealandhttp://creativecommons.org/licenses/by-nc-nd/3.0/nz/
Attribution-Noncommercial-No Derivative Works 3.0 Norwayhttp://creativecommons.org/licenses/by-nc-nd/3.0/no/
Attribution-Noncommercial-No Derivative Works 3.0 Philippineshttp://creativecommons.org/licenses/by-nc-nd/3.0/ph/
Attribution-Noncommercial-No Derivative Works 3.0 Puerto Ricohttp://creativecommons.org/licenses/by-nc-nd/3.0/pr/
Attribution-Noncommercial-No Derivative Works 3.0 Serbiahttp://creativecommons.org/licenses/by-nc-nd/3.0/rs/
Attribution-Noncommercial-No Derivative Works 3.0 United Stateshttp://creativecommons.org/licenses/by-nc-nd/3.0/us/
Attribution-Noncommercial-Share Alike 1.0 Finlandhttp://creativecommons.org/licenses/by-nc-sa/1.0/fi/
Attribution-Noncommercial-Share Alike 2.0 Austriahttp://creativecommons.org/licenses/by-nc-sa/2.0/at/
Attribution-Noncommercial-Share Alike 2.0 Koreahttp://creativecommons.org/licenses/by-nc-sa/2.0/kr/
Attribution-Noncommercial-Share Alike 2.5 Argentinahttp://creativecommons.org/licenses/by-nc-sa/2.5/ar/
Attribution-Noncommercial-Share Alike 2.5 Australiahttp://creativecommons.org/licenses/by-nc-sa/2.5/au/
Attribution-Noncommercial-Share Alike 2.5 Bulgariahttp://creativecommons.org/licenses/by-nc-sa/2.5/bg/
Attribution-Noncommercial-Share Alike 2.5 Canadahttp://creativecommons.org/licenses/by-nc-sa/2.5/ca/
Attribution-Noncommercial-Share Alike 2.5 China Mainlandhttp://creativecommons.org/licenses/by-nc-sa/2.5/cn/
Attribution-Noncommercial-Share Alike 2.5 Colombiahttp://creativecommons.org/licenses/by-nc-sa/2.5/co/
Attribution-Noncommercial-Share Alike 2.5 Croatiahttp://creativecommons.org/licenses/by-nc-sa/2.5/hr/
Attribution-Noncommercial-Share Alike 2.5 Denmarkhttp://creativecommons.org/licenses/by-nc-sa/2.5/dk/
Attribution-Noncommercial-Share Alike 2.5 Hungaryhttp://creativecommons.org/licenses/by-nc-sa/2.5/hu/
Attribution-Noncommercial-Share Alike 2.5 Indiahttp://creativecommons.org/licenses/by-nc-sa/2.5/in/
Attribution-Noncommercial-Share Alike 2.5 Israelhttp://creativecommons.org/licenses/by-nc-sa/2.5/il/
Attribution-Noncommercial-Share Alike 2.5 Italyhttp://creativecommons.org/licenses/by-nc-sa/2.5/it/
Attribution-Noncommercial-Share Alike 2.5 Macedoniahttp://creativecommons.org/licenses/by-nc-sa/2.5/mk/
Attribution-Noncommercial-Share Alike 2.5 Malaysiahttp://creativecommons.org/licenses/by-nc-sa/2.5/my/
Attribution-Noncommercial-Share Alike 2.5 Maltahttp://creativecommons.org/licenses/by-nc-sa/2.5/mt/
Attribution-Noncommercial-Share Alike 2.5 Mexicohttp://creativecommons.org/licenses/by-nc-sa/2.5/mx/
Attribution-Noncommercial-Share Alike 2.5 Peruhttp://creativecommons.org/licenses/by-nc-sa/2.5/pe/
Attribution-Noncommercial-Share Alike 2.5 Portugalhttp://creativecommons.org/licenses/by-nc-sa/2.5/pt/
Attribution-Noncommercial-Share Alike 2.5 Sloveniahttp://creativecommons.org/licenses/by-nc-sa/2.5/si/
Attribution-Noncommercial-Share Alike 2.5 South Africahttp://creativecommons.org/licenses/by-nc-sa/2.5/za/
Attribution-Noncommercial-Share Alike 2.5 Swedenhttp://creativecommons.org/licenses/by-nc-sa/2.5/se/
Attribution-Noncommercial-Share Alike 2.5 Taiwanhttp://creativecommons.org/licenses/by-nc-sa/2.5/tw/
Attribution-Noncommercial-Share Alike 2.5 UK: Scotlandhttp://creativecommons.org/licenses/by-nc-sa/2.5/scotland/
Attribution-Noncommercial-Share Alike 3.0http://creativecommons.org/licenses/by-nc-sa/3.0/
Attribution-Noncommercial-Share Alike 3.0 Ecuadorhttp://creativecommons.org/licenses/by-nc-sa/3.0/ec/
Attribution-Noncommercial-Share Alike 3.0 Germanyhttp://creativecommons.org/licenses/by-nc-sa/3.0/de/
Attribution-Noncommercial-Share Alike 3.0 Greecehttp://creativecommons.org/licenses/by-nc-sa/3.0/gr/
Attribution-Noncommercial-Share Alike 3.0 Luxembourghttp://creativecommons.org/licenses/by-nc-sa/3.0/lu/
Attribution-Noncommercial-Share Alike 3.0 Netherlandshttp://creativecommons.org/licenses/by-nc-sa/3.0/nl/
Attribution-Noncommercial-Share Alike 3.0 New Zealandhttp://creativecommons.org/licenses/by-nc-sa/3.0/nz/
Attribution-Noncommercial-Share Alike 3.0 Norwayhttp://creativecommons.org/licenses/by-nc-sa/3.0/no/
Attribution-Noncommercial-Share Alike 3.0 Philippineshttp://creativecommons.org/licenses/by-nc-sa/3.0/ph/
Attribution-Noncommercial-Share Alike 3.0 Puerto Ricohttp://creativecommons.org/licenses/by-nc-sa/3.0/pr/
Attribution-Noncommercial-Share Alike 3.0 Serbiahttp://creativecommons.org/licenses/by-nc-sa/3.0/rs/
Attribution-Noncommercial-Share Alike 3.0 United Stateshttp://creativecommons.org/licenses/by-nc-sa/3.0/us/
Attribution-Share Alike 2.0 Austriahttp://creativecommons.org/licenses/by-sa/2.0/at/
Attribution-Share Alike 2.0 Belgiumhttp://creativecommons.org/licenses/by-sa/2.0/be/
Attribution-Share Alike 2.1 Japanhttp://creativecommons.org/licenses/by-sa/2.1/jp/
Attribution-Share Alike 2.5 Argentinahttp://creativecommons.org/licenses/by-sa/2.5/ar/
Attribution-Share Alike 2.5 Australiahttp://creativecommons.org/licenses/by-sa/2.5/au/
Attribution-Share Alike 2.5 Brazilhttp://creativecommons.org/licenses/by-sa/2.5/br/
Attribution-Share Alike 2.5 Canadahttp://creativecommons.org/licenses/by-sa/2.5/ca/
Attribution-Share Alike 2.5 China Mainlandhttp://creativecommons.org/licenses/by-sa/2.5/cn/
Attribution-Share Alike 2.5 Colombiahttp://creativecommons.org/licenses/by-sa/2.5/co/
Attribution-Share Alike 2.5 Croatiahttp://creativecommons.org/licenses/by-sa/2.5/hr/
Attribution-Share Alike 2.5 Denmarkhttp://creativecommons.org/licenses/by-sa/2.5/dk/
Attribution-Share Alike 2.5 Hungaryhttp://creativecommons.org/licenses/by-sa/2.5/hu/
Attribution-Share Alike 2.5 Indiahttp://creativecommons.org/licenses/by-sa/2.5/in/
Attribution-Share Alike 2.5 Israelhttp://creativecommons.org/licenses/by-sa/2.5/il/
Attribution-Share Alike 2.5 Macedoniahttp://creativecommons.org/licenses/by-sa/2.5/mk/
Attribution-Share Alike 2.5 Malaysiahttp://creativecommons.org/licenses/by-sa/2.5/my/
Attribution-Share Alike 2.5 Netherlandshttp://creativecommons.org/licenses/by-sa/2.5/nl/
Attribution-Share Alike 2.5 Peruhttp://creativecommons.org/licenses/by-sa/2.5/pe/
Attribution-Share Alike 2.5 Polandhttp://creativecommons.org/licenses/by-sa/2.5/pl/
Attribution-Share Alike 2.5 Portugalhttp://creativecommons.org/licenses/by-sa/2.5/pt/
Attribution-Share Alike 2.5 Sloveniahttp://creativecommons.org/licenses/by-sa/2.5/si/
Attribution-Share Alike 2.5 South Africahttp://creativecommons.org/licenses/by-sa/2.5/za/
Attribution-Share Alike 2.5 Swedenhttp://creativecommons.org/licenses/by-sa/2.5/se/
Attribution-Share Alike 2.5 Switzerlandhttp://creativecommons.org/licenses/by-sa/2.5/ch/
Attribution-Share Alike 2.5 UK: Scotlandhttp://creativecommons.org/licenses/by-sa/2.5/scotland/
Attribution-Share Alike 3.0http://creativecommons.org/licenses/by-sa/3.0/
Attribution-Share Alike 3.0 Croatiahttp://creativecommons.org/licenses/by-sa/3.0/hr/
Attribution-Share Alike 3.0 Germanyhttp://creativecommons.org/licenses/by-sa/3.0/de/
Attribution-Share Alike 3.0 Greecehttp://creativecommons.org/licenses/by-sa/3.0/gr/
Attribution-Share Alike 3.0 New Zealandhttp://creativecommons.org/licenses/by-sa/3.0/nz/
Attribution-Share Alike 3.0 Philippineshttp://creativecommons.org/licenses/by-sa/3.0/ph/
Attribution-Share Alike 3.0 Puerto Ricohttp://creativecommons.org/licenses/by-sa/3.0/pr/
Attribution-Share Alike 3.0 Serbiahttp://creativecommons.org/licenses/by-sa/3.0/rs/
Attribution-Share Alike 3.0 United Stateshttp://creativecommons.org/licenses/by-sa/3.0/us/
Attribution-ShareAlikehttp://creativecommons.org/licenses/by-sa/2.5/
Attribution-ShareAlike 2.0 Chilehttp://creativecommons.org/licenses/by-sa/2.0/cl/
Attribution-ShareAlike 2.0 England & Waleshttp://creativecommons.org/licenses/by-sa/2.0/uk/
Attribution-ShareAlike 2.0 Francehttp://creativecommons.org/licenses/by-sa/2.0/fr/
Attribution-ShareAlike 2.0 Germanyhttp://creativecommons.org/licenses/by-sa/2.0/de/
Attribution-ShareAlike 2.0 Italyhttp://creativecommons.org/licenses/by-sa/2.0/it/
Attribution-ShareAlike 2.5 http://creativecommons.org/licenses/by-sa/2.5/mx/
Attribution-ShareAlike 2.5 Italyhttp://creativecommons.org/licenses/by-sa/2.5/it/
Attribution-ShareAlike 2.5 Spainhttp://creativecommons.org/licenses/by-sa/2.5/es/
Attribuzione-Non commerciale 2.5 Italiahttp://creativecommons.org/licenses/by-nc/2.5/it/
Attribuzione-Non opere derivate 2.5 Italiahttp://creativecommons.org/licenses/by-nd/2.5/it/
GPL 2.0http://creativecommons.org/licenses/GPL/2.0/
Music Sharing Licensehttp://creativecommons.org/licenses/by-nc-nd/2.0/deed-music
Naamsvermelding-Gelijk delen 3.0 Nederlandhttp://creativecommons.org/licenses/by-sa/3.0/nl/
NoDerivshttp://creativecommons.org/licenses/nd/1.0/
NoDerivs-NonCommercialhttp://creativecommons.org/licenses/nd-nc/1.0/
NonCommercialhttp://creativecommons.org/licenses/nc/1.0/
NonCommercial Sampling Plushttp://creativecommons.org/licenses/nc-sampling+/1.0/
NonCommercial-ShareAlikehttp://creativecommons.org/licenses/nc-sa/1.0/
Public Domainhttp://creativecommons.org/licenses/publicdomain/prelinger/
Public+Domainhttp%3A%2F%2Fcreativecommons.org%2Flicenses%2Fpublicdomain%2F
Sampling 1.0http://creativecommons.org/licenses/sampling/1.0/
Sampling Plushttp://creativecommons.org/licenses/sampling+/1.0/
ShareAlikehttp://creativecommons.org/licenses/sa/1.0/
Uznanie autorstwa 2.5 Polskahttp://creativecommons.org/licenses/by/2.5/pl/
Uznanie autorstwa-Użycie niekomercyjne-Bez utworów zależnych http://creativecommons.org/licenses/by-nc-nd/2.5/pl/
Uznanie autorstwa-Użycie niekomercyjne-Na tych samych warunkachhttp://creativecommons.org/licenses/by-nc-sa/2.5/pl/
Признание-Некомерсиално-Без произhttp://creativecommons.org/licenses/by-nc-nd/2.5/bg/
姓名標示 2.5 台灣http://creativecommons.org/licenses/by/2.5/tw/

So, for example, if you wanted the Public Domain license, you would put this line in your metadata file: <licenseurl>http://creativecommons.org/licenses/publicdomain/<licenseurl>

Preparing the file metadata

Additionally, you need to describe the files you are uploading so the system knows what types of conversions to do, and so that this information can be shown to users on the website. This file for our example would look like (MyHomeMovie_files.xml):

<files>
  <file name="MyHomeMovie.mpeg" source="original">
    <runtime>2:30</runtime>
    <format>MPEG2</format>
  </file>
</files>    

The format name is very important to choose accurately. Upper/lowercase is significant. By picking formats from this list, you will be assured to get the most possible "derivatives" created from the item's files. This list is dynamically generated so check back later for newly acceptable formats. The list of acceptable format names is:

128Kbps MP3
128kbps M3U
160Kbps MP3
192Kbps MP3
24bit Flac
256Kb MPEG4
256Kb QuickTime
256Kbps MP3
320Kbps MP3
3GP
512Kb MPEG4
56Kb QuickTime
64Kb MPEG4
64Kb QuickTime
64Kbps M3U
64Kbps MP3
64Kbps MP3 ZIP
96Kbps MP3
AIFF
ARC
Abbyy GZ
Abbyy ZIP
Animated GIF
Book Cover
Book Cover
Book Cover Image
Checksums
Cinepack
Collection Header
DAT
DV Video
DivX
DjVu
DjVuTXT
Djvu XML
Dublin Core
Flac
Flac FingerPrint
Flash Video
Flippy ZIP
Grayscale LuraTech PDF
HTML
HiRes MPEG4
ISO Image
IV50
Image Container PDF
Item Image
JPEG
MARC
MARC Binary
MARC Source
MPEG1
MPEG2
MPEG4
Metadata
Metadata
Microfilm Original TIFF ZIP
Motion JPEG
Multi Page Original TIFF
Multi Page Processed TIFF
Ogg Theora
Ogg Vorbis
PDF
QuickTime
RAR
Real Media
Scan Factors
Scandata
Scribe Scandata ZIP
Shockwave Flash
Shorten
Single Book Page Text
Single Page FIXME JPEG Tar
Single Page FIXME JPEG ZIP
Single Page Library JP2 Tar
Single Page Library JP2 ZIP
Single Page Library TIFF ZIP
Single Page Original CR2 Tar
Single Page Original JP2 Tar
Single Page Original JP2 ZIP
Single Page Original JPEG
Single Page Original JPEG Tar
Single Page Original JPEG ZIP
Single Page Original TIFF
Single Page Original TIFF ZIP
Single Page Processed JP2 Tar
Single Page Processed JP2 ZIP
Single Page Processed JPEG
Single Page Processed JPEG Tar
Single Page Processed JPEG ZIP
Single Page Processed TIFF
Single Page Processed TIFF ZIP
Single Page Processed TIFF ZIP
Single Page Pure JP2 Tar
Single Page Pure JP2 ZIP
Single Page Raw JP2 Tar
Single Page Raw JP2 ZIP
Single Page Raw JPEG Tar
Single Page Raw JPEG ZIP
Single Page Watermark JP2 Tar
Single Page Watermark JP2 ZIP
Single Page Zipped PDF
Standard LuraTech PDF
Structural Metadata
TAR
TGZiped Text Files
Text
Thumbnail
VBR M3U
VBR MP3
VBR ZIP
WAVE
Windows Media
Windows Media Audio
ZIP
h.264 MPEG4

If you are uploading multiple versions of the same content, the lower quality copies should have source="derivative" instead of source="original" and should also have an <original> tag(s) indicating what file(s) it came from. For a good example check this metadata file.

It is highly recommended that contribute as much metadata as possible about the item and its files.

Uploading the files

One you have created the metadata files, use your FTP client to upload the directory containing the item files and the metadata files. In our example the directory uploaded would look like this:

MyHomeMovie/
MyHomeMovie/MyHomeMovie_files.xml
MyHomeMovie/MyHomeMovie_meta.xml
MyHomeMovie/MyHomeMovie.mpeg

Telling the contribution engine to process the upload

Once you have uploaded the directory the contribution engine needs to be informed to process your contribution. Doing so is simple. Assume our example film was uploaded by user@users.com. A HTTP GET should be issued to:

http://www.archive.org/services/contrib-submit.php?user_email=user@user.com&server=movies-uploads.archive.org&dir=MyHomeMovie

Clearly you would adjust the parameters relevant to your contribution. Calling this URL will return an XML response. If the contribution was successful, it will look like this:

<result type="success">
  <message>Item successfully added</message>
</result>
<url>http://www.archive.org/movies/MyHomeMovie</url>    

Otherwise, if there was a failure, it would look like this:

<result type="error" code="meta_error">
  <message>Your metadata file is missing the collection field</message>
</result>    

If all is successful, the item will be added to the Archive and the URL tag in the returned XML will indicate the URL you can use to get to the details page for the item. Otherwise, the message will indicate what you need to fix.


Terms of Use (10 Mar 2001)