Console commands

When you access Xeoma in a Terminal, you’ll get these regular commands displayed:

Usage: Xeoma.app [-command] [-argument]
Commands:

Command Description
-help show this help
-core run server only
-client [password@address:port] run client only. Can be used without parameter, also password and port can be empty. For example: -client 192.168.0.1
-lls run License Server
-install [-argument] works with argument only
-install -allmanual install Server and client with manual start
-install -allauto install Server and client with auto start
-install -coreauto install Server (autoStart) and client (manualStart)
-install -hiddenmode install Server (autoStart) hidden mode used
-install -cloudauto install Cloud with auto start
-install -removeall remove all, include Archive and config files
-install -removeexe remove program, leave Archive and config files
-install -licauto install License Server with auto start
-installdir [DirPath] set install directory. ATTENTION! Path to dir must be in UTF-8 encoding!
-stopservice stop Xeoma service (if installed)
-startservice start Xeoma service (if installed)
-restartservice restart Xeoma service (if installed)
-activateOnline [Serial] online activation (enframe Serials with single quotes and separate them with ‘;’. For example: -activateOnline ‘Serial1;Serial2’)
-licenseServer [LicenseServer] license server for online activation. For example: 192.168.0.1::8090
-activateRequest [Serial] offline activation (separate Serials with 😉
-activateResponse [Activation] offline activation
-showpassword show current password and set enable network access
-startdelay [seconds] delay before starting in seconds
-log enable log for server events
-lang [Language] for English: en, for Russian: ru, etc.
-clientIndex [ClientID] client ID can contain only letters and numbers (no spaces, maximum 16 characters)
-individualsettings store personal settings individually for each client
-cloud start Cloud server with auto restart on crashes
-noguard use this parameter with -cloud to run Cloud without restart guard
-sampleconfig use this parameter with -cloud to generate sample config in Cloud mode
-nohup ignore the HUP (hangup) signal
-noscan disable camera scanning
-noscanptzandaudio disable scanning for ptz and audio url
-proxy [ProxyServerURL] set proxy server address
-proxyclear remove stored proxy server address
-noarchivedb disable archive database (search in archive will be not available)
-activateRetranslator [Serial] online activation of retranslator (enframe Serials with single quotes and separate them with ‘;’. For example: -activateRetranslator ‘Serial1;Serial2’)
-noautoupdate forced restriction of auto updates for the server part
-serverport [PortNumber] set server port
-setpassword [Password] set server password
-savepassword [1/0] allow password saving on client side
-reindexingArchive reindex archive and exit
-nolog disable log for server events
-fullscreen run Xeoma in fullscreen mode
-sslconnection [0/1/2] if 0 on the client – connect to server ignoring certificates; if 1 on the server – accept only secure connections from clients (to do that, generate and place the certificates into the Server and Client folders. See Xeoma folder > Security > Certificate > Readme.txt for details); if 2 on server or client – auto-detect certificates
-arducam enable using ArduCAM
-compressdb compress archive database
-uselocaltime use local time instead of UTC
-webaddr [WebAddr] change all addresses to specified

Note: for -activateOnline if you want to use “;” instead of “,” as a delimiter, please put serials into ‘ ‘. For example: ./xeoma -activateOnline ‘LKB6CWP10WBPVW5KFGRЕ226UV;NK5XWLJUVММ9TММХСХDLV24E6’

Here are some additional commands you could take advantage of:

-setpassword MYPASS (set MYPASS or another password for Administrator profile, the password that is used for remote access)

-serverport 777 (set 777 as Xeoma port instead of the default 8090, can be any number). Attention: doesn’t work for servers installed to autostart. If you need Xeoma to always work on another port constantly, you will need to edit the autostart script manually:

for Linux: /etc/init.d/XeomaCoreService
for Mac: /Library/LaunchDaemons/XeomaCoreService.plist
for Windows: in the settings of services (Administrative Tools) or via the Registry (HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\services\XeomaCoreService)
Edit it with admin rights. Restart the server part thereafter.

-noscan (cancel initial search for cameras). Attention: doesn’t work for servers installed to autostart. See -serverport to learn how to make it work.

For a detailed instruction on how to work with Xeoma on Linux (with or without graphical shell), please see this article (troubleshooting included).

Changing camera layouts via configuration file

Starting from Xeoma 14.5.13, layouts can be controlled without the visual part via configuration file. For example, when integrated to your home automation system, it will help you choose camera layouts switch between live camera previews simply by pressing a button on a remote controller.

Changes should be applied to the Preview configuration file in Preview configuration folder in Xeoma’s directory:

# Use PreviewMode variable for setting preview mode, TabNumber for setting tab number.
# PreviewMode possible values are:
# 0 for all cameras
# 1 for 1×1
# 2 for 2×1
# 3 for 2×2
# 4 for 3×2
# 5 for 3×3
# 6 for 4×3
# 7 for 4×4
# 8 for 5×4
# 9 for 5×5
# 10 for 8×8
PreviewMode=0
TabNumber=0

Replace 0 in PreviewMode=0 with 1 to enable the 1х1 layout (one camera on screen at a time), with 2 to enable the 2х1 layout, etc. Replace 0 in TabNumber=0 with the number of a tab you’d like to open. Please note: Xeoma should be launched and working when you apply those changes.

for Linux, Mac OS, Android, and Windows will help you change default port and password, and cancel automated search for cameras.