Skip to content

Modern tool for cleaning metadata from images, documents, and videos. Cross-platform, privacy-focused, open source.

License

Notifications You must be signed in to change notification settings

AntGalanin06/Metadata_Cleaner

Repository files navigation

Metadata Cleaner

✨ Современный инструмент очистки метаданных

Удаляйте скрытые данные из ваших файлов

Фотографии, документы, PDF и видео — всё обрабатывается локально на вашем компьютере

Tests Coverage Latest Release GitHub Stars License: MIT Python 3.11+

🌐 Language: 🇺🇸 English | 🇷🇺 Русский


🎬 Демонстрация

Metadata Cleaner Demo

🖥️ Интерфейс приложения

☀️ Светлая тема

Светлая тема

🌙 Темная тема

Темная тема

⚙️ Гибкие настройки

Настройки
  • Автоматическое переключение темы под систему
  • Выбор языка интерфейса (RU/EN)
  • Настройки резервных копий
  • Профили очистки метаданных

ℹ️ О приложении

О приложении
  • Информация о версии и обновлениях
  • Ссылки на документацию и поддержку
  • Поддерживаемые форматы файлов
  • Контакты разработчика и обратная связь

✨ Ключевые особенности

🛡️ Безопасность

  • 100% локальная обработка — данные не покидают ваш компьютер
  • Автоматические резервные копии — оригиналы всегда в безопасности
  • Прозрачная работа — вы видите какие данные удаляются

📂 Удобство использования

  • Простой выбор файлов — удобный диалог выбора из системы
  • Пакетная обработка — обрабатывайте сотни файлов одновременно
  • Селективная очистка — выберите какие метаданные удалить

🎨 Современный интерфейс

  • Material 3 дизайн — красивый и интуитивный
  • Светлая/тёмная темы — подстройка под систему
  • Мультиязычность — русский и английский

⚙️ Поддерживаемые форматы

  • Изображения: JPG, JPEG, PNG, GIF, HEIC, HEIF
  • Документы: PDF, DOCX, PPTX, XLSX
  • Видео: MP4, MOV

🚀 Установка

📥 Скачать EXE

Windows 10+ (64-bit)

📥 Скачать DMG

macOS 10.15+

📥 Скачать AppImage

Ubuntu 18.04+

🔗 Все релизы и версии


🛠️ Технологии

Основной стек

Python Flet Material Design

Сборка и CI/CD

PyInstaller GitHub Actions Poetry

Обработка файлов

Pillow PyPDF OpenPyXL FFmpeg


🙏 Благодарности

🖥️ Интерфейс и GUI

  • Flet — современный Python UI фреймворк
  • Material Design — дизайн система от Google

📁 Обработка файлов

  • Pillow — мощная библиотека для изображений
  • PyPDF — работа с PDF документами
  • python-docx — обработка Word документов
  • openpyxl — работа с Excel файлами

🎬 Видео и метаданные

  • FFmpeg — универсальный инструмент для видео
  • pymediainfo — анализ медиа файлов
  • piexif — работа с EXIF данными

🛠️ Разработка и сборка

  • Poetry — управление зависимостями
  • PyInstaller — создание исполняемых файлов
  • pytest — тестирование кода

🤝 Участие в разработке

📋 Как начать участвовать

🚀 Быстрый старт

# Форкните репозиторий и клонируйте свою копию
git clone https://github.com/ВАШ_USERNAME/Metadata_Cleaner.git
cd Metadata_Cleaner

# Создайте новую ветку для функции
git checkout -b feature/new-feature

# Установите зависимости
poetry install

# Запустите тесты для проверки
poetry run pytest

📝 Рекомендации для участников

  • 💬 Вопросы: Используйте GitHub Issues для вопросов и обсуждений
  • 🧪 Тестирование: Покрывайте новый код тестами
  • 📖 Документация: Обновляйте README при добавлении функций
  • 🎨 Форматирование: Используйте black и следуйте PEP 8

🎯 Области для участия

Область Описание Сложность
🌍 Локализация Добавление новых языков интерфейса Beginner
📁 Расширение форматов RAW, TIFF, WebP, аудио, архивы Intermediate
📊 Детальная статистика Улучшение отчетов о метаданных Intermediate
🎨 Миграция на Tauri Переход с Flet на Tauri + React/Vue Advanced
Производительность Оптимизация обработки больших файлов Advanced
🧪 Тестирование Написание unit и integration тестов Beginner

💡 Идеи для реализации

🔥 Приоритетные задачи
  • 📁 Расширение форматов: Поддержка всех популярных типов файлов
    • Изображения: RAW (CR2, NEF, ARW), TIFF, WebP, AVIF, BMP
    • Видео: AVI, MKV, WMV, FLV, 3GP, M4V, WebM
    • Аудио: MP3, FLAC, WAV, OGG, M4A, AAC
    • Архивы: ZIP, RAR, 7Z (метаданные в комментариях)
  • 📊 Детальная статистика: Подробная информация о найденных и удаленных метаданных
  • ⚙️ Профили очистки: Настраиваемые шаблоны для разных сценариев использования
🌟 Технические улучшения
  • 🔍 Предпросмотр метаданных: Показ содержимого перед удалением
  • 🎨 Миграция на Tauri + React/Vue: Переход на современную архитектуру
    • 🚀 Нативная производительность — компиляция в системные приложения
    • 📦 Минимальный размер — в 10 раз меньше чем Electron приложения
    • 🔒 Повышенная безопасность — изолированный backend на Rust
    • ⚡ Быстрый запуск — без дополнительных процессов и окон
    • 🎨 Современный UI — Material Design 3, анимации, адаптивность

❓ Часто задаваемые вопросы

🔒 Безопасно ли использовать приложение?

Да, абсолютно безопасно! Все файлы обрабатываются локально на вашем компьютере, никакие данные не отправляются в интернет. Приложение автоматически создает резервные копии оригинальных файлов перед очисткой.

📁 Какие форматы файлов поддерживаются?

Текущие форматы:

  • Изображения: JPG, JPEG, PNG, GIF, HEIC, HEIF
  • Документы: PDF, DOCX, PPTX, XLSX
  • Видео: MP4, MOV
🛠️ Что делать если приложение не запускается?

Частые решения:

  • Проверьте системные требования (Windows 10+, macOS 10.15+, Ubuntu 18.04+)
  • Запустите от имени администратора (Windows)
  • Разрешите выполнение в настройках безопасности (macOS)
  • Сделайте файл исполняемым: chmod +x MetadataCleaner.AppImage (Linux)
🔄 Можно ли восстановить удаленные метаданные?

Нет, после очистки метаданные удаляются безвозвратно. Поэтому приложение всегда создает резервные копии оригинальных файлов. Найти их можно в папке с обработанными файлами.

⚡ Почему некоторые файлы обрабатываются медленно?

Скорость зависит от:

  • Размера файлов — большие видео обрабатываются дольше
  • Типа метаданных — сложные EXIF данные требуют больше времени
  • Мощности компьютера — SSD и больше RAM ускоряют процесс

О многопоточности: Приложение использует асинхронную обработку с asyncio.to_thread() для выполнения операций в отдельных потоках, что обеспечивает отзывчивость интерфейса без блокировки UI.


📄 Документация


💝 Поддержите проект

⭐ Если проект оказался полезным — поставьте звездочку!

Это займет всего 3 секунды, но даст огромную мотивацию для развития проекта 🚀

📢 Расскажите друзьям!

📱 Telegram 🔵 ВКонтакте 📸 Instagram

About

Modern tool for cleaning metadata from images, documents, and videos. Cross-platform, privacy-focused, open source.

Resources

License

Stars

Watchers

Forks

Contributors 2

  •  
  •