Skip to content

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

License

Notifications You must be signed in to change notification settings

ReNothingg/XConvertor

Repository files navigation

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

📄 Лицензия

Проект распространяется под лицензией MIT. Подробности смотрите в файле LICENSE.

About

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

Topics

Resources

License

Stars

Watchers

Forks

Languages