Download the PHP package tholcomb/goes-php without Composer
On this page you can find all versions of the php package tholcomb/goes-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download tholcomb/goes-php
More information about tholcomb/goes-php
Files in tholcomb/goes-php
Package goes-php
Short Description Web service for downloading and serving NOAA GOES imagery for live-ish background images
License MIT
Informations about the package goes-php
goes-php
A web service for downloading and serving NOAA GOES imagery for live-ish background images.
If you're unfamiliar, that's the Geostationary Operational Environmental Satellite.
Requirements
- PHP 8
- w/ Imagick extension
- SQLite3
- jpegoptim (optional)
Install
Composer:
Manual:
Setup
File Permissions
These instructions assume php-fpm runs as the www-data user and that your account is a member of the www-data group. Adjust accordingly.
crontab
This will cause the cron command to run every 5 minutes. Adjust to taste. This has the same assumptions as above.
nginx
Usage
Managing users
Add a user
Then, follow the prompts. If you answer "yes" to the "Include time data" prompt, a timestamp and info from the original image will appear below Antarctica, otherwise, it will be cropped.
NOTE: The API Key does not need to be secure. That is, unless your threat model includes extremely petty people who will research what obscure software you're using in order to mildly inconvenience you.
List users
Remove user
Getting images
Simply send a GET request to /latest.jpg with your API Key. The API Key can be included two ways:
- As the GET parameter 'apiKey' (ex. /latest.jpg?apiKey=$API_KEY)
- As the HTTP Header 'Api-Key' (ex. Api-Key: $API_KEY)
See download_goes.php for a working example.
iOS Shortcut
Limitations
These limitations are due to the base image URL being hardcoded. (Sue me.) If you're running up against these, feel free to email me or submit a pull request.
- Imagery is only available from the GOES-East satellite
- Screen sizes with dimensions greater than 1808px may suffer image degradation
Acknowledgements
This project would not have been possible without the fine work done by the folks at the National Atmospheric & Oceanic Administration (NOAA), and more specifically, the National Environmental Satellite, Data, and Information Service (NESDIS) and the Center for Satellite Applications and Research (STAR).
Send them your love! Preferably, in the form of a letter to your congressperson.
All versions of goes-php with dependencies
ext-curl Version *
ext-imagick Version *
ext-sqlite3 Version *
doctrine/orm Version ^2.9
guzzlehttp/guzzle Version ^7.3
symfony/process Version ^5.3
tholcomb/symple-console Version ^1.0
tholcomb/symple-http Version ^1.0