{"id":50518140,"url":"https://github.com/bobberdolle1/maixcam-wildtrap","last_synced_at":"2026-06-03T01:31:41.813Z","repository":{"id":357187894,"uuid":"1235738175","full_name":"bobberdolle1/maixcam-wildtrap","owner":"bobberdolle1","description":"🎯 AI-Powered Camera Trap for MaixCAM | Hybrid Motion+YOLOv8 Detection | Telegram Notifications | Wildlife Monitoring \u0026 Security | 4 Detection Modes | Night Vision | Auto Storage Management | Production Ready","archived":false,"fork":false,"pushed_at":"2026-05-11T17:35:02.000Z","size":197,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-05-11T19:25:21.057Z","etag":null,"topics":["ai","camera-trap","computer-vision","edge-ai","embedded-systems","iot","maixcam","maixpy","motion-detection","object-detection","opencv","python","security","telegram-bot","wildlife","yolov8"],"latest_commit_sha":null,"homepage":null,"language":"Python","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/bobberdolle1.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-11T15:54:28.000Z","updated_at":"2026-05-11T17:35:06.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/bobberdolle1/maixcam-wildtrap","commit_stats":null,"previous_names":["bobberdolle1/maixcam-wildtrap"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/bobberdolle1/maixcam-wildtrap","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bobberdolle1%2Fmaixcam-wildtrap","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bobberdolle1%2Fmaixcam-wildtrap/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bobberdolle1%2Fmaixcam-wildtrap/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bobberdolle1%2Fmaixcam-wildtrap/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bobberdolle1","download_url":"https://codeload.github.com/bobberdolle1/maixcam-wildtrap/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bobberdolle1%2Fmaixcam-wildtrap/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33844686,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-02T02:00:07.132Z","response_time":109,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["ai","camera-trap","computer-vision","edge-ai","embedded-systems","iot","maixcam","maixpy","motion-detection","object-detection","opencv","python","security","telegram-bot","wildlife","yolov8"],"created_at":"2026-06-03T01:31:40.330Z","updated_at":"2026-06-03T01:31:41.802Z","avatar_url":"https://github.com/bobberdolle1.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎯 MaixCAM WildTrap\n\n[![Release](https://img.shields.io/github/v/release/bobberdolle1/maixcam-wildtrap)](https://github.com/bobberdolle1/maixcam-wildtrap/releases)\n[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n[![Python](https://img.shields.io/badge/python-3.x-blue.svg)](https://www.python.org/)\n[![MaixPy](https://img.shields.io/badge/MaixPy-4.x-green.svg)](https://wiki.sipeed.com/maixpy)\n[![YOLOv8](https://img.shields.io/badge/YOLOv8-nano-orange.svg)](https://github.com/ultralytics/ultralytics)\n\n**AI-Powered Camera Trap for Wildlife Monitoring \u0026 Security**\n\nProduction-ready application for MaixCAM with automatic detection, capture, and notifications.\n\n[English](#english) | [Русский](#русский)\n\n---\n\n\u003ca name=\"english\"\u003e\u003c/a\u003e\n## 🇬🇧 English\n\n### Features\n\n#### Detection Modes\n- **Motion Detection** - Energy-efficient frame differencing\n- **AI Detection** - YOLOv8 object recognition (80 classes)\n- **Hybrid Mode** ⭐ - Motion trigger → AI verification (recommended)\n- **Scheduled Mode** - Timelapse capture at intervals\n\n#### Capture Modes\n- **Photo** - Single high-quality image\n- **Burst** - Series of 3/5/10 photos\n- **Video** - Record 5/10/15/30 second clips\n- **Timelapse** - Periodic capture during detection\n\n#### Smart Features\n- 🎯 **Object Filtering** - Target specific animals/people\n- 🤖 **Servo Control** - Trigger food dispensers or physical traps via PWM\n- 🖼️ **On-Device Gallery** - Browse and view captures directly on the touchscreen\n- 🚨 **External Trigger** - Support for secondary GPIO output (Light/Alarm)\n- 🌙 **Night Mode** - Automatic brightness/contrast enhancement\n- 📊 **Metadata Logging** - JSON + CSV detection history\n- 🔔 **Notifications** - Telegram Bot + HTTP Webhook\n- 💾 **Auto-Cleanup** - Manage storage limits automatically\n- ⚡ **Energy Saving** - Optimized detection pipeline\n- 📱 **Touchscreen UI** - 3-page settings menu and OSD (supports 552x368)\n\n---\n\n### Quick Start\n\n#### 1. Installation\n\n```bash\n# Download release\nwget https://github.com/bobberdolle1/maixcam-wildtrap/releases/download/v1.6.0/maixcam-wildtrap-v1.6.0.zip\nunzip maixcam-wildtrap-v1.6.0.zip\n\n# Copy files to MaixCAM\nscp src/* root@\u003cMAIXCAM_IP\u003e:/root/\n```\n# SSH into MaixCAM\nssh root@\u003cMAIXCAM_IP\u003e\n\n# Create directories\nmkdir -p /root/wildtrap/{captures,logs,temp}\n```\n\n#### 2. Configuration\n\nEdit `src/wildtrap_config.json`:\n\n```json\n{\n  \"detection_mode\": \"hybrid\",\n  \"capture_mode\": \"burst\",\n  \"target_objects\": [\"dog\", \"cat\", \"bird\", \"person\"],\n  \"confidence_threshold\": 0.6,\n  \"cooldown_seconds\": 30,\n  \"telegram_enabled\": true,\n  \"telegram_bot_token\": \"YOUR_BOT_TOKEN\",\n  \"telegram_chat_id\": \"YOUR_CHAT_ID\",\n  \"armed\": true\n}\n```\n\n#### 3. Run\n\n```bash\npython3 src/wildtrap_app.py\n```\n\n**See [QUICKSTART.md](QUICKSTART.md) for detailed 5-minute setup guide.**\n\n---\n\n### Configuration Guide\n\n#### Detection Settings\n\n| Parameter | Values | Description |\n|-----------|--------|-------------|\n| `detection_mode` | motion / ai / hybrid / scheduled | Detection method |\n| `motion_sensitivity` | 20-100 | Motion detection threshold |\n| `confidence_threshold` | 0.3-0.9 | AI confidence minimum |\n| `min_object_size` | pixels | Filter small detections |\n| `cooldown_seconds` | seconds | Delay between captures |\n\n#### Target Objects\n\nAvailable COCO classes:\n- **Animals**: dog, cat, bird, horse, cow, sheep, bear, elephant, zebra, giraffe, deer\n- **People**: person\n- **Vehicles**: car, truck, motorcycle, bus\n\n#### Camera Settings\n\n| Parameter | Values | Description |\n|-----------|--------|-------------|\n| `camera_width` | 320/640/1280/1920 | Resolution width |\n| `camera_height` | 240/480/720/1080 | Resolution height |\n| `night_mode` | true/false | Auto brightness boost |\n| `jpeg_quality` | 1-100 | Compression quality |\n\n#### Telegram Notifications\n\n1. Create bot with [@BotFather](https://t.me/botfather)\n2. Get bot token\n3. Get your chat ID from [@userinfobot](https://t.me/userinfobot)\n4. Configure in `src/wildtrap_config.json`\n\n---\n\n### Example Configurations\n\n#### Wildlife Monitoring (Day)\n```json\n{\n  \"detection_mode\": \"hybrid\",\n  \"capture_mode\": \"burst\",\n  \"burst_count\": 5,\n  \"target_objects\": [\"dog\", \"cat\", \"bird\", \"deer\", \"bear\"],\n  \"confidence_threshold\": 0.7,\n  \"cooldown_seconds\": 60,\n  \"night_mode\": false\n}\n```\n\n#### Security Camera (24/7)\n```json\n{\n  \"detection_mode\": \"hybrid\",\n  \"capture_mode\": \"video\",\n  \"video_duration\": 15,\n  \"target_objects\": [\"person\", \"car\"],\n  \"confidence_threshold\": 0.8,\n  \"cooldown_seconds\": 30,\n  \"night_mode\": true\n}\n```\n\n#### Bird Watching\n```json\n{\n  \"detection_mode\": \"ai\",\n  \"capture_mode\": \"burst\",\n  \"burst_count\": 10,\n  \"target_objects\": [\"bird\"],\n  \"confidence_threshold\": 0.6,\n  \"cooldown_seconds\": 10\n}\n```\n\n**See [EXAMPLES.md](EXAMPLES.md) for 8 complete real-world configurations.**\n\n---\n\n### File Structure\n\n```\n/root/wildtrap/\n├── src/                  # Application source code\n│   ├── wildtrap_app.py   # Main application\n│   ├── wildtrap_config.json # Configuration\n│   └── simple_wildtrap.py # Educational version\n├── docs/                 # Documentation files\n├── captures/             # Saved photos/videos\n│   ├── 20260510_143022_dog_0.87.jpg\n│   └── ...\n└── logs/\n    └── detections.csv    # Detection history\n```\n\n---\n\n### Documentation\n\n- **[docs/START_HERE.md](docs/START_HERE.md)** - Navigation guide\n- **[docs/QUICKSTART.md](docs/QUICKSTART.md)** - 5-minute setup\n- **[docs/EXAMPLES.md](docs/EXAMPLES.md)** - 8 real-world configurations\n- **[docs/PROJECT_INFO.md](docs/PROJECT_INFO.md)** - Technical architecture\n- **[docs/CHANGELOG.md](docs/CHANGELOG.md)** - Version history\n\n---\n\n### Performance\n\n| Mode | FPS | Power | Accuracy |\n|------|-----|-------|----------|\n| Motion | ~30 | Low | Medium |\n| AI | ~20 | High | High |\n| Hybrid | ~25 | Medium | High |\n| Scheduled | Variable | Very Low | N/A |\n\n---\n\n### Troubleshooting\n\n#### Camera Not Initializing\n```bash\nls /dev/video*\nsystemctl restart camera\n```\n\n#### AI Model Not Found\n```bash\ncd /root/models\nwget https://github.com/sipeed/MaixPy/releases/download/v4.0.0/yolov8n.mud\n```\n\n#### No Detections\n- Check `\"armed\": true` in config\n- Lower `confidence_threshold` to 0.5\n- Verify `target_objects` includes what you're testing\n- Check lighting conditions\n\n---\n\n### Contributing\n\nContributions welcome! Please:\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Submit a pull request\n\nSee [PROJECT_INFO.md](PROJECT_INFO.md) for architecture details.\n\n---\n\n### License\n\nMIT License - Free for personal and commercial use. See [LICENSE](LICENSE) for details.\n\n---\n\n### Support\n\n- **Issues**: [GitHub Issues](https://github.com/bobberdolle1/maixcam-wildtrap/issues)\n- **MaixPy Docs**: https://wiki.sipeed.com/maixpy\n- **Community**: https://maixhub.com\n\n---\n\n### Credits\n\nBuilt with:\n- [MaixPy](https://github.com/sipeed/MaixPy) - Python framework for MaixCAM\n- [YOLOv8](https://github.com/ultralytics/ultralytics) - Object detection\n- MaixCAM by [Sipeed](https://www.sipeed.com/)\n\n---\n\n\u003ca name=\"русский\"\u003e\u003c/a\u003e\n## 🇷🇺 Русский\n\n### Возможности\n\n#### Режимы детекции\n- **Motion Detection** - Энергоэффективное определение движения\n- **AI Detection** - Распознавание объектов YOLOv8 (80 классов)\n- **Hybrid Mode** ⭐ - Движение → AI проверка (рекомендуется)\n- **Scheduled Mode** - Таймлапс съемка по расписанию\n\n#### Режимы съемки\n- **Photo** - Одиночное фото высокого качества\n- **Burst** - Серия из 3/5/10 фотографий\n- **Video** - Запись видео 5/10/15/30 секунд\n- **Timelapse** - Периодическая съемка при детекции\n\n#### Умные функции\n- 🎯 **Фильтрация объектов** - Выбор конкретных животных/людей\n- 🤖 **Управление сервоприводом** - Управление ловушками или кормушками через PWM\n- 🖼️ **Галерея на устройстве** - Просмотр снимков прямо на сенсорном экране\n- 🚨 **Внешний триггер** - Поддержка GPIO выхода для света или сирены\n- 🌙 **Ночной режим** - Автоматическое улучшение яркости/контраста\n- 📊 **Логирование метаданных** - JSON + CSV история детекций\n- 🔔 **Уведомления** - Telegram Bot + HTTP Webhook\n- 💾 **Авто-очистка** - Автоматическое управление хранилищем\n- ⚡ **Энергосбережение** - Оптимизированный pipeline детекции\n- 📱 **Сенсорный UI** - Меню из 3-х страниц и OSD (поддерживает 552x368)\n\n---\n\n### Быстрый старт\n\n#### 1. Установка\n\n```bash\n# Скачать релиз\nwget https://github.com/bobberdolle1/maixcam-wildtrap/releases/download/v1.6.0/maixcam-wildtrap-v1.6.0.zip\nunzip maixcam-wildtrap-v1.6.0.zip\n\n# Копировать файлы на MaixCAM\nscp src/* root@\u003cIP_MAIXCAM\u003e:/root/\n```\n# Подключиться по SSH\nssh root@\u003cIP_MAIXCAM\u003e\n\n# Создать директории\nmkdir -p /root/wildtrap/{captures,logs,temp}\n```\n\n#### 2. Настройка\n\nРедактировать `src/wildtrap_config.json`:\n\n```json\n{\n  \"detection_mode\": \"hybrid\",\n  \"capture_mode\": \"burst\",\n  \"target_objects\": [\"dog\", \"cat\", \"bird\", \"person\"],\n  \"confidence_threshold\": 0.6,\n  \"cooldown_seconds\": 30,\n  \"telegram_enabled\": true,\n  \"telegram_bot_token\": \"ВАШ_ТОКЕН_БОТА\",\n  \"telegram_chat_id\": \"ВАШ_CHAT_ID\",\n  \"armed\": true\n}\n```\n\n#### 3. Запуск\n\n```bash\npython3 src/wildtrap_app.py\n```\n\n**См. [QUICKSTART.md](QUICKSTART.md) для подробной инструкции за 5 минут.**\n\n---\n\n### Руководство по настройке\n\n#### Параметры детекции\n\n| Параметр | Значения | Описание |\n|----------|----------|----------|\n| `detection_mode` | motion / ai / hybrid / scheduled | Метод детекции |\n| `motion_sensitivity` | 20-100 | Порог чувствительности движения |\n| `confidence_threshold` | 0.3-0.9 | Минимальная уверенность AI |\n| `min_object_size` | пиксели | Фильтр мелких объектов |\n| `cooldown_seconds` | секунды | Задержка между съемками |\n\n#### Целевые объекты\n\nДоступные COCO классы:\n- **Животные**: dog, cat, bird, horse, cow, sheep, bear, elephant, zebra, giraffe, deer\n- **Люди**: person\n- **Транспорт**: car, truck, motorcycle, bus\n\n#### Настройки камеры\n\n| Параметр | Значения | Описание |\n|----------|----------|----------|\n| `camera_width` | 320/640/1280/1920 | Ширина разрешения |\n| `camera_height` | 240/480/720/1080 | Высота разрешения |\n| `night_mode` | true/false | Авто-усиление яркости |\n| `jpeg_quality` | 1-100 | Качество сжатия |\n\n#### Уведомления Telegram\n\n1. Создать бота через [@BotFather](https://t.me/botfather)\n2. Получить токен бота\n3. Узнать свой chat ID через [@userinfobot](https://t.me/userinfobot)\n4. Настроить в `src/wildtrap_config.json`\n\n---\n\n### Примеры конфигураций\n\n#### Мониторинг дикой природы (день)\n```json\n{\n  \"detection_mode\": \"hybrid\",\n  \"capture_mode\": \"burst\",\n  \"burst_count\": 5,\n  \"target_objects\": [\"dog\", \"cat\", \"bird\", \"deer\", \"bear\"],\n  \"confidence_threshold\": 0.7,\n  \"cooldown_seconds\": 60,\n  \"night_mode\": false\n}\n```\n\n#### Охранная камера (24/7)\n```json\n{\n  \"detection_mode\": \"hybrid\",\n  \"capture_mode\": \"video\",\n  \"video_duration\": 15,\n  \"target_objects\": [\"person\", \"car\"],\n  \"confidence_threshold\": 0.8,\n  \"cooldown_seconds\": 30,\n  \"night_mode\": true\n}\n```\n\n#### Наблюдение за птицами\n```json\n{\n  \"detection_mode\": \"ai\",\n  \"capture_mode\": \"burst\",\n  \"burst_count\": 10,\n  \"target_objects\": [\"bird\"],\n  \"confidence_threshold\": 0.6,\n  \"cooldown_seconds\": 10\n}\n```\n\n**См. [EXAMPLES.md](EXAMPLES.md) для 8 полных реальных конфигураций.**\n\n---\n\n### Структура файлов\n\n```\n/root/wildtrap/\n├── captures/              # Сохраненные фото/видео\n│   ├── 20260510_143022_dog_0.87.jpg\n│   ├── 20260510_143022_dog_0.87.json\n│   └── ...\n├── logs/\n│   └── detections.csv    # История детекций\n└── temp/                 # Временные файлы\n```\n\n---\n\n### Документация\n\n- **[START_HERE.md](START_HERE.md)** - Навигация по проекту\n- **[QUICKSTART.md](QUICKSTART.md)** - Установка за 5 минут\n- **[EXAMPLES.md](EXAMPLES.md)** - 8 реальных конфигураций\n- **[PROJECT_INFO.md](PROJECT_INFO.md)** - Техническая архитектура\n- **[CHANGELOG.md](CHANGELOG.md)** - История версий\n\n---\n\n### Производительность\n\n| Режим | FPS | Энергия | Точность |\n|-------|-----|---------|----------|\n| Motion | ~30 | Низкая | Средняя |\n| AI | ~20 | Высокая | Высокая |\n| Hybrid | ~25 | Средняя | Высокая |\n| Scheduled | Переменная | Очень низкая | N/A |\n\n---\n\n### Решение проблем\n\n#### Камера не инициализируется\n```bash\nls /dev/video*\nsystemctl restart camera\n```\n\n#### AI модель не найдена\n```bash\ncd /root/models\nwget https://github.com/sipeed/MaixPy/releases/download/v4.0.0/yolov8n.mud\n```\n\n#### Нет детекций\n- Проверить `\"armed\": true` в конфиге\n- Снизить `confidence_threshold` до 0.5\n- Проверить что `target_objects` включает тестируемый объект\n- Проверить условия освещения\n\n---\n\n### Участие в разработке\n\nПриветствуются вклады! Пожалуйста:\n1. Сделайте fork репозитория\n2. Создайте feature branch\n3. Внесите изменения\n4. Отправьте pull request\n\nСм. [PROJECT_INFO.md](PROJECT_INFO.md) для деталей архитектуры.\n\n---\n\n### Лицензия\n\nMIT License - Свободно для личного и коммерческого использования. См. [LICENSE](LICENSE) для деталей.\n\n---\n\n### Поддержка\n\n- **Issues**: [GitHub Issues](https://github.com/bobberdolle1/maixcam-wildtrap/issues)\n- **MaixPy Docs**: https://wiki.sipeed.com/maixpy\n- **Сообщество**: https://maixhub.com\n\n---\n\n### Благодарности\n\nСоздано с использованием:\n- [MaixPy](https://github.com/sipeed/MaixPy) - Python фреймворк для MaixCAM\n- [YOLOv8](https://github.com/ultralytics/ultralytics) - Детекция объектов\n- MaixCAM от [Sipeed](https://www.sipeed.com/)\n\n---\n\n**Made with ❤️ for wildlife enthusiasts and makers**\n\n**Сделано с ❤️ для любителей дикой природы и мейкеров**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbobberdolle1%2Fmaixcam-wildtrap","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbobberdolle1%2Fmaixcam-wildtrap","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbobberdolle1%2Fmaixcam-wildtrap/lists"}