Skip to content

The format

Quentin Ligier edited this page Feb 28, 2023 · 6 revisions

XMP

Solar

The dynamic wallpaper information is stored in the "apple_desktop:solar" (xmlns:apple_desktop="http://ns.apple.com/namespace/1.0/") XMP metadata.

  • ap: dict. The light/dark theme automation.
    • d: int. The image index for the dark theme.
    • l: int. The image index for the light theme.
  • si: array of dict. The solar-based dynamic
    • i: int. The index of the image to use. You can use multiple times the same image and store it once.
    • a: float. The elevation of the sun at the time and place the image is (supposedly) taken.
    • z: float. The azimuth of the sun at the time and place the image is (supposedly) taken.

Time

The dynamic wallpaper information is stored in the "apple_desktop:h24" XMP metadata.

  • ap: dict. The light/dark theme automation.
    • d: int. The image index for the dark theme.
    • l: int. The image index for the light theme.
  • ti: array of dict. The time-based dynamic
    • i: int. The index of the image to use. You can use multiple times the same image and store it once.
    • t: float. The time when to change. It is between 0 and 1, 0 being 0:00, 0.25 is 6:00, 0.5 is 12:00, etc.

Appearance

The dynamic wallpaper information is stored in the "apple_desktop:apr" XMP metadata. It allows automatically choosing an image depending on the light or dark theme used.

  • d: int. The image index for the dark theme.
  • l: int. The image index for the light theme.

When to change the image

Solar

It requires knowing the solar position at the current position of the user.

Time

This one is easy. The i value (in ti entries) is a decimal number between 0 and 1, and is a simple mapping of the daytime:

  • 0.00 is 0:00
  • 0.25 is 6:00
  • 0.5 is 12:00
  • 0.75 is 18:00
  • 1 is 0:00 again
  • 0.333 is 4:00
  • 0.02083 is 0:30

Appearance

Simply take the image corresponding to the current theme (light or dark).

Useful resources

They did much of the work: