Kom i gang med WebSnap

Installation

Hent arkivet til dit system, og pak det ud. Installer Google Chrome eller Chromium på samme computer. WebSnap finder normalt browseren automatisk.

På Linux og macOS åbner du en terminal i mappen med programmet:

./websnap version
./websnap capture --url https://example.org/ --output-dir ./billeder

På Windows åbner du PowerShell i samme mappe:

.\websnap.exe version
.\websnap.exe capture --url https://example.org/ --output-dir .\billeder

WebSnap opretter mappen og gemmer desktop.png, tablet.png og mobile.png. Hvis browseren ikke bliver fundet, bruger du --browser efterfulgt af den fulde sti til Chrome eller Chromium.

Egne billeder

Vælg selv størrelse og filnavn. Egne visninger erstatter de tre standardvisninger:

./websnap capture --url https://example.org/ --output-dir ./billeder \
  --viewport forside:1200x800 --viewport mobil:430x932 --wait 4s

Du kan angive højst otte visninger. Bredden skal være 320-3840 pixels, og højden 240-2160 pixels. --wait giver siden ekstra tid efter indlæsning. --timeout sætter tidsgrænsen pr. billede. WebSnap forsøger som standard at afvise valgfrie cookies via en tydelig knap; brug --reject-cookies=false for at slå forsøget fra.

Privat job-API

WebSnap kan lytte på computerens loopback-adresse. Opret først en privat tokenfil med mindst 32 tilfældige tegn:

umask 077
openssl rand -hex 32 > ./websnap-token
./websnap serve --listen 127.0.0.1:8787 \
  --data ./websnap-data --token-file ./websnap-token

Bestil et job fra samme computer:

curl -X POST http://127.0.0.1:8787/v1/jobs \
  -H "Authorization: Bearer $(cat ./websnap-token)" \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://example.org/"}'

Svaret giver et job-id. Læs /v1/jobs/<id>, indtil status er ready, og hent billedadresserne med samme token. WebSnap gemmer jobs og billeder under --data. En installation, der skal kunne nås fra andre maskiner, kræver en HTTPS-reverse proxy og et særskilt netværksfilter.