# boramalper/himawaripy

Set near-realtime picture of Earth as your desktop background

Repository: https://github.com/boramalper/himawaripy
Canonical: https://ross.abutalabs.com/products/himawaripy
Homepage: http://labs.boramalper.org/himawaripy
Language: Python
License: MIT
License Family: permissive
Archived: true
Last push: 2024-03-20T15:48:52+00:00

## Health v2 (maintenance only)
Score: 10/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 3863, "days_push": 896, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: archived
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1684, forks 238 (observed 2026-08-28T04:05:21.947366+00:00)

## What it is
A Python 3 CLI script that downloads near-realtime (10-minute delayed) images of Earth taken by the Himawari 8 satellite and sets them as your desktop wallpaper. It is designed to run on a cronjob or systemd timer every 10 minutes and supports multiple Linux desktop environments plus macOS.

## Use cases
- set a live picture of Earth as my desktop wallpaper
- show near-realtime satellite imagery of Earth on my desktop
- automatically refresh my wallpaper every 10 minutes with the latest Himawari 8 image
- download the latest Earth photo without changing my wallpaper
- save battery by pausing wallpaper updates on laptop battery power

## When to choose
- you want a near-realtime Earth satellite photo as your wallpaper on a supported Linux desktop environment or macOS
- you can schedule it with cron or a systemd timer
- you want configurable image quality levels and download deadlines

## When to avoid
- you use a desktop environment outside the tested list (Unity 7, Mate, Pantheon, LXDE, GNOME 3, Cinnamon, KDE, macOS)
- you need Windows support
- you want true realtime imagery rather than 10-minute-delayed satellite data
- you cannot run scheduled jobs

## Facets
- artifact type: cli-tool
- maturity: maintenance
- function: image-processing, cli, workflow-automation
- domain: desktop-applications, developer-tools, media
- platform: python, cli
- tags: wallpaper, satellite-imagery, himawari-8, earth, desktop-background, cron, linux, macos, desktop

## Member repositories
- boramalper/himawaripy (main) score 10

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:21.947366+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:41:16.327229+00:00, confidence not recorded.
  - readme: https://github.com/boramalper/himawaripy (fetched 2026-08-28T04:05:21.947366+00:00, sha 08236f5fa777)
- Data as of 2026-08-30T08:39:29.467469+00:00.