├── telkam ├── LICENSE └── README.md /telkam: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/OpenIPC/telkam/master/telkam -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | MIT License 2 | 3 | Copyright (c) 2024 OpenIPC 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy 6 | of this software and associated documentation files (the "Software"), to deal 7 | in the Software without restriction, including without limitation the rights 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 9 | copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in all 13 | copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 21 | SOFTWARE. 22 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | ## telkam 2 | 3 | 4 | ### General description (purpose) 5 | 6 | The **telkam** is an intellectual demon that turns your Chinese IP camera into a "gadget" or "detector" - a device that 7 | detects motion in the frame and transmits photos and short video clips to the messenger Telegram on alarm or request. 8 | 9 | It is important to note that this is not a streamer in the "classical sense", it does not transfer video stream to a 10 | server/client in a constant mode, as in conventional IP-cameras. 11 | 12 | Supported hardware at the moment a two camera modules from XM (XiongMai), pinout fully corresponds: 13 | - IVG-G3S Goke GK7205v210 SoC + Sony IMX307 sensor + 16 MB NOR flash, original firmware [000739AG](https://download.xm030.cn/d/MDAwMDE2NDU=) 14 | - IVG-G41 Goke GK7205v210 SoC + SC5239S sensor + 16M MB NOR flash, original firmware [000659QA](https://download.xm030.cn/d/MDAwMDE2NTc=) 15 | 16 | 17 | ### Features 18 | 19 | - Simplicity: all the functionality of the device is implemented out of the box, namely automatic day/night transition, 20 | operation with two types of backlighting (infrared and visible spectrum), configuration through a simple (minimalistic) 21 | and intuitive web interface (no need to use a terminal or command line). 22 | 23 | - Improved motion detection algorithm (based on the analysis of the intersection of given lines by an object), instead 24 | of the simple detection algorithm "light change" (changes in pixel brightness), which is a common implementation on 25 | stock firmware. 26 | 27 | - Video is transmitted to Telegram in short clips (~10s) only on demand or alarm, not in a continuous (constant) stream. 28 | In this regard, the device can work on "expensive" and relatively "slow" mobile Internet, consuming Internet traffic 29 | insignificantly. There is also no need for a dedicated server (cloud) to operate the device. 30 | 31 | - Several users can connect to the detector in the Telegram at the same time. 32 | 33 | - All video/photo information is stored in the device's RAM, so there is no need to connect an SD card and replace it 34 | periodically due to "wear and tear". 35 | 36 | - The “relay" and "alarm" outputs are organized, controlled from the telegram-bot, to which you can "hang actuators". 37 | 38 | - There are two endpoints and to get snapshots and video respectively: 39 | - `http://root:@/image.jpg` 40 | - `rtsp://root:@/stream=0` 41 | 42 | 43 | - The program can be installed quite easily on the OpenIPC platform just a few commands 44 | --------------------------------------------------------------------------------