If you're pulling snapshots into a small display, a low-bandwidth device, or anywhere you don't need full resolution, there's now an easier way to get exactly the size you want.
Ask for a Smaller Image
Just add width to your request and you'll get back a JPEG resized to that width, with the aspect ratio kept intact. Leave it out and nothing changes — you still get the original source resolution.
http://localhost:3000/redirect?url=https://camsecure.co/HLS/swanagecamlifeboat.m3u8&format=jpg&width=320
This works on both the /snapshot and /redirect endpoints. If you were already using w or scale, those still work too — width is just the preferred name going forward.
Valid widths are 16–1920px. Ask for anything outside that range and you'll get a clear error back instead of a broken image.
A Couple of Small Reliability Wins
- Every image response now tells you its exact size up front (
Content-Length), so if you're on a constrained device, you can allocate the right buffer before downloading. - If you're running this behind your own proxy or CDN, note that the service itself talks plain HTTP — make sure that layer isn't forcing a redirect to HTTPS on port 80.
Why This Is Useful
Previously, if you only needed a small thumbnail, you had to download the full-size image and resize it yourself. Now you can just ask for the size you want and skip that extra step — less bandwidth, less processing, faster to display.
Full endpoint details are in the README.