HRConvert2

A self-hosted, resource aware file conversion server supporting 490+ formats in 26 languages.

Automatically checked · GitHub checked 2026-11-12

HRConvert2

Before you switch

Evaluate hosting, migration and feature requirements before switching.

Overview

HRConvert2

Convert almost anything, on your own server. Nothing ever leaves it.
A self-hosted file converter for the public internet, with every converter locked in a sandbox.

490+ formats · 26 languages · runs on a Raspberry Pi
multi-step workflows · optional accounts · no cookies, database or tracking

Get Started · Docker Image · Documentation · Security Policy

The file list in the blue, dark and green colour schemes, the last one in Arabic, each with its bar of controls at the top
Seven colour schemes, two interfaces and 26 languages, with right-to-left layouts where a language needs one.


🔒 Why HRConvert2?

Free online converters are paid for with your files. Upload a contract, a medical scan or a client's CAD drawing and it now sits on a stranger's server, next to an ad network.

HRConvert2 gives you the same convenience with none of that. Drag a file in, pick a format, download the result. The conversion happens on hardware you control, your visitors need no account, and their files are deleted on a schedule you set.

PromiseWhat it means
🏠 Nothing transmittedEvery conversion runs on your server, with local tools. No CDN, no analytics, no telemetry.
👤 No cookies, no account neededVisitors are anonymous, and each gets an isolated folder nobody else can see. Optional accounts, off by default, let a user keep files of their own, still without a cookie.
🗑️ Files expireUploads and results are deleted automatically after an age you choose, unless a signed-in user keeps them.
🧱 Sandboxed convertersEvery tool that parses an upload runs in a bubblewrap sandbox with no network.
🌍 Built for strangersDesigned to be put on the public internet and attacked, and documented that way.

✨ How It Works

The file list: a box beside each file, the ticked ones numbered in the order they were ticked, and a photo's conversion panel open
  1. Drop files in. Any number, any mix of types. Archives, photos, documents, 3D models, video.
  2. Choose what to do with each one. Convert, compress, extract, run OCR, identify, virus scan, strip metadata, merge or split PDFs, rename, share or delete. Only the options that make sense for that file, and that your server has the tools for, appear.
  3. Do it to many at once. Tick several files to convert or archive them together, or hand them to a workflow that runs several steps in a row.
  4. Download the result and walk away. Files expire on their own, unless you signed in to keep them.

Every conversion travels the same path:

flowchart LR
    A["Browser<br/>no cookie"] -->|upload| B["HRConvert2"]
    B --> C["Pipeline<br/>image, video, document, 3D ..."]
    C --> E
    subgraph S["bubblewrap sandbox, no network"]
        E["ImageMagick, FFmpeg,<br/>LibreOffice, OpenSCAD ..."]
    end

The result comes back the same way, and expires on the schedule you set.


🔗 Workflows That Save the Clicking

A workflow is a list of steps, each one something you could already do with a button. Convert every document to PDF, then put the PDFs in one zip is a workflow of two steps. Start it once and it does every step. Each step runs the same code as its button, under the same limits, so a workflow can do nothing a visitor could not already do by hand.

The Workflows panel: a tab for each operation, two step boxes reading Convert to pdf and Archive to zip, and a preview naming the files each step would take, with the photo left out of the first

  • 📚 Start from the library. Seven ship with HRConvert2, from Scan every file to Documents to PDF, in one zip. An administrator stages their own for every user from the page, with a description in each language, and root installs it with one command.
  • 🗂️ Build your own, no code. Add a step for any operation, from Convert to Delete. Each step takes the files you ticked or what an earlier step made, filtered by kind, name, extension or size.
  • 👀 Preview before it runs. See which files each step would take. A workflow that deletes files names them and asks first.
  • 🏃 Let it run. Each workflow gets a background process of its own, so no web request's time limit cuts it short. A status panel shows the step, the file and the progress. Stop ends the run before its next step, and reloading the page picks it up again.
  • 📤 Share it as a file. Export a workflow to a small JSON file and import it on any HRConvert2 server that allows importing and has the operations it uses. It carries the steps, never your files, sessions or paths.
  • ✅ Yours to limit. The server checks every workflow, whoever built it, before its first step. You cap the steps, the files, the runtime and how many run at the same time, or switch the builder off.
What a workflow file looks like
{
  "Format": "HRProprietary Workflow",
  "Version": 1,
  "Name": "Documents to PDF, in one zip",
  "Description": "Converts every selected document, spreadsheet & presentation to PDF, then puts the PDFs in one zip archive.",
  "Steps": [
    { "Operation": "Convert",
      "Filter": { "Types": ["Document", "Spreadsheet", "Presentation"] },
      "Options": { "Extension": "pdf" } },
    { "Operation": "Archive", "Mode": "together",
      "Options": { "Extension": "zip", "Filename": "Documents" } }
  ]
}

See ABOUT_WORKFLOWS for the format, the libraries and every limit.


👤 Optional Accounts, Still No Cookies

Accounts are off by default, and an installation that leaves them off works exactly as it always has. Turn them on and your users can sign in and keep their files between visits.

The sign-in page, and beside it a page signed in, with the user's name at the end of the bar opening a panel that offers Sign out

  • 🍪 No cookie, ever. A signed-in page keeps a short-lived key in its own memory and the tab's window.name, never in a cookie, site storage, a URL or a log. The page trades it for a new one every few seconds. A stolen copy soon expires, and since each key can be traded only once, trading it signs out both the thief and the user. Close the tab and you are signed out.
  • 🗄️ No database. Accounts are files outside the web root, named by hashes, so a listing shows no username or email address. Passwords are hashed with Argon2id where PHP has it, and only a hash of each key is kept.
  • 📁 Files that stay. A signed-in user's uploads go to a private folder that automatic expiry never touches, up to a quota you set. A workflow they start works on their files.
  • 🚦 Guessing goes nowhere. Failed attempts are limited for each network address and each account. A wrong username is refused exactly like a wrong password, and takes just as long.
  • 📧 Codes, not links. Confirming an email address and recovering a password use a short emailed code, handed to your server's own mail system. HRConvert2 connects to no mail service itself. No mail system? Make accounts and reset passwords from the terminal.
  • 🚪 You decide who comes in. Turned on, anyone may register, and anonymous visitors work as before. Close registration and make every account yourself, or require everyone to sign in.
%%{init: {"sequence": {"mirrorActors": false}}}%%
sequenceDiagram
    participant T as Your browser tab
    participant H as HRConvert2
    T->>H: Sign in
    H-->>T: A key that lives 30 s
    loop Every 6 s, by default
        T->>H: Trade the key
        H-->>T: A new key
    end
    Note over T,H: Kept in the tab, never in a cookie

Serve HRConvert2 over HTTPS, then turn accounts on with sudo php convertCore.php --config, under Enable Authentication. ABOUT_AUTHENTICATION says what accounts defend against, and what they do not.


⚡ Quick Start

🧩 Install on Debian or Ubuntu

sudo git clone https://github.com/zelon88/HRConvert2 /opt/HRConvert2
sudo bash /opt/HRConvert2/Documentation/Build/hrconvert2-setup.sh

Two commands. Clone where only root can change it, such as /opt, because root will not install a tree another account could change. The installer pulls every dependency, creates the storage, sets up the AppArmor profile, PHP and the systemd units, installs HRConvert2 beside its storage, outside the web root, puts in the web root only what a browser needs, then tells you exactly what is working. Add -y to skip the confirmations.

Then open http://your-server/HRProprietary/HRConvert2/convertCore.php and start converting.

🐳 Docker

docker run -d -p 8080:80 --cap-add SYS_ADMIN -v hrconvert2-data:/DATA/HRConvert2 zelon88/hrconvert2

SYS_ADMIN lets the container build the sandbox every converter runs in. Leave it off and the container cannot build one. No process that converts or serves a user's file holds SYS_ADMIN, or any other capability. Run php convertCore.php -v inside the container to confirm the sandbox works. The named volume keeps sessions, accounts and their files when you replace the container to update, and DOCKER_BUILD_INSTRUCTIONS lists what else to keep, such as your settings.

🩺 When Something Is Wrong

cd /var/www/html/HRProprietary/HRConvert2
sudo php convertCore.php -v     # Check every component & say what is wrong
sudo php convertCore.php -fp    # Repair permissions & the web server setup

📦 490+ Formats

CategoryExamples
Documentsdoc, docx, odt, rtf, txt, pdf
Spreadsheetsxls, xlsx, ods, csv
Presentationsppt, pptx, odp
Imagesjpg, png, gif, webp, heic, avif, svg, ico, tiff
Videomp4, mkv, avi, mov, webm, flv, and 50+ more
Audiomp3, flac, aac, wav, opus, wma, and 30+ more
Subtitlessrt, vtt, ass, sub, sbv, ttml, and more
E-Booksepub, mobi, azw, azw3, azw4
Archiveszip, rar, 7z, tar, gz, bz2
ExtractEvery file an archive holds, placed beside it, within the size & count limits you set
3D Modelsobj, stl, ply, collada, and OpenSCAD sources
Drawings & Vectorsdxf, dia, vdx, svg
TracingTrace a logo, a signature or a scanned drawing into svg, dxf, pdf or eps outlines
Data Filesjson, yaml, toml, xml & csv, into one another
LaTeXTypeset a tex document into a pdf
Markupmd, rst, adoc, jira, textile, org, mediawiki, typst, docx, epub, ipynb, and more, into one another
EmailOutlook msg into eml or mbox
GraphsDraw a Graphviz gv graph as svg, png, pdf, jpg, gif, webp, eps or ps
Bootable Disk Imagesx86, ARM, UEFI and MBR/GPT hybrid ISOs
OCRExtract text from images and PDFs
IdentifySize, type, character set & hashes of any file, and whether its name matches what it holds
Strip MetadataA copy of a photo, PDF, office document, ebook, song or video without its authors, places, dates or the software that made it
Merge & Split PDFsPut several PDFs into one, or make a PDF of each page
Rename & DeleteRename one file or every selected file from a pattern, keeping each extension, or delete a selection
WorkflowsAny of the above, chained into one run. See Workflows.
Live StreamsCapture and convert m3u8 playlists
Remote FilesFetch a file from a URL. Off by default.

🛡️ Security You Can Read

HRConvert2 assumes every tool that parses a hostile file can be exploited. So the sandbox is the security boundary, and everything else is a layer on top of it.

  • 🧱 Sandboxed converters. ImageMagick, FFmpeg, LibreOffice, Inkscape, OpenSCAD and every other converter run inside bubblewrap. Each sees only its own input and output, with no network at all.
  • 🧼 Hostile inputs disarmed. OpenSCAD sources are rewritten before they render. Archives are listed before they are opened & measured while they are extracted, & their links are pruned before they reach anything. Stream URLs are inspected before FFmpeg sees them. Fetched files are checked before they are placed.
  • 📋 An audited supply chain. Every dependency is declared in one manifest with minimum and maximum versions. Every pipeline carries an approval record for the dependencies it uses, and approvals expire every year.
  • 🏆 Reports are welcome and credited. Every advisory is accepted, and every reporter is credited publicly once the fix ships. Two were credited in v4.0.0. See the Security Policy.
  • 🔍 Checked by machine as well as by hand. Two independent linters, in Python and Bash, check every change, and each check is proven against faults planted on purpose. Every error the application can raise is documented with its cause and its fix.
  • 🔑 No guessable secrets. Sessions derive from a per-install secret, and updates need shell access.
  • 🔐 Accounts that resist theft. The accounts folder holds only hashes of passwords and keys, so a stolen copy signs nobody in. Over HTTPS, in any current browser, no other site can plant a key in a tab or read one from it.

🌐 26 Languages

Visitors switch language from the page. Nothing to install.

English · Français · Español · 中文 · हिन्दी · العربية · Русский · Українська · বাংলা
Deutsch · 한국어 · Italiano · Português · Tiếng Việt · Türkçe · 日本語 · Bahasa Indonesia
Polski · Nederlands · Kiswahili · မြန်မာ · اردو · فارسی · עברית · ܣܘܪܝܝܐ · ܐܪܡܝܐ

Arabic, Hebrew, Persian, Urdu and both Syriac script languages get proper right-to-left layouts. A new language is one folder, with no change to the core.


🚀 Built for Administrators

  • 🧩 Built on the HRProprietary Engine. HRConvert2 is a thin application on a reusable engine. The engine provides sandboxing, dependency management, self-repairing configuration, resource budgets, workflows, accounts and data protection. Every conversion, scan and file operation is a version-pinned pipeline you can inspect with --pipeline.
  • 🔎 Honest about your server. Each pipeline declares the tools it cannot run without, and a page offers only what your server has the tools for. -v names every pipeline it cannot offer, and what it is missing.
  • ⚙️ Resource-aware. Optional processor and memory budgets keep a busy server responsive, and runaway conversions are stopped. Storage can span several disks, round-robin, least-active or as a standby, and work stops before any of them fills. A missing budget never stops a conversion.
  • 🔄 Updates that roll back. php convertCore.php -u stages a release, swaps it in, and validates it. If the new version can't run, it rolls back on its own. Your configuration is kept. It's off until you turn on --Enable Automatic Updates--.
  • 🎨 Yours to brand. Each interface and each language is a folder. Fork one, restyle it, and lock your visitors' choices in config.php.

Everything is manageable from the terminal, as root:

php convertCore.php -v                              # Check every component, dependency & feature
php convertCore.php --status                        # System state & the listener
php convertCore.php --config                        # Interactive configuration
php convertCore.php --config --repair               # Add any setting the configuration is missing
php convertCore.php --setup --check-depends         # Audit every dependency
php convertCore.php --pipeline --verify             # Confirm every pipeline loaded
php convertCore.php --workflow --list               # List workflows, & why any is not offered
php convertCore.php --workflow --install=FILE       # Check a workflow & offer it to every user
php convertCore.php --workflow --install-staged=ID  # Install a workflow an admin staged from the page
php convertCore.php --workflow --discard-staged=ID  # Turn a staged workflow down & install nothing
php convertCore.php --workflow --export=ID          # Print a workflow as a file a page can import
php convertCore.php --account --list                # List accounts, roles & last sign-ins
php convertCore.php --account --add NAME EMAIL      # Make an account & show its password once
php convertCore.php --account --password NAME       # Give an account a new password & show it once
php convertCore.php -u=latest                       # Update to the newest release, once updates are on
php convertCore.php -c                              # Clean every expired session now

Every command exits with a status a script can act on. See the full command reference.


🧾 Requirements

Minimum
OSDebian or Ubuntu Linux
Web serverApache 2.4
PHP8.0 or later
HardwareRaspberry Pi Model B+. Any x86 or x64 machine is comfortable.
SandboxBubblewrap
EmailOptional. A local mail system, for confirming email addresses and recovering passwords. HRConvert2 installs none.

The installer handles every dependency. The authoritative list is the manifest, in two halves: the Engine's and HRConvert2's.


🤝 Contributing

  • 🌍 Translations. Add a folder.
  • 🎨 Interfaces. Fork a UI folder and make it yours.
  • 🔗 Workflows. Export one you are proud of and share the file.
  • 🐛 Bug reports. Include the steps that reproduce it and the output of php convertCore.php -v.
  • 🔐 Security reports. Report them privately from the Security tab, never in an issue. Every report is accepted, and every reporter is credited once the fix ships. See the Security Policy.

📜 License

GNU General Public License v3.0. Free to use, free to modify, free to self-host. If you improve it, send it back.

Built by @zelon88 for people who would rather not hand their files to strangers.