ZoneMinder is a free, open source Closed-circuit television software application developed for Linux which supports IP, USB and Analog cameras. http://www.zoneminder.com/
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Isaac Connor 5f476df194 Fix invalid read when no mAudioStream 7 hours ago
.github CodeQL: Exclude dep/ from analysis 4 days ago
cmake build: Add base target for dependencies 5 days ago
conf.d populate ZM_PATH_SHUTDOWN 7 months ago
db WIP, rabbit hole too deep 1 day ago
dep dep/jwt-cpp: Update to version 0.5 3 days ago
distros Bump version to 1.35.20 to pick up SecondPath db change 1 day ago
docs Use more modern way of including style sheet. Hopefully fixes deprecated add_stylesheet 3 weeks ago
fonts Build: Reindent the CMakeLists 4 weeks ago
icons/16x16 add an icon made from favicon.ico and a .desktop file to be install in /usr/share/applications/ 4 years ago
misc Build: Reindent the CMakeLists 4 weeks ago
onvif Build: Reindent the CMakeLists 4 weeks ago
scripts Add audio_frequency and audio_channels to shared mem 3 days ago
src Fix invalid read when no mAudioStream 7 hours ago
tests Build: Link our libs and executable targets against zm-core-interface 3 weeks ago
utils Add groovy and hirsute to ubuntu builds 3 weeks ago
web Instead of fatal error triggering, turn off file logging and log the error elsewhere 1 day ago
.cirrus.yml CI: Use Cirrus CI for FreeBSD builds 5 days ago
.dockerignore Revert "add recipes to detect libv4l2" 4 years ago
.eslintignore allow libavresample-dev 2 years ago
.eslintrc.js enable EcmaScript 6 to allow for-of loops 7 months ago
.git-blame-ignore-revs git: Add .git-blame-ignore-revs file and add previous CMake cleanup commit to it 4 weeks ago
.gitignore Drop relicts of zma 3 weeks ago
.gitmodules Revert to FriendsOfCake instead of our fork, as they have merged our patch. 4 months ago
.travis.yml Debian builds have been moved to dedicated build host 2 months ago
CHANGELOG.md spelling fixes 4 years ago
CMakeLists.txt Move in-tree dependencies to their own folder 5 days ago
CONTRIBUTING.md Create CONTRIBUTING.md 6 years ago
COPYING update gpl 2 statement 4 years ago
LICENSE Copied COPYING to LICENSE 8 years ago
README.md Update README.md 5 days ago
SECURITY.md Create SECURITY.md 10 months ago
cmakecacheimport.sh Support SSL for mysql connections (#1965) 4 years ago
code_of_conduct.md set email address to send complaints to 4 years ago
version Bump version to 1.35.20 to pick up SecondPath db change 1 day ago
zm.conf.in Support SSL for mysql connections (#1965) 4 years ago
zmconfgen.pl.in code style cleanup. A new feature is that if ->processes == 'web' we won't include it in the c++ header defines. We can use this to shrink ram use and startup time of c++ processes a bit 6 months ago
zmlinkcontent.sh.in Honor conf.d (zmlinkcontent.sh) 4 months ago
zoneminder-config.cmake Add HAVE_RTSP_SERVER 3 months ago

README.md

ZoneMinder

Build Status Bounty Source Join Slack IRC Network

All documentation for ZoneMinder is now online at https://zoneminder.readthedocs.org

Overview

ZoneMinder is an integrated set of applications which provide a complete surveillance solution allowing capture, analysis, recording and monitoring of any CCTV or security cameras attached to a Linux based machine. It is designed to run on distributions which support the Video For Linux (V4L) interface and has been tested with video cameras attached to BTTV cards, various USB cameras and also supports most IP network cameras.

Contacting the Development Team

Before creating an issue in our github forum, please read our posting rules: https://github.com/ZoneMinder/ZoneMinder/wiki/Github-Posting-Rules

Our Dockerfile has moved

Please file issues against the ZoneMinder Dockerfile here: https://github.com/ZoneMinder/zmdockerfiles

Installation Methods

Install from a Package Repository

This is the recommended method to install ZoneMinder onto your system. ZoneMinder packages are maintained for the following distros:

If a repository that hosts ZoneMinder packages is not available for your distro, then you are encouraged to build your own package, rather than build from source. While each distro is different in ways that set it apart from all the others, they are often similar enough to allow you to adapt another distro's package building instructions to your own.

Building from Source is Discouraged

Historically, installing ZoneMinder onto your system required building from source code by issuing the traditional configure, make, make install commands. To get ZoneMinder to build, all of its dependencies had to be determined and installed beforehand. Init and logrotate scripts had to be manually copied into place following the build. Optional packages such as jscalendar and Cambozola had to be manually installed. Uninstalls could leave stale files around, which could cause problems during an upgrade. Speaking of upgrades, when it comes time to upgrade all these manual steps must be repeated again.

Better methods exist today that do much of this for you. The current development team, along with other volunteers, have taken great strides in providing the resources necessary to avoid building from source.

Building a ZoneMinder Package

Building ZoneMinder into a package is not any harder than building from source. As a matter of fact, if you have successfully built ZoneMinder from source in the past, then you may find these steps to be easier.

When building a package, it is best to do this work in a separate environment, dedicated to development purposes. This could be as simple as creating a virtual machine, using Docker, or using mock. All it takes is one “Oops” to regret doing this work on your production server.

Lastly, if you desire to build a development snapshot from the master branch, it is recommended you first build your package using an official release of ZoneMinder. This will help identify whether any problems you may encounter are caused by the build process or is a new issue in the master branch.

Please visit our ReadtheDocs site for distro specific instructions.

Package Maintainers

Many of the ZoneMinder configuration variable default values are not configurable at build time through autotools or cmake. A new tool called zmeditconfigdata.sh has been added to allow package maintainers to manipulate any variable stored in ConfigData.pm without patching the source.

For example, let's say I have created a new ZoneMinder package that contains the cambozola javascript file. However, by default cambozola support is turned off. To fix that, add this to the packaging script:

./utils/zmeditconfigdata.sh ZM_OPT_CAMBOZOLA yes

Note that zmeditconfigdata.sh is intended to be called, from the root build folder, prior to running cmake or configure.

Docker

Docker is a system to run applications inside isolated containers. ZoneMinder, and the ZM webserver, will run using the Dockerfile contained in this repository. However, there is still work needed to ensure that the main ZM features work properly and are documented.

Contribution Model and Development

Pull requests are very welcome! If you would like to contribute, please follow the following steps. While step 3 is optional, it is preferred.

  1. Fork the repo
  2. Open an issue at our GitHub Issues Tracker. Follow the issue template to describe the bug or security issue you found. Please note feature requests or questions should be posted in our user forum or Slack channel.
  3. Create your feature branch (git checkout -b 456-my-new-feature)
  4. Commit your changes (git commit -am 'Added some feature') It is preferred that you 'commit early and often' instead of bunching all changes into a single commit.
  5. Push your branch to your fork on github (git push origin 456-my-new-feature)
  6. Create new Pull Request
  7. The team will then review, discuss and hopefully merge your changes.

Analytics