Uploading files and configuration snippets

It is possible to upload a zip file with Tools > File Manager > Upload new files. The contents of the zip are handled depending on file extensions.

This mechanism can be used to add extra integrations, add configuration snippets, add device database entries, or upload audio or map clips.

File types

The action taken for each file within a zip depends on the file type (determined by the file extension):

 pcma  audio file uploaded to "audio" directory
 lua  integrations file uploaded to "lua" directory
 jpeg jpg png svg   image file uploaded to "map" directory
 wsb  uploaded to "misc" directory
 devdb  device snippet added to the device database
 pdf txt  documentation (ignored on upload)
 conf  configuration snippet added to the configuration 

 

For example a file called cameragroup.conf can include the [CameraGroup_1] and [CameraGroup_2] configuration sections.  This can be zipped up and uploaded to a server to add these configuration items.

Note that file names of files within the zip file may not contain spaces, and may include only A-Z a-z 0-9 - _ and . 

More than one file can be included in the zip file, for example cameragroup.conf and bell.pcma as well as README.txt might be included in the zip file so they can be uploaded to servers at the same time.

Note that documentation can be present in the zip file to allow instructions to be included in the same zip file, but it will be ignored on upload.

Configuration Snippets

Configuration snippets are one or more sections from the configuration file, for example it might be CameraGroup sections only. These replace any existing sections of the same name in the configuration file or add new sections if they are not already present. They do not affect other sections. Normally you obtain these by exporting the configuration and editing it to only include the items needed.

Note that importing a configuration snippet differs from Load From File in Configuration Editor because Load From File will replace all existing sections (except for those special cases selected in the menu) whereas the snippet upload adds to the configuration.