config.example.toml

# Copy to config.toml and edit

update_interval_minutes = 30
output_dir = "out"

# Location: either set auto_location=true, or provide lat/lon
auto_location = true

[network]
# If you are behind a corporate proxy, set these.
# Example: "http://proxy.mycorp.com:8080"
https_proxy = ""
http_proxy = ""
timeout_s = 300

[region]
# local: use a bbox around (lat, lon)
# country: use the whole country bbox (good for "鍥藉浜戝浘")
mode = "local"  # local | country | globe
# Optional override when mode="country". Format: [lat_min, lon_min, lat_max, lon_max]
# country_bbox_latlon = [18.0, 73.0, 54.0, 135.0]
# Optional override for resolver when mode="country".
# country_name = "China"

# globe mode: render an earth ball centered on your country or location.
# Requires Pillow.
globe_center = "country"  # country | location
globe_render_width = 1920
globe_render_height = 1080
# Background for outside-the-globe area
globe_background_style = "gradient"  # solid | gradient
globe_background_rgb = [0, 0, 0]    # inner (near center)
globe_background_rgb2 = [0, 0, 0]     # outer (near corners)
globe_background_stars = false

# Keep only recent outputs (by day folder name). With keep_days=1, only today's images remain.
[retention]
keep_days = 1

# 24-hour animated wallpaper ("loop" command)
# play_interval_s: how many seconds each hourly frame is shown as wallpaper.
# play_interval_s: seconds each frame is shown during the slideshow.
# frame_interval_min: download a fresh frame every N minutes (clock-aligned, must divide 60).
[slideshow]
play_interval_s = 1
frame_interval_min = 15

[location]
name = "Shanghai"
lat = 31.2304
lon = 121.4737

[area]
half_width_km = 250
half_height_km = 140

[image]
width = 3440
height = 1440
format = "jpg"   # jpg or png
quality = 92

[satellite]
provider = "fy4"  # gibs | himawari | goes | slider | fy4
layers = [
  "VIIRS_SNPP_CorrectedReflectance_TrueColor",
  "MODIS_Terra_CorrectedReflectance_TrueColor",
]
max_days_back = 10

# SLIDER (RAMMB/CIRA) tiled imagery
# - GK2A + korea: Korea-centered regional cloud imagery
# - GK2A + full_disk: Asia-friendly full-disk view (earth disk)
slider_satellite = "gk2a"  # himawari | gk2a
slider_sector = "full_disk"   # full_disk | korea
slider_product = "geocolor"    # geocolor | natural_color | band_13 ...
slider_max_level = 3           # 0..4 (higher = more detail + bandwidth)

# FY-4 (NSMC) full-disk JPEG — China-centered (~104.7°E)
# FY4A + mtcc: multi-channel true-colour composite (~2200x2200, ~800 KB, fast)
# FY4B + gclr: AGRI geo-colour (~11000x12000, ~11 MB, high-res)
fy4_satellite = "fy4b"  # fy4a | fy4b
fy4_product = "gclr"    # mtcc (FY4A) | gclr (FY4B)

# Himawari direct full-disk (infrared cloud image works day+night)
himawari_product = "FULL_24h"
himawari_band = "B13"
# Resolution level: 1d=550, 2d=1100, 4d=2200, 8d=4400 (tiles stitched)
himawari_level_d = 8
himawari_max_lookback_minutes = 240

# Layout:
# - fill: crop to fill the wallpaper (may cut off space around the disk)
# - fit: keep the whole earth disk visible, letterbox with a space background
himawari_layout = "fit"

# In fit mode, shrink/enlarge the full-disk earth without cropping.
# 1.0 = as large as possible; 0.75 = shrink by 25%.
full_disk_scale = 0.75

# Himawari true color (daytime only):
# - Product: D531106
# - No band segment in URL, so set himawari_band = "" (or "none")
# himawari_product = "D531106"
# himawari_band = ""
# # For true-color full-disk, "fit" usually looks more like an earth panorama
# himawari_layout = "fit"

# GOES (NOAA) full-disk true-color (earth disc):
# This is often reachable even when Himawari tiles are blocked.
goes_satellite = "GOES18"   # GOES18 (west) or GOES16 (east)
goes_product = "GEOCOLOR"  # true-color composite
goes_size = 1808            # 678|1808|5424|10848 (bigger = more bandwidth)

[wallpaper]
style = "fill"   # fill | fit | stretch | center | span

[overlay]
enabled = true
text_template = "{layer}  {date}  ({lat:.2f},{lon:.2f})"
position = "bottom-right"   # bottom-right | bottom-left | top-right | top-left
margin_px = 24
font_size_px = 28
fill_rgba = [255, 255, 255, 220]
stroke_rgba = [0, 0, 0, 180]
stroke_width_px = 3