Skip to content
RausH edited this page Sep 5, 2019 · 41 revisions

Welcome to the Antony wiki!

This wiki aims to describe the functions and features of Antony and to provide help and background info.

Table of Contents

Installation

Antony for Python 2

Antony depends on Python 2 and PyQt4. Both of them are available for a broad range of operating systems.

After you downloaded the release of Antony, copy the distributed files to a local folder of your choice. The program is started by executing Antony.py. On Windows you can optionally rename Antony.py to Antony.pyw. This step hides the python window.

For convenience you can create a shortcut to the executable file on MS Windows. Or setup a *.desktop file on Linux based operating systems.

Alternatively you can download a complete installer for MS Windows. In this case you do not have to care about the dependencies as they are included in the installer. Download

Antony for Python 3

Finally Antony is available for Python 3. Now it depends on Python 3 and uses PySide2 for its GUI. Get the master branch and execute Antony.py

Functions

This program has been designed with a group of up to 20 people, who want to maintain a common photo collection, in mind. Accordingly it features the following functions:

  • Insert images into the database
  • Assign meta data to single images and groups
    • Event name, event location, event type
    • Year
    • Photographer
    • People on images
    • Additional comments
  • Search for images fitting any combination of keywords (even blank search is possible for images where no meta data is available)
  • Export single images or groups and meta data to any folder of your choice
  • Synchronizing or merging of databases
  • Images are identified using md5 sums
  • View enlarged versions of these images using the Antony Viewer

Using Antony

Right after the start of Antony you are greeted with a dialog where you can choose to load an existing or create a new database ("master"). This is important since you can not use Antony without specifying a database. After that you can use Antony according to your agenda.

In general the main window is divided into two parts. On the left hand side you see the area where you can enter meta data or access the database. On the right hand side there is the thumbnail representation of the images. These thumbnails are generated from images you recently added to the database or searched in the database.

Buttons and boxes on the left side

  • "Load Image(s)": opens a dialog for selecting one or more images. The selected images are inserted into the database.
  • "Clear display": removes all images from the thumbnail area and resets all data entry boxes. Accordingly the Antony Viewer is closed too.
  • Data entry boxes: enter the text, tags and meta data for images in the matching boxes. Names have to be entered in the way indicated above the boxes. Antony only accepts names containing two ; .
    • "Remove": removes the selected name from the name list.
    • "Remove all": clears the name list.
  • "Search": uses the keywords entered in the data entry boxes. Images which match all these criteria are displayed as search result in the thumbnail area.
  • "Record for all": inserts all the data given in the entry boxes for all thumbnails currently found on the right side.
  • "Export all": exports all images and associated meta data represented by the thumbnails to a folder of your choice.
  • Radio buttons, "Clicking on single image results in:": selects between inserting data for the image specified by a single mouse click and exporting this image and associated meta data.
  • "Synchronize 2 databases": opens a dialog for selecting a second database ("sync"). Meta data found in "sync" but not in "master" is added to "master". Images found in "sync" but not in "master" are inserted into "master". No information in master is deleted or overwritten.

Thumbnails on the right side

  • Mouse over: displays tooltip showing all available meta data.
  • Single click: inserts data into the database or exports the clicked image.
  • Double click: starts Antony Viewer to display an enlarged version the clicked image.
    • "Antony Viewer": zooming using the mouse wheel
    • "Antony Viewer": rotating images by 90° using "r" or "l"