http2pic

Introduction

http2pic is an Open Source website renderer. It uses the wkhtmltox to render websites with various options.

Live demo on https://http2pic.haschek.at/

Dependencies

wkhtmltox
curl extension for PHP apt-get install php5-curl
Make sure the server has the "timeout" command apt-get install coreutils

Install

Download this repo and extract it somewhere on your webserver

With WKHTMLToImage

Install wkhtmltox on your server
Make /usr/sbin/wkhtmltoimage executable for the user that runs the webserver. For Apache it's the www-data user. Or use sudo

With PhantomJS

Install PhantomJS. eg via npm install -g phantomjs
Make /usr/bin/phantomjs executable for the user that runs the webserver. For Apache it's the www-data user. Or use sudo

Upgrade

Whenever you come to this page you can just download the repo again and overwrite the existing files. Should work out of the box

Usage

https://your-host/api?url=[WEBSITE_URL]&[OPTIONS]

Parameters

Parameter	Default	Description
`url`	—	Target URL to screenshot (required)
`viewport`	`1024x768`	Viewport size as `WIDTHxHEIGHT` (max 3840x2160)
`js`	`true`	Enable JavaScript (`true`/`false`)
`fullpage`	`false`	Capture full page height instead of viewport only
`maxheight`	`15000`	Max pixel height for full-page captures (1–30000)
`key`	—	API key (if `API_KEY` env var is set)

Examples

# Standard viewport screenshot
curl "https://your-host/api?url=https://example.com" -o screenshot.png

# Full-page screenshot (great for LLM analysis)
curl "https://your-host/api?url=https://example.com&fullpage=true" -o full.png

# Full-page with custom width and height cap
curl "https://your-host/api?url=https://example.com&fullpage=true&viewport=1280x768&maxheight=20000" -o full.png

# With API key
curl -H "X-API-Key: your-secret" "https://your-host/api?url=https://example.com&fullpage=true" -o full.png

Use as an <img> src:

<img src="https://your-host/api?url=https://example.com" title="screenshot" />

Example php script to proxy an image to the local server

<?php
    $targeturl = 'http://www.xkcd.com';
    $url = 'https://http2pic.haschek.at/api.php?url='.rawurlencode($targeturl);
	    
    $ch = curl_init($url);
    $fp = fopen('xkcd.jpg', 'wb');
    curl_setopt($ch, CURLOPT_FILE, $fp);
    curl_setopt($ch, CURLOPT_HEADER, 0);
    curl_exec($ch);
    curl_close($ch);
    fclose($fp);
?>

This is a HASCHEK SOLUTIONS project

2.9 KiB Executable File Raw Blame History Unescape Escape