Package: vsmstreamer
Cisco Video Surveillance Manager Streamervsmstreameris a Python utility to stream Cisco Video Surveillance Manager
streams on macOS.RequirementsThis utility requires the following software:macOS (tested using 18.0.0, Mojave)Python 2.7 or 3 (tested using 2.7.15, and 3.7)VLC media player Nightly Build(tested using vlc-3.0.5-20181022-0636)Note:Due to a bug in VLC 3.0.4, you MUST use a nightly build of 3.0.5.
Otherwise, the stream will stop after 120 second. For more information readthis thread.These are the Python modules that the utility depends on:configparserrequestsPyCocoapython-vlcHowever, you need not install these packages by hand. Installingvsmstreamerthroughpipwill automatically install these packages.InstallationFrom PyPIThe latest released version ofvsmstreamercan be installed fromPyPI.pip install vsmstreamerPS: Run withsudolikesudo pip install vsmstreamerif necessary.From SourceThe latest development version ofvstreamercan be installed from source.git clone https://github.com/kprav33n/vsmstreamer.git
pip install -e ./vsmstreamerUsagevsmstreameris a command line utility. The following summarizes list of
options available.$ vsmstreamer --help
usage: vsmstreamer [-h] [--config CONFIG] [--profile PROFILE]
                   [--server SERVER] [--username USERNAME]
                   [--password PASSWORD] [--stream STREAM]

Cisco Video Surveillance Manager Streamer

optional arguments:
  -h, --help            show this help message and exit
  --config CONFIG, -c CONFIG
                        path to config file
  --profile PROFILE, -r PROFILE
                        profile name to use
  --server SERVER, -s SERVER
                        VSM server address
  --username USERNAME, -u USERNAME
                        VSM username
  --password PASSWORD, -p PASSWORD
                        VSM password
  --stream STREAM, -n STREAM
                        stream index to displayIn order to stream from a Cisco Video Surveillance Manager, you would need the
following three parameters:server addressusernamepasswordCredentials FileThe above mentioned parameters can be stored in a credentials file. The default
path of the credentials file is~/.vsm/credentials. However, this path can be
overridden using the--configcommand line option. This file can contain one
are more sections. The section name is enclosed in a square bracket like this[default]. A desired section can be selected using the--profilecommand
line option. A sample credentials file looks like this:[default]
server = vsm.example.org
username = jsmith
password = $up3rsecretHowever, use of credentials file is optional. In the absence of the credentials
file, the command line options--server,--user, and--passwordcan be
used to specify the required parameters.Streamsvsmstreamerplays only one stream at a time. You can have many instances of
this utility running at the same time if you want to want multiple streams. By
default, this utility tunes to the first stream in the list of available
streams. However, you can use--streamcommand line option to specify the
stream index (0-indexed) to tune into.FeedbackIf you find a bug, or you would like to see a new feature, please feel free toopen an issue.