Skip to content

vasyadiagnost/office-converter-ultimate999

Repository files navigation

Office Converter All-in-One

Offline Windows desktop utility for common office conversion tasks: Word ↔ PDF, DOC → DOCX, PDF ↔ PNG, PDF → DOCX, plus PDF merge and split.

Русская версия README

Features

  • Word → PDF for .doc and .docx files 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.

Requirements

  • 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.

Build a portable EXE on Windows

  1. Download or clone this repository.
  2. Open the project folder in Windows Explorer.
  3. Run build_exe.bat.
  4. 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.

Run from source on Windows

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.py

Smoke tests

On Windows:

run_smoke_tests.bat

Cross-platform developer check, for example in CI:

python tests/smoke_tests.py

The 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.

Repository structure

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

Notes and limitations

  • 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.md and docs/THIRD_PARTY_NOTICES.md, especially the PyMuPDF licensing note.

License

A project license has not been selected yet. See docs/LICENSE_CHOICE.md before making the repository public or attaching release binaries.

About

No description, website, or topics provided.

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors