Skip to content
TelegramBot per CCTV
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
resources
.gitignore
LICENSE
MyIPCameraBot.py
MyIPCameraBot_config.example
README.md

README.md

MyIPCameraBot

Si tratta di un semplice gestore per un BOT di Telegram che interagisce con le camere IP (ad esempio quelle di un sistema di videosorveglianza casalingo) e preleva le loro immagini .jpg da una cartella sul file system locale inviandole quindi ad uno o più account Telegram. Le immagini vengono spedite in chat man mano che vengono create sul file system: il modulo whatchdog è infatti in ascolto su una cartella locale. Mentre il modulo telepot si occupa di gestire il BOT. In questo modo è possibile farsi spedire le immagini di una camera, magari acquisita a valle di un movimento o di un rumore, direttamente su una chat dedicata su Telegram.

Potete scaricare l'ultima release dello script da qui.

![un esempio di architettura per l'utilizzo dello script](https://github.com/alexscarcella/MyIPCameraBot/blob/master/resources/MyIPCameraBot.png?raw=true "un esempio di architettura per l'utilizzo dello script" {width=354px height=754px})

In questo modo è possibile farsi spedire le immagini di una camera, magari acquisita a valle di un movimento o di un rumore, direttamente su una chat dedicata su Telegram.

Comandi del bot

  • /help: elenco comandi (questo!)
  • /jpg: ti invio le immagini JPG di tutte le camere
  • /motion: imposto il motion detection
  • /night: imposto la modalita' nottuna (infrarosso)
  • /status: ti dico come sto

alt text alt text alt text

Dipendenze

Per far funzionare correttamente lo script del bot è necessario installare alcuni moduli Python aggiuntivi:

  • telepot: Python framework for Telegram Bot API - v10.2
  • watchdog: Filesystem events monitoring. Python API and shell utilities to monitor file system events - v0.8.3
  • requests: Non-GMO HTTP library for Python, safe for human consumption - v2.12.3
  • Pillow: Pillow is the friendly PIL fork by Alex Clark and Contributors. PIL is the Python Imaging Library by Fredrik Lundh and Contributors.

Potete installare i moduli usando pip.

$ sudo pip install watchdog

$ sudo pip install telepot

$ sudo pip install requests

$ sudo pip install Pillow

Se volete aggiornare i moduli esistenti, usate il comando sudo pip install <module> --upgrade. Verificate comunque la compatibilità delle versioni. Per maggiori informazioni visitate il blog CCWorld.it.

MyIPCameraBot_config.py

E' necessario creare il file di configurazione MyIPCameraBot_config.py da mettere nella stessa cartella dello script python. Potete editare e rinominare il file di esempio MyIPCameraBot_config.example: si tratta ancora di un files di configurazione grossolano (di fatto è un file python, quindi attenti alla sintassi).

Il file è diviso in tre differenti sezioni:

  • BASIC CONFIGURATION: qui ci sono i valori di configurazione base dello script. Tra cui il Token segreto di Telegram, o la cartella sul file system locale da cui prelevare le immagini.
  • CHAT USER: qui vengono definiti gli utenti con cui il Bot è abilitato ad interagire. Al momento, e vista la natura dell'applicazione, non è prevista una procedura di sottoscrizione.
  • CAMERE CONFIGURATION: qui sono definite le camere con i loro parametri per al raggiungibilità nella rete locale. La cosa importante è conoscere le URL di configurazione di ogni vostro modello di camera. In genere tutte le camere IP prevedono delle API va HTTP (oppure sniffate il traccifo, come ho fatto io, e ricavate i parametri in POST).

Sia gli utenti che le camere sono definiti attraverso un Dictionary di Python: ricordatevi quindi di aggiungerli rispettivamente alle variabili users e camere. Ad esempio:

# fil#!/usr/bin/env python2.7
# -*- coding: utf-8 -*-

# -----------------------------------------------------------------------------
# ------------------- BASIC CONFIGURATION -------------------------------------
# -----------------------------------------------------------------------------

# inserite qui il Token segreto del BOT Telegram
TELEGRAM_BOT_TOKEN = "fffffffffffffffffffffffffffffffffff"

# path completo della cartella contenente le immagini (un esempio:)
IMAGES_PATH = "/Volumes/images/cctv"

# l'intervallo di tempo minimo (in secondi) che deve trascorrere da un messaggio ed il successivo
# the minimum time interval (in seconds) that must pass from one message and the next
SEND_SECONDS = 5

# tempo necessario all'invio delle immagini di tutte le camere prima del time-out
# time required to send images of all cameras before the time-out
SEND_ONDEMAND_TIMOUT = 8

# log file path (5 files in rotation)
LOG_FILENAME = '/Volumes/dati/alessandroscarcella/Dropbox/Documenti DropBox/Developer/PythonGIT/MyIPCameraBot/MyIPCameraBot.log'

# -----------------------------------------------------------------------------
# ------------------- CHAT USERS ----------------------------------------------
# -----------------------------------------------------------------------------

# user 01
user01 = dict()
user01['name'] = 'Mario'
user01['telegram_id'] = '111111111'
user01['push'] = True

# user 02
user02 = dict()
user02['name'] = 'Alice'
user02['telegram_id'] = '22222222'
user02['push'] = False

users = (user01, user02)

# -----------------------------------------------------------------------------
# ------------------- CAMERAS CONFIGURATION -----------------------------------
# -----------------------------------------------------------------------------

# camera 01
camera01 = dict()
camera01['id'] = 'ingresso'
camera01['model'] = 'D-Link DCS-932LB'
camera01['ip'] = '127.0.0.2'
camera01['port'] = '80'
camera01['user'] = 'user'
camera01['pwd'] = 'pwd'
camera01['url_jpg'] = '/image/jpeg.cgi'
camera01['url_motion_detection'] = '/motion.cgi?MotionDetectionEnable={0}&ConfigReboot=no'
camera01['url_night_mode'] = '/daynight.cgi?DayNightMode={0}&ConfigReboot=0'

# camera 02
camera02 = dict()
camera02['id'] = 'garage'
camera02['model'] = 'D-Link DCS-932LB'
camera02['ip'] = '127.0.0.3'
camera02['port'] = '80'
camera02['user'] = 'user'
camera02['pwd'] = 'pwd'
camera02['url_jpg'] = '/image/jpeg.cgi'
camera02['url_motion_detection'] = '/motion.cgi?MotionDetectionEnable={0}&ConfigReboot=no'
camera02['url_night_mode'] = '/daynight.cgi?DayNightMode={0}&ConfigReboot=0'

camere = (camera01, camera02)

E' possibile usare come modello il file MyIPCameraBot_config.example (da editare e rinominare). Nel caso in cui si volesse inviare i messaggi ad un solo utente, è possibile configurare la sezione users nel seguente modo:

# user 01
user01 = dict()
user01['name'] = 'Mario'
user01['telegram_id'] = '111111111'
user01['push'] = True

users = (user01, None)

Il dictionary users deve avere almeno due elementi, per cui è necessario inserire un utente fittizio nullo (None).

Configurazione come servizio

Se volete far girare MyIPCameraBot come un servizio in background potete creare un file UNIT. Seguite le seguenti istruzioni:

Create il nuovo file MyIPCameraBot.service nella cartella /lib/systemd/system/ (potete usare l'editor nano) Inserite le seguenti righe:

[Unit]
Description=MyIPCameraBot CCTV Service
After=multi-user.target

[Service]
Type=idle
ExecStart=/usr/bin/python /home/pi/Documents/MyIPCameraBot.py # sostituite con il percorso corretto

[Install]
WantedBy=multi-user.target

Sostituite il percorso dello script python dell'esempio in alto con il percorso corretto Salvate il file, chiudete l'editor di testo. Assegnate i necessari diritti di esecuzione al file tramite il comando:

sudo chmod 644 /lib/systemd/system/MyIPCameraBot.service

Per far partire il servizio al boot digitate (è sufficiente una sola volta):

sudo systemctl daemon-reload
sudo systemctl enable MyIPCameraBot.service
sudo reboot

Qualche comando utile per gestire il servizio (si faccia eventualmente riferimento alla documentazione della vostra distro Linux):

  • check status: sudo systemctl list-units -t service | grep MyIPCameraBot
  • start sudo systemctl start MyIPCameraBot.service
  • stop sudo systemctl stop MyIPCameraBot.service
  • reload config: sudo systemctl reload MyIPCameraBot.service
You can’t perform that action at this time.