GitHunt
RE

ReNothingg/XConvertor

XConvertor — твой универсальный инструмент для работы с форматами

XConvertor

Python 3.8+ Platform License: MIT Status

XConvertor Banner

Универсальный и минималистичный офлайн-конвертер файлов для Windows, macOS и Linux.

Создан для быстрой и удобной работы с документами, изображениями, аудио и видео без необходимости загружать файлы в интернет.

Внешний вид

Простой, чистый и интуитивно понятный интерфейс с поддержкой темной темы.

Главное окно (Drag & Drop) Диалог конвертации История конвертаций
Главное окно Диалог конвертации История конвертации

Основные возможности

  • Универсальная конвертация: Работает с документами, изображениями, аудио и видео.
  • Полностью оффлайн: Ваши файлы никогда не покидают ваш компьютер.
  • Drag & Drop интерфейс: Просто перетащите файлы или папки в окно для начала работы.
  • Пакетная обработка: Конвертируйте сотни файлов за один раз.
  • Интеграция с ОС: Добавляется в контекстное меню Windows для быстрого доступа.
  • Работа с PDF: Объединение, разделение и распознавание текста (OCR).
  • Обработка аудио и видео: Извлечение аудиодорожек, конвертация в GIF и многое другое.
  • История конверсий: Легко отслеживайте все выполненные операции.
  • Минималистичный дизайн: Темная тема и отсутствие лишних элементов.

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

Категория Из формата (вход) В формат (выход)
Изображения .jpg, .png, .bmp, .webp, .tiff .jpg, .png, .bmp, .webp, .tiff, PDF (из изображений), TXT (OCR)
Видео .mp4, .avi, .mkv, .mov, .webm .mp4, .avi, .mkv, .mov, .webm, GIF (анимация), MP3/WAV/FLAC (аудио)
Аудио .mp3, .wav, .flac, .aac, .ogg .mp3, .wav, .flac, .aac, .ogg
Документы (PDF) .pdf .docx, .txt, .jpg, .png
Документы (Прочие) .docx, .txt, .rtf .pdf, .txt

Установка

Для работы приложения необходимо установить несколько ключевых компонентов.

Шаг 1: Установка внешних зависимостей

Это самые важные компоненты, которые обеспечивают работу с медиафайлами и текстом.

  1. Python 3.8+

  2. FFmpeg (для работы с аудио и видео)

    • Windows: Скачайте сборку с gyan.dev (например, ffmpeg-release-full.7z), распакуйте и добавьте путь к папке bin в системную переменную PATH.
    • macOS: brew install ffmpeg
    • Linux (Debian/Ubuntu): sudo apt update && sudo apt install ffmpeg
  3. Tesseract OCR (для распознавания текста)

    • Windows: Скачайте установщик с UB-Mannheim, запустите и обязательно отметьте опцию добавления в PATH.
    • macOS: brew install tesseract
    • Linux (Debian/Ubuntu): sudo apt install tesseract-ocr

Шаг 2: Клонирование репозитория

Откройте терминал или Git Bash и выполните команду:

git clone https://github.com/ReNothingg/XConvertor
cd XConvertor

Или просто скачайте ZIP-архив проекта и распакуйте его.

Шаг 3: Установка Python-библиотек

В папке проекта выполните команду для установки всех необходимых библиотек:

pip install -r requirements.txt

🖱️ Как использовать

Запуск приложения

Для запуска основного интерфейса выполните команду в папке проекта:

python main.py

Интеграция в контекстное меню (Windows)

Чтобы добавить пункт "Конвертировать с XConvertor" в меню правого клика:

  1. Откройте командную строку (CMD) или PowerShell от имени администратора.
  2. Перейдите в папку проекта: cd path/to/XConvertor.
  3. Выполните скрипт:
    python add_to_registry.py

Для удаления пункта из меню используйте скрипт remove_from_registry.py (также с правами администратора).

Основной процесс

  1. Перетащите файлы или папки в главное окно приложения.
  2. Если вы перетащили один или несколько файлов одного типа, откроется диалог конвертации.
  3. В диалоге выберите конечный формат или действие (например, "Объединить PDF").
  4. Нажмите "Конвертировать" и выберите место для сохранения результата.
  5. Процесс и результат операции будут записаны во вкладке "История".

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

  • Графический интерфейс: PyQt5
  • Работа с изображениями: Pillow (PIL)
  • Работа с аудио: pydub
  • Работа с видео: MoviePy
  • Работа с PDF: PyPDF2, reportlab
  • Работа с DOCX: python-docx
  • Распознавание текста (OCR): pytesseract
ReNothingg/XConvertor | GitHunt