# Pigallery 2 man page pigallery2 uses [typeconfig](https://github.com/bpatrik/typeconfig) for configuration `npm start -- --help` prints the following: ``` Usage: [options] Meta cli options: --help prints this manual --config-path sets the config file location --config-attachState prints the value state (default, readonly, volatile, etc..) to the config file --config-attachDesc prints description to the config file --config-rewrite-cli updates the config file with the options from cli switches --config-rewrite-env updates the config file with the options from environmental variables --config-string-enum enums are stored as string in the config file (instead of numbers) --config-save-if-not-exist creates config file if not exist --config-save-and-exist creates config file and terminates can be configured through the configuration file, cli switches and environmental variables. All settings are case sensitive. Example for setting config MyConf through cli: ' --MyConf=5' and through env variable: 'SET MyConf=5' . Default values can be also overwritten by prefixing the options with 'default-', like ' --default-MyConf=5' and 'SET default-MyConf=5' App CLI options: --Server-sessionSecret (default: []) --Server-port (default: 80) --Server-host (default: '0.0.0.0') --Server-Media-folder Images are loaded from this folder (read permission required) (default: 'demo/images') --Server-Media-tempFolder Thumbnails, converted photos, videos will be stored here (write permission required) (default: 'demo/tmp') --Server-Media-Video-transcoding-bitRate (default: 5242880) --Server-Media-Video-transcoding-resolution (default: 720) --Server-Media-Video-transcoding-fps (default: 25) --Server-Media-Video-transcoding-codec (default: 'libx264') --Server-Media-Video-transcoding-format (default: 'mp4') --Server-Media-Video-transcoding-crf Constant Rate Factor. The range of the CRF scale is 0–51, where 0 is lossless, 23 is the default, and 51 is worst quality possible. (default: 23) --Server-Media-Video-transcoding-preset A preset is a collection of options that will provide a certain encoding speed to compression ratio (default: 'medium') --Server-Media-Video-transcoding-customOptions It will be sent to ffmpeg as it is, as custom options. (default: []) --Server-Media-Photo-Converting-onTheFly Converts photos on the fly, when they are requested. (default: true) --Server-Media-Photo-Converting-resolution (default: 1080) --Server-Media-Thumbnail-qualityPriority if true, photos will have better quality. (default: true) --Server-Media-Thumbnail-personFaceMargin (default: 0.6) --Server-Preview-SearchQuery (default: {"type":100,"text":""}) --Server-Preview-Sorting (default: [6,4]) --Server-Threading-enabled App can run on multiple thread (default: true) --Server-Threading-thumbnailThreads Number of threads that are used to generate thumbnails. If 0, number of 'CPU cores -1' threads will be used. (default: 0) --Server-Database-type (default: 'sqlite') --Server-Database-dbFolder (default: 'db') --Server-Database-sqlite-DBFileName (default: 'sqlite.db') --Server-Database-mysql-host (default: 'localhost') --Server-Database-mysql-port (default: 3306) --Server-Database-mysql-database (default: 'pigallery2') --Server-Database-mysql-username (default: '') --Server-Database-mysql-password (default: '') --Server-Database-enforcedUsers Creates these users in the DB if they do not exist. If a user with this name exist, it wont be overwritten, even if the role is different. (default: []) --Server-Sharing-updateTimeout (default: 300000) --Server-sessionTimeout unit: ms (default: 604800000) --Server-Indexing-cachedFolderTimeout (default: 3600000) --Server-Indexing-reIndexingSensitivity (default: 'low') --Server-Indexing-excludeFolderList If an entry starts with '/' it is treated as an absolute path. If it doesn't start with '/' but contains a '/', the path is relative to the image directory. If it doesn't contain a '/', any folder with this name will be excluded. (default: [".Trash-1000",".dtrash","$RECYCLE.BIN"]) --Server-Indexing-excludeFileList Any folder that contains a file with this name will be excluded from indexing. (default: []) --Server-photoMetadataSize only this many bites will be loaded when scanning photo for metadata (default: 524288) --Server-Duplicates-listingLimit (default: 1000) --Server-Log-level (default: 'info') --Server-Log-sqlLevel (default: 'error') --Server-Log-logServerTiming (default: false) --Server-Jobs-maxSavedProgress Job history size (default: 10) --Server-Jobs-scheduled (default: [{"name":"Indexing","jobName":"Indexing","config":{"indexChangesOnly":true},"allowParallelRun":false,"trigger":{"type":1}},{"name":"Preview Filling","jobName":"Preview Filling","config":{},"allowParallelRun":false,"trigger":{"type":1}},{"name":"Thumbnail Generation","jobName":"Thumbnail Generation","config":{"sizes":[240],"indexedOnly":true},"allowParallelRun":false,"trigger":{"type":4,"afterScheduleName":"Preview Filling"}},{"name":"Photo Converting","jobName":"Photo Converting","config":{"indexedOnly":true},"allowParallelRun":false,"trigger":{"type":4,"afterScheduleName":"Thumbnail Generation"}},{"name":"Video Converting","jobName":"Video Converting","config":{"indexedOnly":true},"allowParallelRun":false,"trigger":{"type":4,"afterScheduleName":"Photo Converting"}},{"name":"Temp Folder Cleaning","jobName":"Temp Folder Cleaning","config":{"indexedOnly":true},"allowParallelRun":false,"trigger":{"type":4,"afterScheduleName":"Video Converting"}}]) --Client-applicationTitle (default: 'PiGallery 2') --Client-publicUrl (default: '') --Client-urlBase (default: '') --Client-Search-enabled (default: true) --Client-Search-searchCacheTimeout (default: 3600000) --Client-Search-AutoComplete-enabled (default: true) --Client-Search-AutoComplete-targetItemsPerCategory (default: 5) --Client-Search-AutoComplete-maxItems (default: 30) --Client-Search-AutoComplete-cacheTimeout (default: 3600000) --Client-Search-maxMediaResult (default: 10000) --Client-Search-listDirectories Search returns also with directories, not just media (default: false) --Client-Search-listMetafiles Search also returns with metafiles from directories that contain a media file of the matched search result (default: true) --Client-Search-maxDirectoryResult (default: 200) --Client-Sharing-enabled (default: true) --Client-Sharing-passwordProtected (default: true) --Client-Album-enabled (default: true) --Client-Map-enabled (default: true) --Client-Map-maxPreviewMarkers Maximum number of markers to be shown on the map preview on the gallery page. (default: 50) --Client-Map-useImageMarkers (default: true) --Client-Map-mapProvider (default: 'OpenStreetMap') --Client-Map-mapboxAccessToken (default: '') --Client-Map-customLayers (default: [{"name":"street","url":""}]) --Client-RandomPhoto-enabled Enables random link generation. NOTE: With the current implementation, it poses a security risk. See https://github.com/bpatrik/pigallery2/issues/392 (default: false) --Client-Other-customHTMLHead (default: '') --Client-Other-enableCache (default: true) --Client-Other-enableOnScrollRendering (default: true) --Client-Other-defaultPhotoSortingMethod (default: 'ascDate') --Client-Other-enableDirectorySortingByDate If enabled directories will be sorted by date, like photos, otherwise by name. Directory date is the last modification time of that directory not the creation date of the oldest photo (default: false) --Client-Other-enableOnScrollThumbnailPrioritising (default: true) --Client-Other-NavBar-showItemCount (default: true) --Client-Other-captionFirstNaming (default: false) --Client-Other-enableDownloadZip (default: false) --Client-Other-enableDirectoryFlattening Adds a button to flattens the file structure, by listing the content of all subdirectories. (default: false) --Client-authenticationRequired (default: true) --Client-unAuthenticatedUserRole (default: 'Admin') --Client-Media-Thumbnail-iconSize (default: 45) --Client-Media-Thumbnail-personThumbnailSize (default: 200) --Client-Media-Thumbnail-thumbnailSizes (default: [240,480]) --Client-Media-Video-enabled (default: true) --Client-Media-Photo-Converting-enabled (default: true) --Client-Media-Photo-loadFullImageOnZoom Enables loading the full resolution image on zoom in the ligthbox (preview). (default: true) --Client-MetaFile-gpx Reads *.gpx files and renders them on the map. (default: true) --Client-MetaFile-markdown Reads *.md files in a directory and shows the next to the map. (default: true) --Client-MetaFile-pg2conf Reads *.pg2conf files (You can use it for custom sorting and save search (albums)). (default: true) --Client-Faces-enabled (default: true) --Client-Faces-keywordsToPersons (default: true) --Client-Faces-writeAccessMinRole (default: 'Admin') --Client-Faces-readAccessMinRole (default: 'User') Environmental variables: Server-sessionSecret (default: []) Server-port (default: 80) PORT same as Server-port Server-host (default: '0.0.0.0') Server-Media-folder Images are loaded from this folder (read permission required) (default: 'demo/images') Server-Media-tempFolder Thumbnails, converted photos, videos will be stored here (write permission required) (default: 'demo/tmp') Server-Media-Video-transcoding-bitRate (default: 5242880) Server-Media-Video-transcoding-resolution (default: 720) Server-Media-Video-transcoding-fps (default: 25) Server-Media-Video-transcoding-codec (default: 'libx264') Server-Media-Video-transcoding-format (default: 'mp4') Server-Media-Video-transcoding-crf Constant Rate Factor. The range of the CRF scale is 0–51, where 0 is lossless, 23 is the default, and 51 is worst quality possible. (default: 23) Server-Media-Video-transcoding-preset A preset is a collection of options that will provide a certain encoding speed to compression ratio (default: 'medium') Server-Media-Video-transcoding-customOptions It will be sent to ffmpeg as it is, as custom options. (default: []) Server-Media-Photo-Converting-onTheFly Converts photos on the fly, when they are requested. (default: true) Server-Media-Photo-Converting-resolution (default: 1080) Server-Media-Thumbnail-qualityPriority if true, photos will have better quality. (default: true) Server-Media-Thumbnail-personFaceMargin (default: 0.6) Server-Preview-SearchQuery (default: {"type":100,"text":""}) Server-Preview-Sorting (default: [6,4]) Server-Threading-enabled App can run on multiple thread (default: true) Server-Threading-thumbnailThreads Number of threads that are used to generate thumbnails. If 0, number of 'CPU cores -1' threads will be used. (default: 0) Server-Database-type (default: 'sqlite') Server-Database-dbFolder (default: 'db') Server-Database-sqlite-DBFileName (default: 'sqlite.db') Server-Database-mysql-host (default: 'localhost') MYSQL_HOST same as Server-Database-mysql-host Server-Database-mysql-port (default: 3306) MYSQL_PORT same as Server-Database-mysql-port Server-Database-mysql-database (default: 'pigallery2') MYSQL_DATABASE same as Server-Database-mysql-database Server-Database-mysql-username (default: '') MYSQL_USERNAME same as Server-Database-mysql-username Server-Database-mysql-password (default: '') MYSQL_PASSWORD same as Server-Database-mysql-password Server-Database-enforcedUsers Creates these users in the DB if they do not exist. If a user with this name exist, it wont be overwritten, even if the role is different. (default: []) Server-Sharing-updateTimeout (default: 300000) Server-sessionTimeout unit: ms (default: 604800000) Server-Indexing-cachedFolderTimeout (default: 3600000) Server-Indexing-reIndexingSensitivity (default: 'low') Server-Indexing-excludeFolderList If an entry starts with '/' it is treated as an absolute path. If it doesn't start with '/' but contains a '/', the path is relative to the image directory. If it doesn't contain a '/', any folder with this name will be excluded. (default: [".Trash-1000",".dtrash","$RECYCLE.BIN"]) Server-Indexing-excludeFileList Any folder that contains a file with this name will be excluded from indexing. (default: []) Server-photoMetadataSize only this many bites will be loaded when scanning photo for metadata (default: 524288) Server-Duplicates-listingLimit (default: 1000) Server-Log-level (default: 'info') Server-Log-sqlLevel (default: 'error') Server-Log-logServerTiming (default: false) Server-Jobs-maxSavedProgress Job history size (default: 10) Server-Jobs-scheduled (default: [{"name":"Indexing","jobName":"Indexing","config":{"indexChangesOnly":true},"allowParallelRun":false,"trigger":{"type":1}},{"name":"Preview Filling","jobName":"Preview Filling","config":{},"allowParallelRun":false,"trigger":{"type":1}},{"name":"Thumbnail Generation","jobName":"Thumbnail Generation","config":{"sizes":[240],"indexedOnly":true},"allowParallelRun":false,"trigger":{"type":4,"afterScheduleName":"Preview Filling"}},{"name":"Photo Converting","jobName":"Photo Converting","config":{"indexedOnly":true},"allowParallelRun":false,"trigger":{"type":4,"afterScheduleName":"Thumbnail Generation"}},{"name":"Video Converting","jobName":"Video Converting","config":{"indexedOnly":true},"allowParallelRun":false,"trigger":{"type":4,"afterScheduleName":"Photo Converting"}},{"name":"Temp Folder Cleaning","jobName":"Temp Folder Cleaning","config":{"indexedOnly":true},"allowParallelRun":false,"trigger":{"type":4,"afterScheduleName":"Video Converting"}}]) Client-applicationTitle (default: 'PiGallery 2') Client-publicUrl (default: '') Client-urlBase (default: '') Client-Search-enabled (default: true) Client-Search-searchCacheTimeout (default: 3600000) Client-Search-AutoComplete-enabled (default: true) Client-Search-AutoComplete-targetItemsPerCategory (default: 5) Client-Search-AutoComplete-maxItems (default: 30) Client-Search-AutoComplete-cacheTimeout (default: 3600000) Client-Search-maxMediaResult (default: 10000) Client-Search-listDirectories Search returns also with directories, not just media (default: false) Client-Search-listMetafiles Search also returns with metafiles from directories that contain a media file of the matched search result (default: true) Client-Search-maxDirectoryResult (default: 200) Client-Sharing-enabled (default: true) Client-Sharing-passwordProtected (default: true) Client-Album-enabled (default: true) Client-Map-enabled (default: true) Client-Map-maxPreviewMarkers Maximum number of markers to be shown on the map preview on the gallery page. (default: 50) Client-Map-useImageMarkers (default: true) Client-Map-mapProvider (default: 'OpenStreetMap') Client-Map-mapboxAccessToken (default: '') Client-Map-customLayers (default: [{"name":"street","url":""}]) Client-RandomPhoto-enabled Enables random link generation. NOTE: With the current implementation, it poses a security risk. See https://github.com/bpatrik/pigallery2/issues/392 (default: false) Client-Other-customHTMLHead (default: '') Client-Other-enableCache (default: true) Client-Other-enableOnScrollRendering (default: true) Client-Other-defaultPhotoSortingMethod (default: 'ascDate') Client-Other-enableDirectorySortingByDate If enabled directories will be sorted by date, like photos, otherwise by name. Directory date is the last modification time of that directory not the creation date of the oldest photo (default: false) Client-Other-enableOnScrollThumbnailPrioritising (default: true) Client-Other-NavBar-showItemCount (default: true) Client-Other-captionFirstNaming (default: false) Client-Other-enableDownloadZip (default: false) Client-Other-enableDirectoryFlattening Adds a button to flattens the file structure, by listing the content of all subdirectories. (default: false) Client-authenticationRequired (default: true) Client-unAuthenticatedUserRole (default: 'Admin') Client-Media-Thumbnail-iconSize (default: 45) Client-Media-Thumbnail-personThumbnailSize (default: 200) Client-Media-Thumbnail-thumbnailSizes (default: [240,480]) Client-Media-Video-enabled (default: true) Client-Media-Photo-Converting-enabled (default: true) Client-Media-Photo-loadFullImageOnZoom Enables loading the full resolution image on zoom in the ligthbox (preview). (default: true) Client-MetaFile-gpx Reads *.gpx files and renders them on the map. (default: true) Client-MetaFile-markdown Reads *.md files in a directory and shows the next to the map. (default: true) Client-MetaFile-pg2conf Reads *.pg2conf files (You can use it for custom sorting and save search (albums)). (default: true) Client-Faces-enabled (default: true) Client-Faces-keywordsToPersons (default: true) Client-Faces-writeAccessMinRole (default: 'Admin') Client-Faces-readAccessMinRole (default: 'User') ``` ### `config.json` sample: ```json { "Server": { "sessionSecret": [], "port": 80, "host": "0.0.0.0", "Media": { "//[folder]": "Images are loaded from this folder (read permission required)", "folder": "demo/images", "//[tempFolder]": "Thumbnails, converted photos, videos will be stored here (write permission required)", "tempFolder": "demo/tmp", "Video": { "transcoding": { "bitRate": 5242880, "resolution": 720, "fps": 25, "codec": "libx264", "format": "mp4", "//[crf]": "Constant Rate Factor. The range of the CRF scale is 0–51, where 0 is lossless, 23 is the default, and 51 is worst quality possible.", "crf": 23, "//[preset]": "A preset is a collection of options that will provide a certain encoding speed to compression ratio", "preset": "medium", "//[customOptions]": "It will be sent to ffmpeg as it is, as custom options.", "customOptions": [] } }, "Photo": { "Converting": { "//[onTheFly]": "Converts photos on the fly, when they are requested.", "onTheFly": true, "resolution": 1080 } }, "Thumbnail": { "//[qualityPriority]": "if true, photos will have better quality.", "qualityPriority": true, "personFaceMargin": 0.6 } }, "Preview": { "SearchQuery": { "type": 100, "text": "" }, "Sorting": [ 6, 4 ] }, "Threading": { "//[enabled]": "App can run on multiple thread", "enabled": true, "//[thumbnailThreads]": "Number of threads that are used to generate thumbnails. If 0, number of 'CPU cores -1' threads will be used.", "thumbnailThreads": 0 }, "Database": { "type": "sqlite", "dbFolder": "db", "sqlite": { "DBFileName": "sqlite.db" }, "mysql": { "host": "localhost", "port": 3306, "database": "pigallery2", "username": "", "password": "" }, "//[enforcedUsers]": "Creates these users in the DB if they do not exist. If a user with this name exist, it wont be overwritten, even if the role is different.", "enforcedUsers": [] }, "Sharing": { "updateTimeout": 300000 }, "//[sessionTimeout]": "unit: ms", "sessionTimeout": 604800000, "Indexing": { "cachedFolderTimeout": 3600000, "reIndexingSensitivity": "low", "//[excludeFolderList]": "If an entry starts with '/' it is treated as an absolute path. If it doesn't start with '/' but contains a '/', the path is relative to the image directory. If it doesn't contain a '/', any folder with this name will be excluded.", "excludeFolderList": [ ".Trash-1000", ".dtrash", "$RECYCLE.BIN" ], "//[excludeFileList]": "Any folder that contains a file with this name will be excluded from indexing.", "excludeFileList": [] }, "//[photoMetadataSize]": "only this many bites will be loaded when scanning photo for metadata", "photoMetadataSize": 524288, "Duplicates": { "listingLimit": 1000 }, "Log": { "level": "info", "sqlLevel": "error", "logServerTiming": false }, "Jobs": { "//[maxSavedProgress]": "Job history size", "maxSavedProgress": 10, "scheduled": [ { "name": "Indexing", "jobName": "Indexing", "config": { "indexChangesOnly": true }, "allowParallelRun": false, "trigger": { "type": "never" } }, { "name": "Preview Filling", "jobName": "Preview Filling", "config": {}, "allowParallelRun": false, "trigger": { "type": "never" } }, { "name": "Thumbnail Generation", "jobName": "Thumbnail Generation", "config": { "sizes": [ 240 ], "indexedOnly": true }, "allowParallelRun": false, "trigger": { "type": "after", "afterScheduleName": "Preview Filling" } }, { "name": "Photo Converting", "jobName": "Photo Converting", "config": { "indexedOnly": true }, "allowParallelRun": false, "trigger": { "type": "after", "afterScheduleName": "Thumbnail Generation" } }, { "name": "Video Converting", "jobName": "Video Converting", "config": { "indexedOnly": true }, "allowParallelRun": false, "trigger": { "type": "after", "afterScheduleName": "Photo Converting" } }, { "name": "Temp Folder Cleaning", "jobName": "Temp Folder Cleaning", "config": { "indexedOnly": true }, "allowParallelRun": false, "trigger": { "type": "after", "afterScheduleName": "Video Converting" } } ] } }, "Client": { "applicationTitle": "PiGallery 2", "publicUrl": "", "urlBase": "", "Search": { "enabled": true, "searchCacheTimeout": 3600000, "AutoComplete": { "enabled": true, "targetItemsPerCategory": 5, "maxItems": 30, "cacheTimeout": 3600000 }, "maxMediaResult": 10000, "//[listDirectories]": "Search returns also with directories, not just media", "listDirectories": false, "//[listMetafiles]": "Search also returns with metafiles from directories that contain a media file of the matched search result", "listMetafiles": true, "maxDirectoryResult": 200 }, "Sharing": { "enabled": true, "passwordProtected": true }, "Album": { "enabled": true }, "Map": { "enabled": true, "//[maxPreviewMarkers]": "Maximum number of markers to be shown on the map preview on the gallery page.", "maxPreviewMarkers": 50, "useImageMarkers": true, "mapProvider": "OpenStreetMap", "mapboxAccessToken": "", "customLayers": [ { "name": "street", "url": "" } ] }, "RandomPhoto": { "//[enabled]": "Enables random link generation. NOTE: With the current implementation, it poses a security risk. See https://github.com/bpatrik/pigallery2/issues/392", "enabled": false }, "Other": { "customHTMLHead": "", "enableCache": true, "enableOnScrollRendering": true, "defaultPhotoSortingMethod": "ascDate", "//[enableDirectorySortingByDate]": "If enabled directories will be sorted by date, like photos, otherwise by name. Directory date is the last modification time of that directory not the creation date of the oldest photo", "enableDirectorySortingByDate": false, "enableOnScrollThumbnailPrioritising": true, "NavBar": { "showItemCount": true }, "captionFirstNaming": false, "enableDownloadZip": false, "//[enableDirectoryFlattening]": "Adds a button to flattens the file structure, by listing the content of all subdirectories.", "enableDirectoryFlattening": false }, "authenticationRequired": true, "unAuthenticatedUserRole": "Admin", "Media": { "Thumbnail": { "iconSize": 45, "personThumbnailSize": 200, "thumbnailSizes": [ 240, 480 ] }, "Video": { "enabled": true }, "Photo": { "Converting": { "enabled": true }, "//[loadFullImageOnZoom]": "Enables loading the full resolution image on zoom in the ligthbox (preview).", "loadFullImageOnZoom": true } }, "MetaFile": { "//[gpx]": "Reads *.gpx files and renders them on the map.", "gpx": true, "//[markdown]": "Reads *.md files in a directory and shows the next to the map.", "markdown": true, "//[pg2conf]": "Reads *.pg2conf files (You can use it for custom sorting and save search (albums)).", "pg2conf": true }, "Faces": { "enabled": true, "keywordsToPersons": true, "writeAccessMinRole": "Admin", "readAccessMinRole": "User" } } }```