Skip to content

Repository files navigation

🎭 FaceBlur Studio v1.1.21

FaceBlur Studio (AutoFaceBlur) — мощное десктопное приложение для локального, полностью автоматизированного размытия лиц на видео с использованием нейросетей. Инструмент сочетает в себе приватность (обработка идет только на вашем ПК), высокую скорость и интуитивно понятный интерфейс.


🚀 Ключевые возможности

  • Локальная обработка: Ваши данные не покидают компьютер — полная конфиденциальность.
  • Автоматический трекинг: Детекция объектов на базе модели YOLOv8-face.
  • Рендеринг на лету: Мгновенный предпросмотр результата без предварительного рендеринга видео.
  • Гибкая настройка: Полный контроль над формой масок, радиусом размытия, сглаживанием границ и отступами.
  • Интерактивное управление: Включение/отключение лиц в один клик.
  • Управление проектами: Сохранение и загрузка прогресса работы (.fbp).
  • Сохранение аудио: Оригинальная звуковая дорожка сохраняется без изменений через FFmpeg.
  • Кроссплатформенность: Гарантированно работает на macOS; поддержка Windows реализована в кодовой базе, но находится на стадии тестирования.

🛠️ Технологический стек

Компонент Технология
Язык Python 3.12
Интерфейс CustomTkinter
Компьютерное зрение OpenCV, Ultralytics (YOLOv8)
Обработка видео FFmpeg

📦 Установка и запуск

0. Предварительные требования

Для работы видео-ридера и экспортера в системе должен быть установлен FFmpeg.

  • macOS: brew install ffmpeg
  • Windows: Скачайте с ffmpeg.org и добавьте путь к bin в системную переменную PATH.

1. Клонирование репозитория

git clone https://github.com/sirdimitry/AutoFaceBlur.git cd AutoFaceBlur

2. Настройка окружения и запуск

macOS / Linux: python3 -m venv venv && source venv/bin/activate && pip install -r requirements.txt && python main.py

Windows (PowerShell): python -m venv venv; .\venv\Scripts\Activate.ps1; pip install -r requirements.txt; python main.py


🐞 Отладка

При возникновении проблем с интерфейсом или обработкой, в корневой папке проекта создается файл debug_app.log. Он содержит подробную историю действий и ошибок, которая поможет вам быстро найти причину сбоя.


📜 Лицензия

  • Автор: @sirdimitry (2026)
  • Лицензия: MIT. Свободно для личного и коммерческого использования.

About

Fully automated local video privacy protection tool

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages