NailBite Detector (Ubuntu prototype)

Локальний прототип, який використовує вебкамеру, MediaPipe та OpenCV для виявлення коли рука підходить до обличчя (використовується ніс як еталон). Показує прев’ю камери, відтворює звук та викликає десктоп-сповіщення при виявленні.

Вимоги

• Ubuntu 22.04
• Python 3.8+
• Вебкамера

Встановлення (рекомендовано віртуальне оточення):

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Запуск:

python main.py

Клавіші під час роботи:

• s — увімкнути/вимкнути моніторинг
• q — вийти

Параметри запуску

Скрипт можна запускати з наступними параметрами командного рядка для тонкого налаштування:

• --camera_id: ID камери для використання (за замовчуванням: 0).
• --threshold: Поріг відстані для спрацьовування, як співвідношення до висоти обличчя (за замовчуванням: 0.5).
• --frames: Кількість послідовних кадрів, протягом яких рука має бути біля обличчя для спрацьовування сповіщення (за замовчуванням: 6).
• --cooldown: Час у секундах між сповіщеннями (за замовчуванням: 3).
• --volume: Гучність сповіщення, від 0.0 (тихо) до 1.0 (максимум) (за замовчуванням: 0.5).
• --alert-sound: Тип звуку сповіщення. Доступні варіанти: beep, sweep, noise (за замовчуванням: 'beep').
• --headless: Запуск у фоновому режимі без вікна попереднього перегляду камери.

Примітки

• Якщо звук не відтворюється автоматично, переконайтесь, що пакет simpleaudio встановлено або що доступні системні утиліти paplay/aplay.
• Усі обробки відбуваються локально — кадри не відправляються в мережу.