Offline Windows desktop utility for common office conversion tasks: Word ↔ PDF, DOC → DOCX, PDF ↔ PNG, PDF → DOCX, plus PDF merge and split.
- Word → PDF for
.docand.docxfiles via Microsoft Word automation. - DOC → DOCX conversion via Microsoft Word automation.
- PDF → DOCX using
pdf2docx. - PDF → PNG page export using PyMuPDF.
- PNG/JPG → PDF, either one PDF per image or one merged PDF.
- PDF merge and PDF split by pages or ranges.
- Recursive folder search, optional overwrite, preserving subfolder structure, progress bar and operation log.
- Runtime RU / EN interface switcher.
- Offline workflow: no file uploads to online conversion services.
- Windows 10/11.
- Python 3.10 or newer for building/running from source.
- Microsoft Word is required only for Word/DOC/DOCX modes.
- Internet access is needed only during the first dependency installation.
- Download or clone this repository.
- Open the project folder in Windows Explorer.
- Run
build_exe.bat. - After a successful build, the executable will be here:
dist\OfficeConvertorPortable.exe
The EXE name intentionally keeps the historical OfficeConvertorPortable spelling for compatibility with earlier local builds.
py -3 -m venv .venv
.venv\Scripts\python.exe -m pip install --upgrade pip setuptools wheel
.venv\Scripts\python.exe -m pip install -r requirements.txt
.venv\Scripts\python.exe office_converter.pyOn Windows:
run_smoke_tests.batCross-platform developer check, for example in CI:
python tests/smoke_tests.pyThe smoke tests cover the translated UI labels, absence of removed branding, basic path helpers, image/PDF conversion helpers, PDF merge/split and Windows batch-file line endings. Microsoft Word COM automation is not tested outside Windows with Word installed.
office_converter.py Main Tkinter application
OfficeConvertorPortable.spec PyInstaller build spec
build_exe.bat Windows EXE build helper
run_smoke_tests.bat Local smoke-test helper
requirements.txt Runtime/build dependencies
tests/smoke_tests.py Smoke tests
docs/ Build, upload, release and license notes
.github/workflows/smoke-tests.yml GitHub Actions smoke test
- Word automation requires installed Microsoft Word and runs only on Windows.
- PDF → DOCX attempts to reconstruct document structure; complex layouts may not convert perfectly.
- Unsigned PyInstaller binaries can trigger antivirus warnings. Build from source if you need maximum trust.
- Before publishing binaries or choosing a project license, read
docs/LICENSE_CHOICE.mdanddocs/THIRD_PARTY_NOTICES.md, especially the PyMuPDF licensing note.
A project license has not been selected yet. See docs/LICENSE_CHOICE.md before making the repository public or attaching release binaries.