ADS-B-Browser-Screenshot

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…

  • Automation
  • Development
  • Other
  • Productivity
  • Tools & Utilities
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
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

17/100 Low

Maintained
12last commit 615 days ago
Popular
123 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today, links checked 34 days ago

GitHub stars
3
Open issues
6
Last commit
2025-03-16
License
MIT
Activity
stale

Checked 10 days ago - source: GitHub (tedder/browser-screenshot-service)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Set the ADS token before querying The ADS token is the secret key the app uses to prove it is allowed to ask the ADS database for data. Put it in an environment variable (a named setting the container can read), a token file, or in config before starting, because without a valid token the API calls fail. source
  • Check rate limits before big runs Rate limits are the number of requests the ADS service lets you make in a time window. Check the remaining count before running large batches, because going over it can pause access until the reset time. source
  • Use sandbox for learning If you are only testing, use the sandbox import (`import ads.sandbox as ads`) so you get mock answers instead of real API traffic. This keeps you from accidentally using up your live request allowance while you figure things out. source
  • Capture a screenshot via the /snap endpoint Run the container on port 5042 and request an image at /snap/<ICAO> (upper- or lower-case ICAO codes). Set MAP_ARGS to tweak the map (e.g. zoom, hidden sidebar) and BASE_URL to point at the mikenye globe. An invalid ICAO returns a 1x1-pixel image. source

Fetched 38 days ago - each note links to its source

Alternatives

No alternatives collected yet.

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.

Answers sourced from github.com

Community

Collected 53 days ago - public community threads