# ADS-B-Browser-Screenshot

ADS-B-Browser-Screenshot is a self-hosted automation app. browser-screenshot-service is a lightweight Docker service that captures web-browser screenshots of the mikenye ADS-B globe, returning an image for a given aircraft ICAO code. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1961/ads-b-browser-screenshot

## Description

browser-screenshot-service is a lightweight Docker service that captures web-browser screenshots of the mikenye ADS-B globe, returning an image for a given aircraft ICAO code. Built for the mikenye ADS-B decoding workflow, it lets homelab users pull a globe map view of a tracked flight on demand.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

17/100 (Low), based on 3 of 4 factors.
- Maintained: 12 (last commit 615 days ago)
- Popular: 12 (3 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- GitHub: https://github.com/tedder/browser-screenshot-service
- Docker Hub: https://hub.docker.com/r/tedder42/browser-screenshot-service
- Official website: https://globe.adsb.lol
- Unraid: https://ca.unraid.net/apps/ads-b-browser-screenshot-0j4pmug0x9a704?q=ADS-B-Browser-Screenshot

## Common questions

### How do I start the service in Docker?

Run the provided Docker image with port 5042 exposed. Set environment variables such as BASE_URL and MAP_ARGS, then request snapshots from the snap endpoint.

### Which environment variables can I use to customize the screenshot?

The example shows BASE_URL for the target site and MAP_ARGS for map display options. MAP_ARGS can include settings such as zoom and hidden sidebar or buttons.

### How do I request a screenshot for a specific aircraft?

Call the snap endpoint with the aircraft ICAO as the final path segment. Use upper or lower case and make sure the ICAO exists.

### What happens if the ICAO in the URL is invalid?

The service performs sanity testing on the ICAO code. If it is invalid, it returns a 1x1 pixel image.

---
Source: Our Local Host (https://ourlocalhost.com/app/1961/ads-b-browser-screenshot), the self-hosted and open-source app directory.
