MultiConvert 🔄

Premium desktop file converter & editor for Windows Convert between 35+ input formats and 25+ output formats with high quality • Edit output in-app • Batch processing

Đọc bản Tiếng Việt 🇻🇳

📥 Downloads (For End Users)

Fastest way to get started:

Navigate to the Releases section on the right side of GitHub.
Download the .exe setup file (e.g., MultiConvert_Setup_v0.1.0.exe).
Run it and follow the standard installation wizard (Next → Install).
Optionally, you can automatically install LibreOffice and Tesseract OCR during setup if your PC doesn't have them yet.

✨ Features

🔄 Multi-Format Conversion

Input (35+):
- Documents: MD, RST, TXT, HTML, DOCX, DOC, ODT, RTF, EPUB, PDF, PPTX, XLSX, CSV
- Markup: LaTeX/TEX, Org, AsciiDoc, MediaWiki, Textile, OPML, FB2, Jira
- Code/Data: JSON, Jupyter (IPYNB), Man pages, T2T, TWiki, TikiWiki
- Images (OCR): JPG, PNG, TIF, BMP, GIF, WEBP, ICO, HEIC
Output (25+):
- Documents: MD, TXT, HTML, DOCX, ODT, RTF, EPUB, PDF, CSV
- Markup: LaTeX, Org, AsciiDoc, MediaWiki, Textile, OPML, FB2, JSON
- Presentations: PPTX, Reveal.js, DZSlides, Slideous, Slidy, S5
Auto-routing: If no direct converter exists (e.g., md→pdf), automatically chains through intermediates (md→html→pdf)

✏️ In-App WYSIWYG Editor

Rich text editing with Bold, Italic, ~~Strikethrough~~
Headings (H1-H3), bullet/numbered lists, blockquotes
Insert links, undo/redo
Import any file → edit as HTML → export to any format

📥 Drag & Drop

Drop single or multiple files onto the app
Automatic batch queue for multiple files

⚡ Batch Processing

Convert entire folders of files at once
Parallel processing with progress tracking

🔍 OCR Support

Extract text from scanned PDFs and images
Multi-language support (Vietnamese + English default)

🎨 Premium Dark UI

JetBrains Fleet-inspired dark slate theme
Warm amber accent colors
Smooth animations and micro-interactions

🛠️ Tech Stack

Component	Technology
Language	Python 3.11+
GUI	PySide6 + QWebEngineView
Text Engine	Pandoc ≥ 3.1
Office Engine	LibreOffice 7+ (headless)
OCR Engine	Tesseract + pytesseract + pdf2image
Packaging	PyInstaller

🚀 Quick Start

1. Setup environment

python -m venv .venv
.venv\Scripts\Activate.ps1
pip install -r requirements.txt
pip install -e .

2. Install external engines

Engine	Required?	Install
Pandoc	✅ Core	pandoc.org/installing
LibreOffice	✅ Office files	libreoffice.org
Tesseract OCR	📷 For OCR	github.com/tesseract-ocr
Poppler	📷 PDF→images	poppler utils

Make sure all engines are in your PATH, or configure via environment variables:

MULTICONVERT_PANDOC → path to pandoc.exe

MULTICONVERT_SOFFICE → path to soffice.exe

TESSERACT_CMD → path to tesseract.exe

3. Launch GUI

python main.py --gui

4. CLI Usage

# Single file conversion
python main.py --input report.docx --to pdf --output report.pdf --open

# With OCR
python main.py --input scan.pdf --to docx --ocr --ocr-lang vie+eng

# List available formats
python main.py --list-formats

🎁 Hướng dẫn Đóng gói và Phát hành (Release Guide)

Phương pháp 1: Tạo Windows Installer (KHUYẾN NGHỊ) ⭐

Tạo file cài đặt chuyên nghiệp như các ứng dụng Windows khác:

powershell -ExecutionPolicy Bypass -File build_installer.ps1 -UseVenv

Yêu cầu tiên quyết:

Cài đặt Inno Setup (miễn phí)

Quá trình thực hiện:

Tự động build file MultiConvert.exe từ source code
Tạo Windows Installer (file .exe) với giao diện cài đặt chuyên nghiệp
Hỗ trợ English + tiếng Việt (nếu máy build có Vietnamese.isl của Inno Setup)
Tự động kiểm tra và thông báo về LibreOffice & Tesseract OCR
Tạo shortcut trên Desktop và Start Menu
Cài đặt uninstaller tự động
Tự động lấy version từ pyproject.toml (không cần sửa tay trong installer script)

Kết quả:

File installer: installer_output/MultiConvert_Setup_v<version>.exe (ví dụ: installer_output/MultiConvert_Setup_v0.1.0.exe)
Người dùng chỉ cần tải file .exe và chạy → cài đặt như app bình thường!
Nhấp đúp 2 lần → hiện giao diện cài đặt → Next → Install → Done!

Hướng dẫn sử dụng nhanh (đúng quy trình phân phối)

Build setup:

powershell -ExecutionPolicy Bypass -File build_installer.ps1 -UseVenv

Lấy file phát hành trong thư mục installer_output với tên MultiConvert_Setup_v<version>.exe.
Gửi file setup này cho người dùng.
Người dùng nhấp đúp file setup để cài đặt theo wizard.
Ở màn hình cuối, tick tùy chọn Launch để mở app ngay sau khi cài.

Phương pháp 2: Portable ZIP (Không cần cài đặt)

Nếu muốn phân phối dạng ZIP portable (giải nén và chạy):

powershell -ExecutionPolicy Bypass -File build_exe.ps1 -UseVenv

Quá trình này sẽ thực hiện:

Tạo một môi trường ảo (build_venv) sạch sẽ, giảm dung lượng (từ 1.3GB → ~900MB)
Tự động gom các thư viện cần thiết như Pandoc, bộ giao diện PySide6 WebEngine
Tạo file MultiConvert.exe (đã giấu console window) có kèm icon logo
Xuất file hướng dẫn README.txt để hỗ trợ người dùng cuối

Output:

Toàn bộ phần mềm trong thư mục dist\MultiConvert\
Nén thành ZIP và gửi cho người dùng
Người dùng giải nén và nhấp đúp MultiConvert.exe

Lưu ý: Thư mục _internal/ chứa thư viện bắt buộc, phải nằm cùng thư mục với file .exe

🛠️ Trình quản lý chuyển đổi mở rộng (Dành cho người phân phối)

Tool tự động kèm theo Pandoc. Tuy nhiên, một số định dạng sau cần cài thêm Engine:

PDF dạng Scan / Hình ảnh (JPG, PNG, GIF, WEBP) ra Chữ:
- Yêu cầu người dùng cài Tesseract OCR: https://github.com/UB-Mannheim/tesseract/wiki
- Cài đặt ở thư mục mặc định C:\Program Files\Tesseract-OCR
- MultiConvert sẽ tự động nhận diện và sử dụng
- Windows Installer tự động kiểm tra và thông báo nếu chưa cài
Word (DOC, DOCX), Excel (XLSX, CSV) ra PDF:
- MultiConvert dùng LibreOffice để xử lý chuyển đổi Office formats
- Tải tại: https://www.libreoffice.org/
- Windows Installer tự động kiểm tra và thông báo nếu chưa cài

📦 Build Commands Quick Reference

# Build Windows Installer (recommended for distribution)
.\build_installer.ps1 -UseVenv

# Build portable EXE only
.\build_exe.ps1 -UseVenv

# Build installer without rebuilding EXE (if already built)
.\build_installer.ps1 -SkipBuild

Output Locations:

EXE: dist/MultiConvert/MultiConvert.exe
Installer: installer_output/MultiConvert_Setup_v<version>.exe

🏗️ Architecture

MultiConvert
├── app.py                    # Entry point (CLI / GUI)
├── manager.py                # Route planner (weighted graph)
├── models.py                 # ConversionRequest / Result
├── formats.py                # Format registry & detection
├── errors.py                 # ConversionError
├── plugin_loader.py          # Load built-in + external plugins
├── converters/
│   ├── base.py               # BaseConverter ABC
│   ├── pandoc_converter.py   # Pandoc (md, html, docx, epub…)
│   ├── libreoffice_converter.py  # LibreOffice headless
│   └── ocr_converter.py      # Tesseract OCR
└── ui/
    ├── main_window.py        # Premium dark GUI
    ├── editor_dialog.py      # WYSIWYG editor (QWebEngineView)
    ├── worker.py             # Background thread worker
    └── theme.py              # Dark slate + amber QSS stylesheet

Conversion Flow

Input File → Detect Format → Find Route (graph search)
  → Step 1: Converter A (md → html)
  → Step 2: Converter B (html → pdf)
  → Output File

Plugin System

Drop a .py file in a plugins folder with:

def get_converter():
    return YourConverterSubclass()

Then pass --plugin-dir ./plugins to load them.

📊 Format Compatibility Matrix

Document Formats

From \ To	md	txt	html	docx	odt	rtf	epub	pdf	latex
md	-	✅	✅	✅	✅	✅	✅	✅	✅
txt	✅	-	✅	✅	✅	✅	✅	✅	✅
html	✅	✅	-	✅	✅	✅	✅	✅	✅
docx	✅	✅	✅	-	✅	✅	✅	✅	✅
odt	✅	✅	✅	✅	-	✅	✅	✅	✅
rtf	✅	✅	✅	✅	✅	-	✅	✅	✅
epub	✅	✅	✅	✅	✅	✅	-	✅	✅
pdf*	✅	✅	✅	✅	✅	✅	✅	-
latex	✅	✅	✅	✅	✅	✅	✅	✅	-

Markup/Wiki Formats

From \ To	md	html	org	asciidoc	mediawiki	textile	fb2	json
org	✅	✅	-	✅	✅	✅	✅	✅
asciidoc	✅	✅	✅	-	✅	✅	✅	✅
mediawiki	✅	✅	✅	✅	-	✅	✅	✅
textile	✅	✅	✅	✅	✅	-	✅	✅
fb2	✅	✅	✅	✅	✅	✅	-	✅
ipynb	✅	✅	✅	✅	✅	✅	✅	✅
json	✅	✅	✅	✅	✅	✅	✅	-

Image OCR → Text

From	txt	md	html	docx
jpg	✅	✅	✅	✅
png	✅	✅	✅	✅
tif	✅	✅	✅	✅
bmp	✅	✅	✅	✅
gif	✅	✅	✅	✅
webp	✅	✅	✅	✅
heic	✅	✅	✅	✅

*PDF input requires text-layer or OCR for scanned documents

⚠️ Known Limitations

PDF → editable: Layout fidelity ~80-90% for text PDFs, lower for complex layouts
Macro files (.docm, .xlsm): Macros are not preserved
RTL languages: May need additional LaTeX packages for PDF output
Multiple LibreOffice instances: Queued (semaphore=1) to prevent crashes

📄 License

Pandoc: GPL
LibreOffice: LGPL
Tesseract: Apache 2.0
MultiConvert: MIT
Copyright holder: Lê Ngọc Tường, Đại học Khoa học Tự nhiên (HCMUS)

Name		Name	Last commit message	Last commit date
Latest commit History 21 Commits
.vscode		.vscode
src/multiconvert		src/multiconvert
tests		tests
tools		tools
web		web
.gitignore		.gitignore
QUICKSTART.md		QUICKSTART.md
README.md		README.md
README_VI.md		README_VI.md
RELEASE_NOTES.md		RELEASE_NOTES.md
TESTING_REPORT.md		TESTING_REPORT.md
UI_UPGRADE_NOTES.md		UI_UPGRADE_NOTES.md
build_installer.ps1		build_installer.ps1
installer.iss		installer.iss
main.py		main.py
pyproject.toml		pyproject.toml
requirements.txt		requirements.txt

Folders and files

Latest commit

History

Repository files navigation

MultiConvert 🔄

📥 Downloads (For End Users)

✨ Features

🔄 Multi-Format Conversion

✏️ In-App WYSIWYG Editor

📥 Drag & Drop

⚡ Batch Processing

🔍 OCR Support

🎨 Premium Dark UI

🛠️ Tech Stack

🚀 Quick Start

1. Setup environment

2. Install external engines

3. Launch GUI

4. CLI Usage

🎁 Hướng dẫn Đóng gói và Phát hành (Release Guide)

Phương pháp 1: Tạo Windows Installer (KHUYẾN NGHỊ) ⭐

Hướng dẫn sử dụng nhanh (đúng quy trình phân phối)

Phương pháp 2: Portable ZIP (Không cần cài đặt)

🛠️ Trình quản lý chuyển đổi mở rộng (Dành cho người phân phối)

📦 Build Commands Quick Reference

🏗️ Architecture

Conversion Flow

Plugin System

📊 Format Compatibility Matrix

Document Formats

Markup/Wiki Formats

Image OCR → Text

⚠️ Known Limitations

📄 License

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages