{"id":13581666,"url":"https://github.com/toxuin/alarmserver","last_synced_at":"2025-10-10T04:31:17.645Z","repository":{"id":39551372,"uuid":"336194741","full_name":"toxuin/alarmserver","owner":"toxuin","description":"IP Camera Alarm Server to MQTT","archived":false,"fork":false,"pushed_at":"2024-05-03T13:26:54.000Z","size":117,"stargazers_count":146,"open_issues_count":20,"forks_count":34,"subscribers_count":13,"default_branch":"master","last_synced_at":"2024-11-15T21:33:14.662Z","etag":null,"topics":["alarm-server","amcrest","camera","dahua","dvr","hikvision","hisilicon","home-assistant","home-automation","home-security","mqtt","node-red","security-camera","wansview","xmeye"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/toxuin.png","metadata":{"files":{"readme":"Readme.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["toxuin"]}},"created_at":"2021-02-05T07:17:54.000Z","updated_at":"2024-11-13T13:41:55.000Z","dependencies_parsed_at":"2024-11-05T21:33:17.747Z","dependency_job_id":"0d6d6cfd-817c-4d33-92a8-2a6ae46c9651","html_url":"https://github.com/toxuin/alarmserver","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toxuin%2Falarmserver","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toxuin%2Falarmserver/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toxuin%2Falarmserver/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toxuin%2Falarmserver/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/toxuin","download_url":"https://codeload.github.com/toxuin/alarmserver/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235917507,"owners_count":19065852,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["alarm-server","amcrest","camera","dahua","dvr","hikvision","hisilicon","home-assistant","home-automation","home-security","mqtt","node-red","security-camera","wansview","xmeye"],"created_at":"2024-08-01T15:02:09.892Z","updated_at":"2025-10-10T04:31:12.361Z","avatar_url":"https://github.com/toxuin.png","language":"Go","readme":"# IP Camera Alarm Server\n\n![docker pulls](https://img.shields.io/docker/pulls/toxuin/alarmserver)\n\nUniversal Alarm Server for all your IP cameras in one place!\n\nIntegrates well with Home Assistant, Node-Red, etc. Runs great on Raspberry-Pi!\n\nSupported Cameras 📸:\n  - Hikvision (Annke/Alarm.com/etc.)\n  - Dahua (Lorex/Amcrest/etc.)\n  - Hisilicon (any camera that uses XmEye)\n  - Any camera that can upload alarms to FTP\n\nSupported Delivery 📬:\n  - MQTT\n  - Webhooks\n\n## Configuration\n\nCreate file `config.yaml` in the folder where the application binary lives.\n\nAlso see [sample config](docs/config.yaml).\n\nWhen alarm server is coming online, it will also send a status message to `/camera-alerts` topic with its status.\n\n#### HiSilicon\n\nThis includes most of no-brand Chinese cameras that use XmEye app and have \"Alarm Server\" feature.\n\nIf your camera needs Internet Explorer to access its Web Interface ([here's a picture!](docs/hisilicon.jpg)) and would not work in any other browser - that's the server you need. These cameras are all made by HiSilicon and sold under hundreds of different names.\n\nLogs from the camera can also work as alarm - set that in your camera under \"send logs\" setting.\n\n```yaml\nhisilicon:\n  enabled: true  # if false, will not listen for alarms from hisilicon cams  \n  port: 15002    # has to be the same in cameras' settings\n```\n\n#### Dahua\n\nDahua is an OEM company that makes cameras for various popular brands. See the list of [OEM Dahua camera manufacturers](https://ipvm.com/reports/dahua-oem) to find if your cameras should be configured as Dahua in Alarm Server.\n\n```yaml\ndahua:\n  enabled: true              # if not enabled, it won't connect to any dahua cams\n  cams:\n    myCam:                   # name of your camera\n      address: 192.168.1.69  # ip address or domain name\n      username: admin        # username that you use to log in to camera's web panel \n      password: admin1234    # password that you use to log in to camera's web panel\n```\n\n#### Hikvision\n\nAlarm Server uses HTTP streaming to connect to each camera individually and subscribe to all the events.\n\nSome lower-end cameras, especially doorbells and intercoms, have broken HTTP streaming implementation that can't open more that 1 connection and \"close\" the http response, but leave TCP connection open (without sending keep-alive header!). For those, Alarm Server has an alternative streaming implementation. To use it, set `rawTcp: true` in camera's config file.\n\nHikvision cameras can also be used with FTP server no problem. \n\n```yaml\nhikvision:\n  enabled: true              # if not enabled, it won't connect to any hikvision cams\n  cams:\n    myCam:                   # name of your camera\n      address: 192.168.1.69  # ip address or domain name\n      https: false           # if your camera supports ONLY https - set to true\n      username: admin        # username that you use to log in to camera's web panel \n      password: admin1234    # password that you use to log in to camera's web panel\n      rawTcp: false          # some cams have broken streaming. Set to true if normal HTTP streaming doesn't work \n```\n\n#### FTP\n\nAlarm Server will accept any username as FTP login username and use it as camera's name. As long as the password matches, it will allow the connection.\n\n```yaml\nftp:\n  enabled: true      # if not enabled, it won't accept connections\n  port: 21           # has to match settings in the cameras\n  password: \"root\"   # FTP password that will be accepted\n  allowFiles: true   # if false, no files will be stored (but transfers will still happen)\n  rootPath: \"./ftp\"  # folder where to save cameras' uploads\n```\n\n_Q_: Isn't FTP, like, slow??\n\n_A_: No. Alarm processing part happens before the actual file upload even begins, and on your typical wireless home network that is less than 0.2 seconds. It's plenty fast.\n\n_Q_: Why this if there is ONVIF?\n\n_A_: Some IP cameras have ONVIF, and sometimes that even includes motion alarms, but not always does that mean that the Human Detection alarm is exposed through ONVIF, as well as all the other alarms like \"SD card dead\" or \"failed admin login\". This and, well, not all the cameras support ONVIF.\n\n## Tested cameras:\n\n- 3xLogic VX-2M-2D-RIA (Hikvision server)\n\n- Uniden U-Bell DB1 (also known as Hikvision DS-KB6003, LaView LV-PDB1630-U and RCA HSDB2A)\n\n- Misecu 5MP Wifi AI Cam (Hisilicon server)\n\n- Lorex N8428-Z 4K NVR (Dahua server)\n\n- Hiseeu HB613-P 3 MP (Hisilicon server, tested by [abratchik](https://github.com/abratchik))\n\n- HomeViz OB10, K4W10, OW10 (Hisilicon server, tested by [acburnett](https://github.com/acburnett))\n\nIf your camera works with Alarm Server - create an issue with some details about it and a picture, and we'll post it here. \n\n## Docker\n\nThere is a pre-built image `toxuin/alarmserver`. It is a multi-architecture image and will work both on Intel/AMD machines, and your Raspberry PI too.\n\nUsage: `docker run -d -v $PWD/config.yml:/config.yml -v $PWD/ftp:/ftp -p 21:21 -p 15002:15002 toxuin/alarmserver`\n\nExplanation:\n\n  - `-d` makes it run in the background, so you don't have to stare at its logs for it to keep running\n\n  - `-v $PWD/config.yml:/config.yml` passes through your config from your machine into the container. Make sure the file exists.\n\n  - `-v $PWD/ftp:/ftp` passes through a folder `ftp` from where you're running this command into the container. Not needed if you don't need FTP.\n\n  - `-p 21:21` allows your machine to pass through port 21 that is used for FTP server. Not needed if you're not using FTP server.\n\n  - `-p 15002:15002` same as above, but for port 15002 that's used by HiSilicon alarms server. Not needed if you don't need HiSilicon server.\n\n## Feedback\n\nThis project was created for author's personal use and while it will probably work for you too, author has no idea if you use it the same way as author. To fit everyone's usage scenario better, it would be beneficial if you could describe how YOU use the Alarm Server.\n\nIf you just started to use Alarm Server in your network (or use it for long time!), if you like it (or hate it!) - feel free to create an issue and just share how it works for you and what cameras you have. I would be curious to know if it fits your use case well (or not at all!).\n\nIf you have any feature suggestions - create an issue, and we'll probably figure something out.\n\n## License\n\nMIT License\n","funding_links":["https://github.com/sponsors/toxuin"],"categories":["Go"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftoxuin%2Falarmserver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftoxuin%2Falarmserver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftoxuin%2Falarmserver/lists"}