The Tool Desk
Outbyte Driver Updater FREEFix the driver behind crashes, sound loss and screen glitchesFind Drivers →Outbyte PC Repair FREEClear out junk files and repair common Windows errorsFree Scan →wkhtmltoimage can run on ARM64, but you need a build that matches both your distribution and CPU architecture. The wkhtmltopdf project’s official download matrix lists ARM64/aarch64 packages for several Debian- and RPM-family systems, plus Raspberry Pi builds for some Debian releases. Start there; if your system is not covered, consider building from source or choosing another Qt-based renderer. A package described as “static” still depends on system libraries and fonts.
Check whether your ARM system is supported
wkhtmltoimage is distributed as part of the wkhtmltox project, whose stable series is 0.12.6 (wkhtmltopdf project, 2020). The official download matrix includes ARM64/aarch64 packages for Debian, Ubuntu, AlmaLinux, CentOS, Amazon Linux 2 and openSUSE, as well as Raspberry Pi builds for several Debian releases. Availability depends on the exact OS release, so check the matrix rather than assuming that any ARM64 package will work: official wkhtmltopdf downloads.
On Debian or Ubuntu, the architecture is commonly reported as arm64; RPM-family package names commonly use aarch64. These labels both refer to 64-bit ARM in this packaging context. They do not mean a package built for one distribution is automatically suitable for another.
Identify your architecture and release
Run these commands before downloading a package:
uname -m
cat /etc/os-release
glibc_version=$(ldd --version 2>&1 | head -n 1)
printf '%sn' "$glibc_version"uname -m commonly prints aarch64 on ARM64 Linux. Package tools may instead describe the architecture as arm64. Check the distribution name and version in /etc/os-release against the download entry, too. If you are on 32-bit ARM, do not treat an ARM64 build as compatible.
Do these 3 things before closing this tab:
1Scan for outdated or missing drivers - takes under a minute2Clear out junk files and repair common Windows errors3Fix the driver behind crashes, sound loss and screen glitches#1 Best Overall
- Includes Raspberry Pi 5 with 2.4Ghz 64-bit quad-core CPU (8GB RAM)
- Includes 128GB Micro SD Card pre-loaded with 64-bit Raspberry Pi OS, USB MicroSD Card Reader
- CanaKit Turbine Black Case for the Raspberry Pi 5
- CanaKit Low Noise Bearing System Fan
- Mega Heat Sink - Black Anodized
Install a matching prebuilt package
- Open the official download matrix and find the entry for your distribution, release and architecture.
- Download the package for that entry. Do not substitute a Debian package for an RPM-family system, or choose an arbitrary ARM package simply because it has the right CPU architecture.
- Install it with your distribution’s package manager. For a downloaded Debian package, for example:
sudo apt install ./wkhtmltox_VERSION.arm64.debReplace the filename with the exact package you downloaded. The command lets
aptresolve package dependencies where available. - For an RPM package, use the package manager for your system, for example:
sudo dnf install ./wkhtmltox-VERSION.aarch64.rpmUse the package’s actual filename and your distribution’s supported package manager.
- Check that the executable is available and reports its version:
wkhtmltoimage --version
If the package manager cannot install a package, the project FAQ says the package can be extracted instead. Extraction does not remove the need to install runtime dependencies; an extracted binary may still fail if required libraries are absent. Consult the official downloads and FAQ for package-specific guidance.
Rank #2
- Includes Raspberry Pi 5 16GB with 2.4Ghz 64-bit quad-core CPU (16GB RAM)
- Includes 128GB Micro SD Card pre-loaded with 64-bit Raspberry Pi OS, USB MicroSD Card Reader
- CanaKit Turbine Black Case for the Raspberry Pi 5
- CanaKit Low Noise Bearing System Fan
- Mega Heat Sink - Black Anodized
Understand the ARM package’s system dependencies
The ARM packages statically link Qt, but “static” does not mean self-contained. The project notes that distribution differences in library versions, OpenSSL and libc can still matter. Rendering also relies on the runtime font stack: Fontconfig, FreeType and fonts installed on the host affect text selection and layout. A binary that launches successfully may therefore still produce different or incomplete text rendering.
Quick wins for a faster PC:
Fix the driver behind crashes, sound loss and screen glitchesFind Drivers →Repair Windows errors before they cause bigger problemsFix Now →- Use the distribution-specific build. It is the best starting point for matching the system libraries the package expects.
- Check missing shared libraries. If the command fails at launch, inspect it with
lddand install the missing dependencies from your distribution’s repositories. Do not download arbitrary library files from untrusted sources. - Install fonts deliberately. Make sure the fonts your pages require are installed in the runtime environment; check Fontconfig and FreeType packages if rendering reports font-related errors.
- Test output, not just startup. Compare the rendered text, glyphs, images and dimensions with the production environment.
The package metadata describes the program as converting HTML to PDF and image formats using QtWebKit, and maps arm64 and aarch64 to linux/arm64/v8: wkhtmltopdf packaging configuration.
Verify the renderer with a local fixture
A version check confirms that the executable starts; it does not establish that fonts, CSS or image loading match production. Create a simple local HTML fixture that includes representative text, a non-ASCII character, an image and the CSS your workload depends on. Then capture it:
Rank #3
- CanaKit Raspberry Pi 5 Essentials Starter Kit
cat > /tmp/wkhtmltoimage-arm-test.html <<'HTML'
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<style>
body { font-family: sans-serif; margin: 24px; }
.sample { color: #243b53; padding: 12px; border: 1px solid #bcccdc; }
</style>
</head>
<body>
<h1>ARM rendering check</h1>
<p class="sample">Text, punctuation, and a glyph: café — 漢字</p>
<img src="file:///tmp/test-image.png" alt="Local image check">
</body>
</html>
HTML
wkhtmltoimage /tmp/wkhtmltoimage-arm-test.html /tmp/wkhtmltoimage-arm-test.pngPut a known local image at /tmp/test-image.png before running the command, or remove the image line if you are only checking text and CSS. Inspect the resulting PNG on the same kind of system used in deployment. Record the OS release, architecture, glibc version, installed fonts and wkhtmltoimage --version alongside the test result so a later deployment can be compared meaningfully.
What to do when there is no matching package
Build from source
A source build can give you more control when the official package matrix does not cover your distribution or when its system-library requirements do not fit your environment. It also creates more work: you must build and maintain the renderer and its Qt/WebKit dependencies, and verify output on the target machine. The project’s source and packaging information does not establish a single universal build recipe for every ARM distribution, so use the project’s source and packaging information for the precise version and target you intend to maintain.
Consider a Qt-based replacement
If you can change renderers, Qt’s Linux documentation lists arm64 support for Ubuntu 24.04 and Debian 11/12. Its Linux-on-Arm desktop reference is a Raspberry Pi 5 with 8GB RAM running Ubuntu 24.04; that is a test baseline, not a guarantee for every ARM system. Qt documents minimum glibc versions of 2.28 for Qt 6.8 and later, and 2.34 for Qt 6.10 and later (The Qt Company, 2026). Building Qt from source avoids the installer’s glibc restriction, but does not eliminate the need to validate dependencies and rendered output. See Qt for Linux and Qt Linux requirements.
Rank #4
- All-in-One Complete Kit: This SANOOV RPi 5 bundle comes with Raspberry Pi 5 4GB RAM single board, active cooler, durable ABS case and screwdriver. No extra parts needed, ready to use right out of the box for beginners and hobbyists
- Powerful Single Board Computer: Equipped with 4GB RAM and high-performance processor, delivers fast running speed for 4K playback, AI projects, programming and daily computing tasks. SANOOV for raspberry pi 5 4GB is equipped with broadcom 64 quad-core Arm Cortex A76 processor with gigabit ethernet and upgraded with IEEE 802.11ac Wi-Fi, Bluetooth 5.0 dual-band 2.4Ghz and 5Ghz and Power Over Ethernet (POE). Upgrading delivers 2-3 x speed vs Pi 4, redefining the experience
- Efficient Active Cooler: Effectively lowers operating temperature and prevents performance throttling. Runs quietly even under long-time heavy load, ensures stable operation all day long. SANOOV RPi 5 4GB kit offer an active cooler, which combines an aluminium heatsink with a high-performance PWM fan. Active cooler is fully compatible with the Pi OS, which can effectively reduce the temperature of RPi5 and ensure its good performance during long-term high load operation
- Sturdy ABS Protective Case: Well-fitted for Raspberry Pi 5 board, can be secured with 4 screws to effectively protect the Pi 5 motherboard from damage, reserves full access to all ports and buttons. SANOOV uses ABS material to produce the case, which has a softer texture and feel. Meanwhile, SANOOV case adopts a layered design for easy disassembly and installation. (Tip: The Case cannot install M.2 HAT Add on Board and Solid State Drive!)
- Wide Application & Full Compatibility: Seamlessly compatible with official OS and mainstream peripheral accessories for Raspberry Pi 5. Whether you are a beginner, student, electronics hobbyist or professional developer, this all-in-one kit meets your diverse needs. It excels in IoT projects, robotics design, retro gaming devices, home media servers and other DIY creations. Backed by a large global community, you can easily find guides, technical support and shared projects online
For a reproducible starting point, test on a Raspberry Pi 5 8GB running Ubuntu 24.04, then record the exact software and font environment. Treat that board as a reference platform, not evidence that a different ARM SoC or operating system will behave identically.
Troubleshoot common ARM failures
| Symptom | Likely cause | What to check or do |
|---|---|---|
| Package manager reports the wrong architecture or refuses the package | The package does not match the host architecture or distribution family. | Check uname -m, the package architecture and /etc/os-release. Return to the official matrix and select the matching entry. |
wkhtmltoimage: command not found |
The package did not install, or its executable is not on the shell’s path. | Check the package manager’s installation result and locate the installed executable using your distribution’s package tools. If extracted manually, invoke its actual path or configure the path deliberately. |
| Launch fails with a missing shared-library error | A runtime dependency such as a distribution library is missing or incompatible. | Use ldd on the executable to inspect shared-library resolution, then install the appropriate library packages for the host distribution. A Qt-static package can still require system libraries. |
| Text is missing, substituted or laid out differently | Fonts, Fontconfig or FreeType differ from the expected runtime environment. | Install the needed fonts and font-stack packages, then re-run the local fixture. Compare on the same OS image intended for deployment. |
| The program starts, but page output differs from another machine | System libraries, fonts, architecture, OS release or page resources may differ. | Record and compare the OS, architecture, glibc, font inventory and renderer version. Validate the same representative fixture on both systems. |
| An extracted package still will not run | Extraction bypassed package installation but did not supply dependencies. | Install missing runtime dependencies with the native package manager or use a matching package. Extraction is not a dependency workaround. |
Plan for security and repeatable deployments
The project warns: “Do not use wkhtmltopdf with any untrusted HTML – be sure to sanitize any user-supplied HTML/JS, otherwise it can lead to complete takeover of the server it is running on!” The warning names wkhtmltopdf, but the companion image renderer uses the same QtWebKit rendering process and attack surface. Do not pass untrusted HTML or JavaScript to it without sanitization and appropriate isolation. Keep test fixtures representative, pin the target OS and package version in deployment notes, and re-run rendering checks when any of those inputs changes. See the project’s downloads page warning.
Or skip the browser setup
If your job is to capture a website rather than maintain a local QtWebKit renderer, ScreenshotNeo offers a website screenshot API and MCP server. A GET request returns a PNG, JPEG, WebP or PDF. For example, save a WebP capture with cURL:
What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
Best Value
- 【What you Get】You will get 1*Pi 5 8GB Single Board,1*RasTech Case,1*Active Cooler,1*Screwdriver,1*Installation instructions,12-month free warranty, lifetime service, 24-hour prompt and friendly response.
- 【More Connectors】There are two USB 3.0 ports(5Gbps simultaneously) and two USB 2.0 ports, which triple total bandwidth ,support any combination of up to two cameras or displays. Peak SD card performance is doubled through support for the SDR104 high-speed mode. It provides a smooth desktop experience for you. Offer Gigabit Ethernet and a PCIe interface, along with dual-band Wi-Fi and Bluetooth 5.0/BLE wireless capability. The RasTech Pi 5 Kit use the new 27W 5.1V 5A USB-C power connector.
- 【 Support Dual 4Kp60 Display 】Each of the two microHDMI sockets can control a 4K display at 60 Hertz, now support HDR, offering super HD video for media streaming projects. RPi 5 is the first RPi model that comes with a PCI Express port (PCIe 2.0 x1 with 500 MB/s) to attach SSDs (requires separate M.2 HAT).
- 【 Excellent Chips And Applications】Pi 5 is a full-size Pi computer using silicon built in-house at Pi. The RP1 “southbridge” provides the bulk of the I/O capabilities for Pi 5. Pi 5 is more friendly and convenient in the development of Internet of Things, Web development, machine identification, automatic control and other electronic equipment applications and network.
- 【 Faster CPU, Better GPU 】 Pi 5 features a Broadcom BCM2712 64-bit quad-core Arm Cortex-A76 processor running at 2.4GHz, it delivers a 2–3× increase in CPU performance relative to RaspberryPi 4. The 800MHz VideoCore VII GPU is compatible to OpenGL ES 3.1 and Vulkan 1.2, substantial uplift in graphics performance. Pi 5 Offers lightning-fast CPU speed, a PCI Express interface, a Real Time Clock (RTC) and a power button and runs significantly cooler than Pi 4.
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webpSee the ScreenshotNeo API documentation for the request options. The service accepts cookie or consent banners and removes more than 60 known consent platforms, newsletter popups and chat widgets before capture; each step can be turned off. Bot checks or CAPTCHAs, blank pages, timeouts, failed loads and cache hits cost nothing, and response headers identify the page verdict and billing status. Its MCP server provides take_screenshot, get_page_info and capture_pdf for Claude, Cursor and other MCP clients. The free plan includes 1,000 shots a month without a card; paid plans start at $5 for 3,000 shots.
Sign up for 1,000 free screenshots a month, with no card required.
Frequently Asked Questions
Does wkhtmltoimage have an ARM64 or aarch64 build?
Yes. The official project download matrix lists ARM64/aarch64 packages for several Linux distributions and Raspberry Pi builds for some Debian releases. Match the package to the exact OS release and architecture.
Is a static ARM build independent of system libraries and fonts?
No. Qt is statically linked in the ARM packages, but system libraries and the installed font stack can still affect whether it runs and how it renders.
Is the Raspberry Pi 5 a guaranteed supported target for wkhtmltoimage?
No. Qt names a Raspberry Pi 5 8GB with Ubuntu 24.04 as a Linux-on-Arm desktop reference platform; that is not a guarantee for every ARM board or for wkhtmltoimage specifically.
Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
