Skip to content
Media downloader for a museum's media files on museum-digital
Python
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
screenshots
.gitignore
LICENSE.AGPL
README.md
README.pdf
mediaBackupMD.py
settings.xml.sample

README.md

Downloader for object resources and images on museum-digital

Purpose

This script serves to back up all images and resources for a given museum from museum-digital.

Setup

This script works best with an own, dedicated user account. In this section, the creation of a new user account with the necessary permissions (and only those), the creation of an authentication token and the setup for this script will be explained.

Creating an own user for backups

Create a new user account. Select "specifically determined" as the user role.

Creating a new user (role: specifically determined)

This user role sets all permissions to "disabled" by default. As this user only needs access to images / resources and should never have access to anything else, allowing viewing resources.

Set the permission for resources of objects to viewing.

This script logs in using authentication tokens. Generate one for the user. Click on user in the navigation to access the list of users. Then click on "Auth Token" in the rightmost column. Click confirm, and copy the generated token to some safe place.

Click on Auth Token in the last column. Copy the token.

Write the settings file

Copy or rename the sample for the settings file to settings.xml. It must remain located in the same folder as the program. Then, open the settings file and insert the auth token you generated in the previous step and the correct URL for your museum. A correct settings.xml may look as follows:

<xml>
  <authtoken>1eee9fe290359a34f224712debed9d83898b5436cebf3cfcc0cf4266a97b</authtoken>
  <url>https://www.museum-digital.de/sandkasten/musdb/lists.php?musid=1</url>
</xml>

Running the script

To run the script, double-click on it. It will fetch an index of all the available resources including the last time they were updated. This index is then compared to a local index of already downloaded files so that files will not be downloaded twice. If the file was not included in the local index, it is downloaded and marked as such in the local index. All downloaded files will be located in a subdirectory (files) of the directory the script is located in.

Note that the script waits 3 seconds after downloading a file, to reduce server load.

You can’t perform that action at this time.