Upload a large set of images

    TEKLIA provides a service to upload a large number of images directly on a IIIF image server. After the upload, the images are immediately available to be imported in Arkindex. This service is particularly useful when you do not already have a IIIF server hosting your images. The procedure to use this service is the following :

    Account creation🔗

    First you need to ask TEKLIA (you can reach us by email at team@teklia.com or on our contact form ) for the creation of an account on this service. You will receive a user name (access-key) and a password (secret-key) by wormhole.app

    Warning

    The link on https://wormhole.app/ is valid only 24 hours. After this period, you will need to ask for a new link.

    Upload images using the web interface🔗

    This method can be used for small files or a small number of files. For large files or a large number of file, prefer using a client such as Cyberduck (described below)

    • connect to storage.teklia.com and use the Access-Key and Secret Key provided by Teklia.

    • You will now be connected to https://storage.teklia.com/minio/<your_bucket>

    Login on the web interface
    Login on the web interface
    • You can create new folders to organize your images with the + button at the top left of your window.
    Create a folder
    Create a folder
    • You can import images into you bucket with the + button at the bottom right of your window.
    Select files
    Select files
    Importing files
    Importing files
    • Finally, you can check that the file are correctly transferred on the server:
    Imported files
    Imported files

    Upload large sets of images using Cyberduck🔗

    Cyberduck is a graphical application available on Microsoft Windows and Mac Os X.

    1. install Cyberduck

    2. start Cyberduck

    3. open a new connection and configure it:

      • select Amazon S3 type
      • enter a display name: Teklia storage
      • enter the server address: storage.teklia.com
      • enter your Access-Key
      • entrer your Secret access Key
      • connect
    4. you may be asked to enter your access key again at the first connection

    Cyberduck settings for storage.teklia.com
    Cyberduck settings for storage.teklia.com
    • you can organize your files in folders (create folder option in cyberduck)
    Create folder in cyberduck
    Create folder in cyberduck
    • you can now drag and drop files to upload them to Teklia storage servers
    Import files in cyberduck
    Import files in cyberduck
    • you can check that the file are correctly transferred:
    Check imported files in cyberduck
    Check imported files in cyberduck

    Upload large sets of images using the Cyberduck CLI🔗

    1. Install Cyberduck CLI using this documentation depending on which OS you are using https://trac.cyberduck.io/wiki/help/en/howto/cli
    2. After installing the CLI, you should run the following command: duck --upload s3://storage.teklia.com/<your-bucket> <PATH to your data>
      • you should replace <your-bucket> with the name of your bucket
      • you should replace <PATH to your data> with the path to your data locally
    3. You will be prompted to type your Access-Key which is your username
    4. Once you provide your username, you will then be prompted to type your Secret access Key
    5. The upload will then start and once it is done you will find your data in your bucket

    Using your images from the IIIF server🔗

    Once your images are uploaded on storage.teklia.com, they are immediately available through one of our IIIF servers.

    For european customers, the IIIF base url is https://iiif-europe.teklia.com/iiif/2.

    To get your image URL, you'll need two information:

    • the storage bucket name (provided by Teklia and should be ending in -data)
    • the image path on the bucket

    You then need to concatenate all 3 parts: IIIF base url + bucket name + image path

    Let's say you have uploaded the image test.jpg on the bucket clientX-data, then your IIIF image url will be: https://iiif-europe.teklia.com/iiif/2/clientX-data%2Ftest.jpg

    Folders🔗

    If you organized your content in folders, you need to url-encode the image path from the sever root to follow the IIIF spec.

    If you uploaded the image project/folderX/imageY.png in bucket clientX-data, then your IIIF image url will be https://iiif-europe.teklia.com/iiif/2/clientX-data%2Fproject%2FfolderX%2FimageY.png

    View the image🔗

    Finally to view the image in your web browser, and not only its metadata, you need to specify a IIIF operation

    The simplest operation is to view the raw file without modification, as a JPEG (whatever your original file format): simply suffix your image url with /full/full/0/default.jpg.

    So for the image test.jpg from clientX-data this becomes: https://iiif-europe.teklia.com/iiif/2/clientX-data%2Ftest.jpg/full/full/0/default.jpg

    View in Arkindex🔗

    To view your content in Arkindex, please send us an email at team@teklia.com once your content is organized: we'll import your images into an Arkindex instance.