Page tree
Skip to end of metadata
Go to start of metadata

The goal of PicApport is to make photos available as easily as possible and without much effort. Here we briefly describe the different ways in which PicApport can be integrated into the individual photo workflow.

Essential for all of these variants is the functionality of the PicApport server, that certain, predefined directories of a file system are searched in regular intervals for new picture and video files and new files are made available immediately and without further action in PicApport.

The file system of the server

The PicApport Server can access local directories as well as directories on NAS servers. When accessing NAS servers, however, it must be ensured that this is reliably available. Furthermore it has to be considered that NAS systems often have much slower transfer rates than local hard disks. To achieve the highest performance, we recommend using a locally connected SSD hard drive.


Which directories PicApport should search for images and videos can be individually defined. The initial configuration is done during the installation of the server.

If you use the Windows-Installer or the graphical user interface of the server this is done comfortably with a few mouse clicks.
See also: PicApport - Server Userinterface

For installations without installer or without graphical user interface the configuration is done by a manual entry of one or more paths in the file.
See also "robot.* Configuration of photo crawler (Photo-directories)" in the PicApport-Server Guide.

(Glühbirne)Tip: When editing the file manually, it is important to note that certain characters in .properties files must be written with a \ (backslash) as a prefix. (see General rules for the Java .properties file format in the PicApport-Server Guide).


Once set up, PicApport Server reliably finds new files in the configured directories and makes them available in the search function.
Changes or deletions are also reliably detected by the server and synchronized with the internal database.
This makes it possible to combine PicApport with external tools and services like FTP or WebDAV server to copy files to the server.

The recognition of changes takes place over 2 mechanisms which can be configured independently of each other. On the one hand over the filesystem monitor, which nearly all current operating systems support, and on the other hand over the PicApport Crawler, which works also for drives, for which the filesystem monitor is not available.

Both mechanisms are pre-configured during the installation of the PicApport server and an adjustment of the parameters is normally not necessary. See also robot.use.filesystem.monitor and robot.rescan.minutes in the PicApport-Server Guide

The upload function of the browser interface

This function is mainly used to transfer photos taken with a cell phone or tablet directly to the PicApport server.
The special feature here is that metadata such as image titles or tags can be assigned directly, which the PicApport server then enters into the photo files.
files. See also Photo Upload on The PicApport landing page or homepage (#home)

Since version 10.0 (summer 2021) it is also possible to transfer video files with the upload function. Prerequisite for this is that the video plugin is installed (see

On the server itself, you can configure which directory the photos or videos should be copied to. Also the photos and videos uploaded via the upload function can be tagged for identification purposes.

See also upload.* Upload configuration in the PicApport-Server Guide.

The upload configuration is also valid for uploads from the PhotoSync App and for the WebApi.

The following metadata can be set during the upload by entering it in the optional title field:

Metadata name

Technical name of the
meta information

Data type
Value range

Image titledc:title
namespace:Dublin Core

Image title as entered until the first entry of a rating, person or tag is detected.

Example (The text in bold, italics is the title in each case):

  • Easter with family[t:family; kids] r:2
  • Vacation in Italy r:3
  • Sunset at Lake Constance
  • Group picture Christmas party at grandma
  • Easter with family[t:family; kids] r:2
  • Vacation in Italy r:3
Rating (stars)xmp:Rating
namespace:Dublin Core

where n = 0-5

  • r:4
  • r:1
namespace:Dublin Core

Multiple text tags separated by comma or semicolon.

[t:first tag; second tag; third tag]

  • [t: flower, macro, rose]
  • [t: celebration; party]
namespace:Microsoft Photo 1.2

Multiple person names separated by comma or semicolon.

[p:first person; second person; third person]
  • [p:Paul Smith, Veronica Smith]
  • [p:Grandpa; Grandma]

The PicApport PhotoSync App

The PicApport PhotySync App enables the fully automatic synchronization of photos and videos from your cell phone or tablet to the PicApport server.

Detailed information incl. screenshots can be found here: PicApport PhotoSync

The PicApport internal mail client

Still from the early days of PicApport is the mail client. With it pictures can be transmitted as email attachment to the PicApport server. For the configuration, however, the PicApport Server user interface is required together with installed JAVA-FX.

The Web API (for programmers)

Of course, the integrated Web-API can also be used to transfer photos and videos to the PicApport server.

The documentation for this can be found under PicApport Web-API

  • No labels