{"id":16815100,"url":"https://github.com/ungoldman/himawari-bg","last_synced_at":"2025-03-17T03:31:38.195Z","repository":{"id":3926944,"uuid":"51351052","full_name":"ungoldman/himawari-bg","owner":"ungoldman","description":":earth_asia: Set the latest image from Himawari 8 as your desktop background.","archived":false,"fork":false,"pushed_at":"2023-10-24T16:41:50.000Z","size":223,"stargazers_count":90,"open_issues_count":0,"forks_count":6,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-12T04:04:54.425Z","etag":null,"topics":["background","desktop","earth","himawari","himawari-8","satellite","wallpaper"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ungoldman.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2016-02-09T06:44:59.000Z","updated_at":"2024-10-13T20:59:32.000Z","dependencies_parsed_at":"2023-07-08T16:32:03.516Z","dependency_job_id":"249f03a1-65f2-47bf-ad21-5aad4c766e8b","html_url":"https://github.com/ungoldman/himawari-bg","commit_stats":{"total_commits":88,"total_committers":6,"mean_commits":"14.666666666666666","dds":"0.48863636363636365","last_synced_commit":"a51a976ecadf9a34af550bd2fa012a8437c6c04d"},"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ungoldman%2Fhimawari-bg","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ungoldman%2Fhimawari-bg/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ungoldman%2Fhimawari-bg/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ungoldman%2Fhimawari-bg/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ungoldman","download_url":"https://codeload.github.com/ungoldman/himawari-bg/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243841207,"owners_count":20356443,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["background","desktop","earth","himawari","himawari-8","satellite","wallpaper"],"created_at":"2024-10-13T10:32:48.229Z","updated_at":"2025-03-17T03:31:37.788Z","avatar_url":"https://github.com/ungoldman.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# himawari-bg\n\nSet the latest image from Himawari 8 as your desktop background.\n\n[![npm][npm-image]][npm-url]\n[![build][build-image]][build-url]\n[![downloads][downloads-image]][npm-url]\n\n[npm-image]: https://img.shields.io/npm/v/himawari-bg.svg\n[npm-url]: https://www.npmjs.com/package/himawari-bg\n[build-image]: https://github.com/ungoldman/himawari-bg/actions/workflows/tests.yml/badge.svg\n[build-url]: https://github.com/ungoldman/himawari-bg/actions/workflows/tests.yml\n[downloads-image]: https://img.shields.io/npm/dm/himawari-bg.svg\n\n## About\n\n**[Himawari 8](http://himawari8.nict.go.jp/)** is a [geostationary](https://en.wikipedia.org/wiki/Geostationary_orbit) weather satellite deployed by the [Japan Meteorological Agency](http://www.jma.go.jp/jma/indexe.html). It takes photographs of Earth every 10 minutes.\n\n**himawari-bg** is a command line program that lets you set the latest image from the Himawari 8 geostationary satellite as your desktop background.\n\n![](screenshot.jpg)\n\n## Install\n\nWarning: requires :zap: **magick** :zap:\n\n* [imagemagick](http://www.imagemagick.org/script/index.php)\n* [graphicsmagick](http://www.graphicsmagick.org)\n* [node.js](https://nodejs.org/en/download/)\n\nIf you have [homebrew](http://brew.sh/) installed, you can use that to quickly install `imagemagick` and `graphicsmagick`.\n\n```\nbrew install imagemagick\nbrew install graphicsmagick\n```\n\nOnce you have magick on your side, you can run himawari-bg anytime:\n\n```\nnpx himawari-bg\n```\n\n## Usage\n\n### Command Line\n\nYou can run `himawari-bg` on the command line with `npx` or via global install (`npm i -g himawari-bg`).\n\nIf you run `himawari-bg` with no arguments, it will download the latest image from Himawari-8 and set it as your desktop background.\n\n:point_right: You have to set the background color of your desktop to black manually if you want it to look as cool as possible.\n\nThere are some options available if you'd like to go further:\n\n```\nUsage: himawari-bg [options]\n\n    --outfile, -o         Location to save image. (default: ~/Pictures/himawari-images/$TIMESTAMP.jpg)\n    --zoom, -z            The zoom level of the image. Can be 1-5. (default: 2)\n    --date, -d            Time of the picture desired. Can also be \"latest\". (default: \"latest\")\n    --infrared, -i        Capture picture on the infrared spectrum. (default: false)\n    --parallel, -p        Parallelize downloads for increased speeds (can be CPU intensive). (default: true)\n    --screen, -s          Screen to set the wallpaper on (macOS only). Options: \"all\", \"main\", screen index. (default: \"main\")\n    --scale               Scaling method (macOS only). Options: \"auto\", \"fill\", \"fit\", \"stretch\", \"center\". (default: \"fit\")\n    --version, -v         Show version information.\n    --help, -h            Show help.\n```\n\n### Node.js\n\n`himawari-bg` can also be used programmatically as a node module:\n\n```\nnpm install himawari-bg\n```\n\nHere is an example of how it works in node:\n\n```js\nconst himawariBG = require('himawari-bg')\n\nhimawariBG({\n  /**\n   * The location to save the resulting image.\n   * Default: `~/Pictures/himawari-images/${Date.now()}.jpg`\n   * @type {String}\n   */\n  outfile: '/path/to/output/earth.jpg',\n\n  /**\n   * The time of the picture desired. If you want to get the latest image, use 'latest'.\n   * Default: 'latest'\n   * @type {String|Date}\n   */\n  date: 'latest', // Or new Date() or a date string\n\n  /**\n   * The zoom level of the image. Can be 1-5 (default: 2)\n   * Each zoom level requires more images to be downloaded and therefore stitched\n   * together. Higher zoom yields a higher resolution image.\n   * Default: 2\n   * @type {Number}\n   */\n  zoom: 2,\n\n  /**\n   * If set to true, an image on the infrared light spectrum will be generated\n   * Default: false\n   * @type {Boolean}\n   */\n  infrared: false,\n\n  /**\n   * Screen to set the wallpaper on (macOS only)\n   * Options: 'all', 'main', screen index\n   * Default: 'main'\n   * @type {String|Number}\n   */\n  screen: 'main',\n\n  /**\n   * Scaling method (macOS only)\n   * Options: 'auto', 'fill', 'fit', 'stretch', 'center'\n   * Default: 'fit'\n   * @type {String|Number}\n   */\n  scale: 'fit'\n})\n```\n\nAll config settings are optional and have default values.\n\n`himawariBG` returns a promise, so it can be used in an async workflow if needed.\n\n```js\nconst himawariBG = require('himawari-bg')\n\nasync function () {\n  try {\n    await himawariBG()\n  } catch (err) {\n    console.log(err)\n  }\n}\n```\n\n## Acknowledgements\n\nThanks to [celoyd](https://github.com/celoyd) for the inspiring [`glittering.blue`](https://glittering.blue/) and [jakiestfu](https://github.com/jakiestfu) for creating [`himawari.js`](https://github.com/jakiestfu/himawari.js).\n\n## Addendum\n\nIt turns out `himawari.js` was inspired by [this gist](https://gist.github.com/MichaelPote/92fa6e65eacf26219022) by [MichaelPote](https://github.com/MichaelPote) which basically does the exact same thing as `himawari-bg` except in a Windows Powershell environment. So I unwittingly made something inspired by something that was inspired by something that does what I did. Internet! `¯\\_(ツ)_/¯`\n\n## Additional Resources\n\nHere are some useful links if you're interested in learning more about the Himawari 8 satellite.\n\n### Official\n\n- [Himawari 8 Real-time Web](http://himawari8.nict.go.jp)\n- [Himawari Data Guide](http://www.eorc.jaxa.jp/ptree/userguide.html)\n- [Himawari 8/9 Standard Data User's Guide](http://www.data.jma.go.jp/mscweb/en/himawari89/space_segment/hsd_sample/HS_D_users_guide_en_v12.pdf)\n- [JAXA account registration (for access to more data)](http://www.eorc.jaxa.jp/ptree/registration_top.html)\n\n### Related Projects\n\n- [@ungoldman/himawari](https://github.com/ungoldman/himawari)\n- [himawari-urls](https://github.com/ungoldman/himawari-urls)\n- [himawari-history](https://github.com/ungoldman/himawari-history)\n- [Glittering Blue](http://glittering.blue)\n- [celoyd/hi8](https://github.com/celoyd/hi8)\n- [Himawari 8 animation tutorial](https://gist.github.com/celoyd/b92d0de6fae1f18791ef)\n- [deband python script](https://gist.github.com/celoyd/a4dd9202fe5c7978b114)\n- [makeaday bash script](https://gist.github.com/celoyd/c2293929ab3fe97ea597)\n- [goes-bg](https://github.com/ungoldman/goes-bg)\n\n## History\n\nRead about updates and changes to this project in the [change log](CHANGELOG.md).\n\n## Contributing\n\nContributions welcome! Please read the [contributing guidelines](CONTRIBUTING.md) before getting started.\n\n## License\n\n[ISC](LICENSE.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fungoldman%2Fhimawari-bg","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fungoldman%2Fhimawari-bg","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fungoldman%2Fhimawari-bg/lists"}