/aerials

Python based downloader for Apple's tvOS background wallpapers.

Primary LanguagePythonApache License 2.0Apache-2.0

Aerials Downloader for tvOS's wall papers

This Python script will download all the tvOS videos to the downloads folder.

This script also turns the Localizable.nocache.strings into a json file that is hosted here in the api folder.

entries.json is also avaliable under api/{release}/entries.json

These can be pulled using the following url: https://declan-fitzpatrick.github.io/aerials/api/{release}/{parsed|raw}/{lang}

Finally, a Docker container will serve the files (with CORS) on localhost:5050. Reverse proxy setup is left as an exercise to the reader.

running this script

Expected environment variables and their defaults:

ENV VAR Description Defaults, Options
SKIP_GENERATE_POI skip the generation of points of interest files default False
LOCALISE_BIZ_API_KEY API key for your Loco project. Create project here docs default None
TVOS_VERSION the tvOS version to use for downloads default 16
VIDEO_QUALITY the tvOS quality to download default "url-1080-H264", opts "url-1080-H264", "url-1080-HDR", "url-1080-SDR", "url-4K-HDR", "url-4K-SDR"
BW_LIMIT Limit the video download to ~1MB/s Default false

Run:

ENV_VAR=<value> python downloadAerials.py

Localise.biz

"because i could throw .strings at them and download .json"

Nice API docs

Points of interest file

It has the same contents as raw, just split into the video title and time stamps.

raw:

{
    "VideoId_TS" : "description", 
}

parsed:

{
    "VideoId": {
        "TS": "description",
    }
}

Manual localise strings

Can upload your own file to loco without an account

or locally: plistutil on Linux, but this only generates xml

plistutil -i Localizable.nocache.strings -f xml -o results.xml

Mac uses:

plutil -convert xml1 Localizable.nocache.strings

Running the docker container

The container is hosted in DockerHub:

  1. First run the downloader script above to grab the files
  2. run the docker compose file
docker-compose up