from dataclasses import dataclass
from pathlib import Path
from typing import Tuple, Optional

import cv2


@dataclass(frozen=True)
class CaptureConfig:
    """Настройки захвата видео с веб‑камеры."""
    device_index: int = 0       # индекс камеры (0 — встроенная)
    width: int = 640            # ширина кадра
    height: int = 480           # высота кадра
    fps: int = 20               # кадров в секунду
    fourcc: str = "mp4v"        # кодек для MP4: mp4v, для AVI: XVID


def create_capture(cfg: CaptureConfig) -> cv2.VideoCapture:
    """Создаёт и настраивает объект VideoCapture."""
    cap = cv2.VideoCapture(cfg.device_index)
    if not cap.isOpened():
        raise RuntimeError("Не удалось открыть веб‑камеру")

    cap.set(cv2.CAP_PROP_FRAME_WIDTH, cfg.width)
    cap.set(cv2.CAP_PROP_FRAME_HEIGHT, cfg.height)
    cap.set(cv2.CAP_PROP_FPS, cfg.fps)
    return cap


def create_writer(output_path: Path, cfg: CaptureConfig) -> cv2.VideoWriter:
    """Создаёт объект записи видео (VideoWriter)."""
    output_path.parent.mkdir(parents=True, exist_ok=True)
    fourcc = cv2.VideoWriter_fourcc(*cfg.fourcc)
    writer = cv2.VideoWriter(str(output_path), fourcc, cfg.fps, (cfg.width, cfg.height))
    if not writer.isOpened():
        raise RuntimeError(f"Не удалось создать файл для записи: {output_path}")
    return writer


def record_from_webcam(
    output_path: Path,
    cfg: CaptureConfig = CaptureConfig(),
    window_title: str = "Video",
) -> Tuple[bool, Optional[str]]:
    """
    Захватывает поток с веб‑камеры, показывает превью и пишет в файл.
    Возвращает (успех, сообщение_ошибки).
    Остановка по клавише 'q'.
    """
    try:
        cap = create_capture(cfg)
        writer = create_writer(output_path, cfg)
    except Exception as e:
        return False, str(e)

    try:
        while True:
            ok, frame = cap.read()
            if not ok:
                return False, "Не удалось прочитать кадр с камеры"

            writer.write(frame)
            cv2.imshow(window_title, frame)

            # выход по 'q'
            if cv2.waitKey(1) & 0xFF == ord("q"):
                break
        return True, None
    finally:
        cap.release()
        writer.release()
        cv2.destroyAllWindows()


def main() -> None:
    cfg = CaptureConfig(
        device_index=0,
        width=640,
        height=480,
        fps=20,
        fourcc="mp4v",  # для .mp4; можно 'XVID' для .avi
    )
    ok, err = record_from_webcam(Path("records/vid.mp4"), cfg)
    if ok:
        print("✅ Запись завершена. Файл: records/vid.mp4")
    else:
        print(f"❌ Ошибка: {err}")


if __name__ == "__main__":
    main()

pip install eyeGestures

python3 examples/simple_example_v2.py

from typing import Tuple, Optional
from eyeGestures.utils import VideoCapture
from eyeGestures import EyeGestures_v3

def run_eye_tracker(screen_width: int = 500, screen_height: int = 500) -> None:
    """
    Запускает eye-tracking с помощью EyeGestures.
    
    :param screen_width: ширина экрана в пикселях
    :param screen_height: высота экрана в пикселях
    """
    gestures = EyeGestures_v3()
    cap = VideoCapture(0)
    calibrate: bool = True

    while True:
        ret, frame = cap.read()
        if not ret:
            break

        event, cevent = gestures.step(
            frame,
            calibrate,
            screen_width,
            screen_height,
            context="my_context"
        )

        if event:
            cursor_x, cursor_y = event.point[0], event.point[1]
            fixation: Optional[bool] = event.fixation
            saccades: Optional[bool] = event.saccadess  # движение глаз

            print(f"X: {cursor_x}, Y: {cursor_y}, Fixation: {fixation}, Saccades: {saccades}")

if __name__ == "__main__":
    run_eye_tracker()

$ git clone https://github.com/ohyicong/Google-Image-Scraper

$ cd Google-Image-Scraper

$ pip install -r requirements.txt

$ python main.py