Documentation
Getting started
Everything you need as a user or a contributor. No login wall, just the notes.
Installation
Download the latest FileConverterPro_Setup_v1.0.8.exe from the Releases page and run it.
The installer:
- Runs without administrator rights
- Supports English, French, Italian, Russian and Turkish during setup
- Targets 64-bit Windows 10 / 11 only
- Optionally creates a Desktop shortcut
- Optionally associates
.fcprojproject files with the app - Offers to add a Windows Defender exclusion for the install folder
PowerShell one-liner (silent install)
$f="$env:TEMP\fcp.exe"; Invoke-WebRequest "https://github.com/Hyacinthe-primus/File-Converter-Pro/releases/latest/download/FileConverterPro_Setup_v1.0.8.exe" -OutFile $f; Start-Process $f "/SILENT" -Wait; Remove-Item $f
Portable version
Download the .zip from the Releases page, extract anywhere, and run FCP.exe. All settings, history, and achievements are stored in the same folder, you can move the folder and everything moves with it.
.fcproj files. Open projects via File → Open Project inside the app.PowerShell one-liner (portable)
$z="$env:TEMP\fcp.zip"; $d="$env:USERPROFILE\Downloads\FileConverterPro"; Invoke-WebRequest "https://github.com/Hyacinthe-primus/File-Converter-Pro/releases/latest/download/File_Converter_Pro_v1.0.8.zip" -OutFile $z; Expand-Archive $z -DestinationPath $d -Force; Remove-Item $z; Start-Process explorer.exe $d
System requirements
| Component | Requirement |
|---|---|
| OS | Windows 10 or 11 (64-bit) |
| RAM | 4 GB min / 8 GB recommended |
| Disk | ~225 MB installed (installer download is ~130 MB) |
| Display | 1280 × 720 or higher |
| Dependencies | FFmpeg required for audio/video conversions; no Python installation required |
Optional tools
FCP works on a clean machine. Install any of the following and it will detect them automatically for higher-quality output, no configuration needed.
| Tool | What it unlocks |
|---|---|
| FFmpeg | Required for audio and video conversions and media optimization. |
| Microsoft Office | Pixel-perfect DOCX / XLSX / PPTX and OpenDocument → PDF via COM automation. |
| LibreOffice | High-quality Office/OpenDocument conversions when Office isn't installed. |
| Pandoc | Primary EPUB → PDF rendering; MiKTeX enables its LaTeX pipeline for the best typographic output. |
| MiKTeX | Works with Pandoc for high-quality EPUB → PDF typesetting. |
| wkhtmltopdf | Best HTML → PDF rendering — full CSS, fonts, local images. |
| Ghostscript | Better PDF optimization and compression for smaller output files. |
| Tesseract | OCR engine used by scanlayer to create searchable PDFs. Without it, images still convert to plain PDFs. |
| ImageMagick | Required for image → PSD output. |
Windows Defender & antivirus
Adding the install folder to Defender exclusions is strongly recommended. The installer offers to do this automatically. For the portable version:
Add-MpPreference -ExclusionPath "C:\Your\Folder\FCP"
If you get an "application control policy blocked this file" error, run this in an Administrator PowerShell, replacing the path with your actual install folder:
Get-ChildItem -Path "C:\Your\Folder\FCP" -Recurse | Unblock-File
Languages
FCP ships with English, French, Turkish, Italian, Russian and Simplified Chinese. To add another language, create a .lang file (UTF-8 JSON) and place it in the languages/ folder (_internal/languages/ in the installed build, or src/languages/ from source). It appears in Settings on the next launch.
See CONTRIBUTING.md for a step-by-step guide.
Custom themes
FCP includes Dark and Light themes and supports community .fctheme packs. Install one from Settings → Themes → Install a theme (.fctheme), or browse the FCP Themes repository.
To build or submit a theme, follow the repository's CONTRIBUTING.md; the Themes wiki page is the short version. Imported themes live in _internal/styles/custom_themes/ in the installed build, or src/styles/custom_themes/ from source.
Clone & install
git clone https://github.com/Hyacinthe-primus/File-Converter-Pro.git
cd File-Converter-Pro
pip install -r requirements.txt
python src/main.py
Requires Python 3.10 or 3.13.
Project structure
See the Directory Tree on the project wiki for the current source layout, packaging files, tests, and runtime-generated files.
Building the exe
The project uses PyInstaller for the executable and Inno Setup for the installer. See the For Developers wiki page for the full build guide. The main build auto-detects UPX from PATH; `build_all.ps1` also creates the portable ZIP and SHA-256 checksums in Output/ using 7-Zip. Be careful with UPX and Qt DLLs, as improper usage can corrupt them.
Contributing
Contributions are welcome: Translations, Bug fixes, or larger features. Read CONTRIBUTING.md first. For complex changes (Linux port, new format category), open an issue before starting work.
Known limitations
| Area | Details |
|---|---|
| Windows only | COM automation, registry-based dark mode detection, and PyInstaller packaging are Windows-first. macOS / Linux planned. |
| Build size | ~225 MB compiled – inherent to Python + PySide6 + Matplotlib. |
| PDF → DOCX quality | Depends on source PDF. Scanned PDFs with no text layer are only partially recoverable. |
| HEIC output | HEIC/HEIF input is supported, but HEIC output requires an extra plugin and is unavailable in the bundled build. |
| DNG output | DNG/RAW files are supported as inputs; DNG output requires a Pillow DNG writer and is unavailable in the bundled build. |
| OCR | Requires Tesseract and its language data. Accuracy depends on scan quality and the installed language packs. Orientation can be automatic or a custom angle in degrees. |
| No cloud / sync | History and settings are local only – no account or multi-device sync. The portable build keeps everything in its folder. |
| Solo development | Progression depends on availability outside of studies. |
License
File Converter Pro is free and open-source software licensed under the GNU General Public License v3.0 (GPLv3). You are free to use, study, modify, and distribute it in accordance with the GPLv3. See the full GPLv3 license text.
© Prime Enterprises. All rights reserved.