Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/arunishrajput/motion-detection
Motion Detection using OpenCV and Send Response using Telegram Bot API
https://github.com/arunishrajput/motion-detection
motion-detection opencv python telegram-bot-api
Last synced: about 1 month ago
JSON representation
Motion Detection using OpenCV and Send Response using Telegram Bot API
- Host: GitHub
- URL: https://github.com/arunishrajput/motion-detection
- Owner: arunishrajput
- Created: 2024-06-28T06:03:34.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2024-06-28T06:09:07.000Z (8 months ago)
- Last Synced: 2024-11-14T21:06:33.276Z (3 months ago)
- Topics: motion-detection, opencv, python, telegram-bot-api
- Language: Python
- Homepage:
- Size: 2.93 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Motion Detection with OpenCV and Telegram Notifications
This project detects motion using OpenCV in Python and sends notifications with photos to a Telegram chat.
## Features
- Motion detection using `OpenCV` and background subtraction.
- Integration with `Telegram Bot API` for notifications.
- Adjustable parameters for motion sensitivity and cooldown periods.
## Requirements
- Python 3.6 or higher
- Requests library (for sending HTTP requests)
- Telegram Bot API credentials (Bot Token and Chat ID)
## Installation
1. **Clone the repository:**
```bash
git clone https://github.com/arunishrajput/motion-detection.git
cd motion-detection
```
2. **Install dependencies:**
```bash
pip install -r requirements.txt
```
Or install the libraries manually:
```bash
pip install opencv-python requests
```
3. **Setup Telegram Bot:**
- Create a Telegram bot using [BotFather](https://t.me/BotFather) and note down the `Bot Token`.
- Obtain your `Telegram Chat ID` using [userinfobot](https://t.me/userinfobot).
4. **Configuration:**
- Replace placeholders in the script (`TELEGRAM_CHAT_ID` and `TELEGRAM_BOT_TOKEN`) with your actual Telegram credentials.
## Usage
1. **Run the Script:**
```bash
python main.py
```
2. **Motion Detection:**
- Adjust `camera` variable (0 for default camera) or specify a video file path.
- Customize `initial_delay_seconds`, `motion_cooldown_seconds`, and `threshold` as per your requirements.
3. **Exit:**
- Press Esc key to exit the application.
## Functionality
- **Captures frames from the camera or video file.**
- **Defines a smaller square area in the frame for motion detection.**
- **Sends a Telegram notification with a photo when motion is detected.**
- **Uses background subtraction and contour detection for motion identification.**
## Troubleshooting
- Ensure Python environment and dependencies are correctly installed.
- Verify Telegram credentials and network connectivity for sending notifications.
## Contribution
- Feel free to fork this repository, create a feature branch, and submit a pull request. Contributions, issues, and feature requests are welcome!
## Acknowledgments
- [OpenCV](https://opencv.org/)
- [Telegram API Documentation](https://core.telegram.org/bots/api)