server.port

80
Seit Version 6.2 wird unter Mac OS
Port 8080 als Default gesetzt.

1.0

JA

IP-Port für Zugriff auf Server:
Werte 0-65535

Ermöglicht das optionale Setzen eines Context-Pfades für die URL’s des PicApport Servers.
Die ist z.B. dann sinnvoll wenn der PicApport Server hinter einem Proxy läuft.

Normalerweise ist das URL-Schema von PicApport wie folgt:

• http://meinserver.de/picapport
• http://meinserver.de/js/* für interne javascript Dateien
• http://meinserver.de/css/* für interne css Dateien
• usw…..

Wird nun der server.contextpath gesetzt ändert sich dies wie folgt:

server.contextpath=/meinefotos

• http://meinserver.de/meinefotos/picapport
• http://meinserver.de/meinefotos/js/* für interne javascript Dateien
• http://meinserver.de/meinefotos/css/* für interne css Dateien
• usw…..

Der server.contextpath muss mit einem Schrägstrich anfangen und darf nicht mit einem Schrägstrich beendet werden.

Wird dieses Feature genutzt, ist darauf zu achten die aktuellen Designs (PicApport – Designs) für Version 7 oder später zu verwenden.

server.bind.n

not set
(all available)

1.0

JA

IP-Stack auf dem der Server
erreichbar ist (wird normalerweise
nur bei mehreren Netzwerkkarten
benötigt)
Beispiel:
server.bind.0=192.168.0.1

server.theme

not set (a)

1.0

JA

default JQuery Theme
wenn nichts in Url gesetzt ist

server.photobuffer

not set (3)

1.0

JA

Number of photos loaded into
the browser during the slideshow
The total number of photos in
the browser is server.
(photobuffer*2)+1

Ist als Sortierung „Neuste automatisch aktualisieren“ gewählt,
gibt dieser Wert an, wie viele Fotos in der Slideshow verfügbar
sind. (Vorgabe sind die 100 neusten der Fotos der Abfrage).
Dieser Vorgabewert kann jederzeit mit  dem limitresult:nnnnn
Operator in der Abfrage überschrieben werden.

not set (default: aktuelle
Serveradresse der Browsersession
welche den Link erzeugt)

Ist der PicApport-Server über verschiedene Adressen (z.B lokales WLAN und externe DynDNS-Adresse) erreichbar,
wird mit diesem Parameter eingestellt, welche Serveradresse beim generieren von Links verwendet werden
soll.
Dieser Parameter kann auch über die Weboberfläche in der Benutzerverwaltung bei der Gruppe „Geteilte Fotos“ mit
dem Button „Aktuelle URL für Links setzten“ gesetzt werden.

Beispiel: server.external.address.for.shared.links=http://onlinedemo.picapport.de:80

server.max.concurrent.shares.per.session

Erlaubt es die auf der Weboberfäche verfügbaren Konsolenkommandos zu konfigurieren.
Ist dieser Parameter nicht gesetzt wird folgende Konfiguration verwendet:

• startcrawler

• status

• trace error

• trace info

• trace debug

• restartpicapportserver (Nur wenn Java Runtime ab Version 9 benutzt wird)
• restartpicapportserver dbinit (Nur wenn Java Runtime ab Version 9 benutzt wird)

Beispiel: (Es kann nur der crawler gestartet werden oder Neustart des Servers)

• server.admin.remote.command.0=startcrawler

• server.admin.remote.command.1=restartpicapportserver

Optionale Erweiterung für den restartpicapportserver Konsolenbefehl.  Wird PicApport z.B. unter Windows ohne Server GUI über eine CMD-Konsole gestart ist diese nach dem Neustart nicht mehr verfügbar (obwohl der neue PicApport-Prozess läuft). Mit folgender Konfiguration wird auch für dern neuen Prozess wieder eine Konsole geöffnet:

• server.admin.restart.prefix.0=cmd
• server.admin.restart.prefix.1=/c
• server.admin.restart.prefix.2=start
• server.admin.restart.prefix.3=PicApport Server

gui.enabled

not set (true)
in
picapport-
headless.jar
default=false

1.0

JA

Boolean Parameter um GUI zu
aktivieren/deaktivieren. mögl.
Werte (true/false)

gui.hideintray

not set (true)

1.0

JA

Boolean Parameter um GUI
direkt nach Start im System
Tray  zu verstecken

thumbs.height

not set (160)

1.0

JA

Integer Höhe der Thumbnails.
mögl. Werte 32 – 1024

0= Thumbs immer aus jpg-thumb generieren wenn möglich(default)
1= jpg-thumb benutzen wenn dessen höhe > thumbs.height
2= Thumbs immer aus jpg generieren (beste Qualität aber am langsamsten)

thumbs.num.thumbs.before.pause

not set (250)

1.0

JA

Integer Anzahl  Thumbnails bevor
der „moreButton“ erscheint. mögl.
Werte 10 – 10000

db.max.photos.per.query

not set (2000)

1.0

JA

Integer Anzahl der Photos die
der Server maximal pro Anfrage
verwaltet
mögl. Werte 100 – 1000000
Nicht mehr notwendig(unterstützt)
ab Version 1.2

robot.root.n.path

root.0=$sd
wenn $sd nicht
verfügbar
root.0=$cd

1.0

JA

Voll qualifizierter Pfad(e) zu einem
Rootverzeichnis. Folgende Variablen
können hierbei verwendet werden
(n=0-n):

• $cd – Aktuelles Verzeichnis
• $sd – Systemverzeichnis
  welches
  für Bilder Vorgesehen ist.
  (Bei Windows
  CSIDL_MYPICTURES der
  GetSpecialFolderLocation API)
  Beispiel:
  robot.root.0.path=$cd
  robot.root.1.path=
  E:/AnimalPictures

robot.root.n.id

n

1.0

JA

Optionale ID für diesen Eintrag
(Wenn nicht gesetzt ist wird die
ID auf IDn gesetzt)

Optionaler Parameter. Wenn gesetzt, wird dieser anstatt robot.root.n.path im Verzeichnisbrowser und der Timeline angezeigt.
Zusätzlich wird der Alias bei den Operatoren dir: und dirall: unterstützt indem man ein @ als Prefix voranstellt.  
Im Gegensatz zur intern verwendeten robot.root.n.id die eher beschreibende Funktion hat, ist der Alias optional und kann bei den Operatoren dir: und dirall: verwendet werden.

Beispiel:
Konfigurationsparameter robot.root.0.id=fotos
Konfigurationsparameter robot.root.0.path=C:\Users\public\picapport\photos
Konfigurationsparameter robot.root.0.alias=Fotos

Operator Beispiel ohne alias: dir:“C:\Users\public\picapport\photos\2021\Urlaub“
Operator Beispiel mit alias: dir:“@Fotos\2021\Urlaub“

robot.filter.path.n

nicht gesetzt

1.3

JA

Regulärer Ausdruck um Bilder in
bestimmten Pfade zu heraus zu
filtern: (n=0-n)

Beispiel siehe: Gibt es in PicApport die Möglichkeit, ein bestimmtes Verzeichnis Indizierung/der Ansicht in PicApport auszuschließen?

robot.filter.name.n

nicht gesetzt

offen

nein

Regulärer Ausdruck um Bilder mit
bestimmten Dateinamen (ohne Pfad)
heraus zu filtern: (n=0-n)

robot.rescan.minutes

nicht gesetzt

• default = 5 Minuten
  wenn robot.use.filesystem.monitor = false
• default 1 x täglich um Mitteracht
  wenn robot.use.filesystem.monitor = true
  (oder nicht gesetzt)

1.0

JA

Zeit bis zum nächsten Rescan  in
Minuten (Default ist 5 Minuten oder 1 x täglich)
Ein Rescan kann manuell mit dem
Konsolenbefehl startcrawler
erzwungen werden.

Wertebereich 1 – 2.147.483.647

robot.filter.keywords.n

nicht gesetzt

offen

nein

Regulärer Ausdruck um Bilder
mit bestimmten Keywords
heraus zu filtern: (n=0-n)
Beispiel:
robot. filter.keywords.0=.*private.*
robot. filter.keywords.1=.*privat.*

robot.filter.person.n

nicht gesetzt

offen

nein

Regulärer Ausdruck um Bilder
mit bestimmten Personen heraus
zu filtern: (n=0-n)

robot.filter.title.n

nicht gesetzt

offen

nein

Regulärer Ausdruck um Bilder mit
bestimmten Titeln heraus zu filtern:
(n=0-n)

robot.filter.rating

nicht gesetzt

offen

nein

Gültige Werte (1-5): Beispiel 3
bedeutet nur Bilder mit Rating 3
und höher

Werte 0-9999999

Gib an wie viele Tage Photos nach den Löschen erhalten bleiben.
Wenn > 0 werden die Dateien umbenannt durch Anhängen der Erweiterung .$@$YYYYMMDD$pa$removed  (YYYYMMDD wird durch aktuelles Datum ersetzt)
Die Dateien sind somit nicht mehr in PicApport sichtbar und werden vom Crawler final nach der angegebenen Zeitspanne gelöscht.

Wird als Wert 0 gesetzt, so werden die Dateien sofort gelöscht.

mail.rescan.minutes

not set (9)

2.0

JA

Zeit bis zum nächsten fetchmail
in Minuten (Default ist 9 Minuten)
Ein Fetchmail kann manuell mit
dem Konsolenbefehl startfetchmail
erzwungen werden.

foto.jpg.quality

Qualitätseinstellung der
JPG Komprimierung

Wertebereich 0.0 – 1.0 (1.0 ist beste Qualität)

Qualitätseinstellung der
Scalierung

Mögliche Werte: AUTOMATIC,
SPEED,BALANCED,
QUALITY,ULTRA

Soll ein Cache, für die generierten
Photos verwendet werden

• 0=Kein Read-Cache, Fotos
  werden skaliert wenn für
  Slideshow benötigt
• 1=On demand, Fotos werden
  skaliert wenn zum ersten
  mal für Slideshow benötigt;
• 2=crawler&ondemand,
  Alle Fotos werden
  automatisch zur schnellen
  Verfügbarkeit vom Crawler in
  den Cache eingetragen
  Die Option benötigt  meisten
  Festplattenplatz (ist aber bei
  Abrufen am schnellsten)

foto.jpg.cache.width

Qualitätseinstellung
der Thumbnails

Wertebereich 0.0 – 1.0 (1.0 ist beste Qualität)

Optionaler Parameter.
Wenn gesetzt wird Verzeichnisliste
im Browser sortiert.*
Ist nötig da mache Linux System
überhaupt nicht sortieren.
Mögliche Werte: name,
name_insensitive, name_reverse,
name_reverse_insensitive

Beispiel:
client.folder.sort
=name_reverse_insensitive

Optionaler Parameter.
Steuert den Zoombereich von Originalfotos in der Slideshow.
Wertebereich 100-2000

Optionaler Parameter.
Gibt an welche Videoformate direkt in der Slideshow abgespielt werden können.
Vorraussetzung ist das der Browser diese Formate auch unterstützt.

Wenn der Parameter nicht gesetzt ist gilt folgender Vorgabewert:

[{‚ext‘:‘.mp4′,’mime‘:’video/mp4′},{‚ext‘:‘.ogv‘,’mime‘:’video/ogg‘},{‚ext‘:‘.webm‘,’mime‘:’video/webm‘}]

Der Parameter ist in JSON-Notation zu definieren.

7.3

Die Offlinefähigkeit (WebApp) von PicApport basiert vor Version 7.3 ausschließlich auf der AppCache-Technologie.
Diese wird von nahezu allen Browsern unterstützt. Es wird allerdings von allen Browserherstellern empfohlen,
mittelfristig auf die neuere ServiceWorker Architektur zu wechseln.
Ab Version 7.3 wird die Offlinefähigkeit optional über Serviceworker (Progressive Web App) hergestellt.
(SSL mit gültigem Zertifikat erforderlich).

Wichtig: Mit Freigabe der Version 9.1 vom 12.02.2021 wurde der default auf true umgestellt und der Status Experimentell entfernt (vorher war der default false)

Steuert die Anzeige eines Titels auf den Thumbnails. Folgende Werte sind möglich:

• hidden (nicht sichtbar)

• filename (Dateiname)

• filenamenoext (Dateiname ohne Erweiterung)

• fullpath (Serverpfad zur Datei)

• phototitle (Titel aus den Metadaten)

• photoid (interne ID)

• date (Aufnahemdatum)

• year (Aufnahemejahr)

• timestamp (Zeitstempel)

• fromaddon (Über Add-on gesteuert. Inhalt abhängig vom jeweiligen Add-on. siehe Doku Add-ons)

Optionaler Parameter.
Wertebereich 2-100
Default = 3

Anzahl Fotos für Gruppierung bei Random-Smart-Sortierung.
Bei Random Smart Sortierung werden abhängig von diesem Parameter N-Fotos die nacheinander folgend möglichst am gleichen Tag aufgenommen wurden gruppiert.

Viele Fotobetrachter verwenden eine Baumstruktur zur anzeige von Tags.
Mit dem Prefix wird dafür gesorgt, dass alle von Picapport erzeugten Tags unterhalb von PicApport stehen.

upload.tag

nicht gesetzt
default = @

upload.max.filesize.mb

upload.max.requestsize

Maximale Anzahl gleichzeitiger Dateiübertragungen (Client)
Gültige Werte: 1 bis 100

nicht gesetzt
default = uploads/@$UID$/$YYYY$/$MM$-$TITLE$

Vor Version 9.1 war der defaultwert wie folgt ohne @:

uploads/$UID$/$YYYY$/$MM$-$TITLE$

Pfad für Uploads von Fotos.
Dieser Pfad wird automatisch unterhalb des für Uploads konfigurierten Rootverzeichnisses (siehe: robot.root.n.isuploadroot) angelegt.
Folgende VariableN können verwendet werden (immer Großbuchstaben verwenden):

• $UID$ – Wird durch die UserID (welche den Upload durchführt)  ersetzt
• $YYYY$ – Wird durch das aktuelle Jahr (des Uploads) ersetzt
• $MM$ – Wird durch den aktuellen Monat (des Uploads) ersetzt
• $DD$ – Wird durch den aktuellen Tag (des Uploads) ersetzt
• $TITLE$ – Maximal 127 Zeichen vom Bildtitel (Ungültige Zeichen werden durch _ (underscore) ersetzt)

Wichtig: Keine Verzeichnistrenner (Slash oder Backslash) am Anfang oder Ende des Eintrags eingeben.

Der Wert dieses Parameters wird automatisch als Usertag für Fotos gesetzt die über die Upload-Funktion kommen.
Somit kann jeder Benutzer seine neuen Uploads bequem mit GPS Tags und anderen Infos ausstatten wenn
man #check in das Suchfeld eingibt.    

Ist man mit der Nachbearbeitung der Metadaten fertig, kann man den Tag löschen.
Gibt man false für upload.user.tag ein werden keine Usertags beim Upload erzeugt.

Die folgende URL erläutert die Erzeugung von Zertifikaten unter Ubuntu: https://www.digitalocean.com/community/tutorials/how-to-create-a-self-signed-ssl-certificate-for-apache-in-ubuntu-16-04

Beispiel:
server.ssl.pem.privatekeyfile=/etc/apache2/ssl/apache.key

Die folgende URL erläutert die Erzeugung von Zertifikaten unter Ubuntu: https://www.digitalocean.com/community/tutorials/how-to-create-a-self-signed-ssl-certificate-for-apache-in-ubuntu-16-04

Beispiel:
server.ssl.pem.certificatefile=/etc/apache2/ssl/apache.crt

geo.max.markers

not set (20000)

geo.cluster.size

geo.marker.margin

geo.max.zoom

Default Karte

• 0 = Open Street Map (Vorgabe wenn nichts gesetzt ist)
• 1 = Esri Satellite
• 2 = Open Street Map B&W
• 3 = Thunderforest landscape
• 4 = Thunderforest outdoors

Seit Februar 2017 wird für Thunderforest maps ein apikey benötigt.

Den Key kann man sich hier beschaffen: https://www.thunderforest.com/docs/apikeys/

Beispiel: geo.map.key.thunderforest=abcd1234abcd1234abcd1234abcd1234

pan360.rotation.speed

not set (-4)

Rotationsgeschwindigkeit der 360° Panoramen in Grad pro Sekunde.

• negative Werte = Drehung im Uhrzeigersinn
• positive Werte = Drehung gegen den Uhrzeigersinn
• Wertebereich -180 bis +180

pan360.slideshow.viewtime.seconds

Anzeigezeit in Sekunden der sich drehenden Panoramen in der Slideshow (play-Modus)

• Der Defaultwert von 90 Sekunden bedeutet, dass bei der Vorgaberotation von -4 (pan360.rotation.speed)
  das Panorama etwa so lange angezeigt wird bis eine Umdrehung ausgeführt wurde.
• Wird der Parameter auf 0 gesetzt, so wird der Panoramaviewer in der Slideshow (play-Modus)
  nicht automatisch gestartet.
• Wertebereich 0-99999

pan360.tags

Tags die automatisch generiert werden um 360° Panoramen suchen zu können.

Standardmäßig verwendet PicApport den Tag pan360.

Wird dieser Parameter verändert oder gesetzt sollte danach die Datenbank neu aufgebaut werden.

Gib den Standard Suchmodus bei der Volltextsuche an.

Hierbei wird gesteuert wie sich die Volltextsuche bei der Eingabe der Tilde(~)-Zeichen (Fuzzy-Suche) verhält:

Unabhängig von Suchmodus gilt:

• ~~suchwort
  Nur phonetische Suche: sucht nach phonetisch gleichklingenden Worten (z.B. Eingabe ~~Maier findet Maier, Mayer, Meier) siehe auch: weiter unten fuzzysearch.phonetic.encoder
• ~~~suchwort
  Nur Suche über Synonyme: Sucht nur wenn ein Thesauruseintrag gefunden wurde nach allen Synonymen. Ist das Wort nicht im Thesaurus eingetragen wird „normal“ (ohne Thesaurus) gesucht.

not set (Vorgabe ist Sprachabhängig)
Vorgaben:

de: ColognePhonetic

en: DoubleMetaphone

es: none

fr: none

Folgende Verfahren werden unterstützt: (Wichtig: unbedingt auf Gross- Kleinschreibung achten)

• none
  Deaktiviert phonetische Suche
• ColognePhonetic
  Kölner Phonetik siehe: https://de.wikipedia.org/wiki/K%C3%B6lner_Phonetik
• Soundex
  siehe:  https://de.wikipedia.org/wiki/Soundex
• RefinedSoundex
  siehe: http://ntz-develop.blogspot.com/2011/03/phonetic-algorithms.html

• Metaphone
  siehe: https://de.wikipedia.org/wiki/Metaphone

• DoubleMetaphone
  siehe: https://en.wikipedia.org/wiki/Metaphone#Double_Metaphone
• Caverphone2
  siehe: https://en.wikipedia.org/wiki/Caverphone
• DaitchMokotoffSoundex
  siehe: https://en.wikipedia.org/wiki/Daitch%E2%80%93Mokotoff_Soundex
• MatchRatingApproachEncoder
  siehe: https://en.wikipedia.org/wiki/Match_rating_approach
• Nysiis
  siehe: https://en.wikipedia.org/wiki/New_York_State_Identification_and_Intelligence_System

siehe Configuration parameter to control Web-API functions in picapport.properties

auf PicApport Web-API