Installation instructions

There are several ways to build APODesktop. The simplest is by running make

1. simply run

$ make install

Now your wallpaper will be automatically updated every morning at 10:00AM!

You can also manually update your wallpaper at any time by running apodesktop

The macOS program uses NASA's APOD API without an API key. It requests one recent entry per connected screen plus two spare entries, skips non-images and entries without an image URL, and assigns successfully downloaded images newest first. Screens without an available image keep their current wallpaper.

$ cd macOS/
$ xcodebuild -scheme APODesktop -project APODesktop.xcodeproj -configuration Release CONFIGURATION_BUILD_DIR=./build

$ cd macOS/
$ xcodebuild -target APODesktop -project APODesktop.xcodeproj -configuration Release CONFIGURATION_BUILD_DIR=./build

1. run

$ cd macOS/
$ make uninstall

2. Unprofit?

1. simply run

$ make install

2. Profit?

A systemd user timer updates the wallpaper daily once your graphical session has started. Linux uses the same keyless NASA API, requests one recent entry per monitor plus two spares (some entries are videos), and gives the newest image to the primary monitor. On GNOME it combines one image per monitor into a single spanned wallpaper in ~/.local/share/apodesktop/. In other X sessions (such as i3) it uses feh. It needs python3, Pillow, and xrandr (plus feh outside GNOME).

1. simply run

$ cd gnu+X+linux/
$ make uninstall

2. Unprofit?

1. Install the .NET 10 SDK and open PowerShell in the repository.
2. Run:

> .\windows\APODesktop\scheduleApodDaily.ps1

The script builds a Release version in %LOCALAPPDATA%\Programs\APODesktop and registers a daily wallpaper update at noon. Run the installed APODesktop.exe to update immediately. Like macOS, Windows uses NASA's keyless APOD API, assigns images newest first, and skips failed downloads and non-images.

1. Open Task Scheduler
2. On the left-hand sidebar click "Task Scheduler Library"
3. Right-click "APOD-Update Wallpaper daily"
4. Click "delete"

1. Build and install the app on your Android device or emulator:

$ make android-install

Alternatively, open the android/ folder in Android Studio, build, and run the app.

2. Launch the APODesktop application on your device and turn on the "Enable Daily Wallpaper" switch to schedule the daily APOD wallpaper worker.

Android uses the same keyless NASA API. It requests six recent entries, skips videos and entries without an image URL, and uses the newest image for the home screen and the preceding image for the lock screen. The preview displays the newest image and converts NASA's HTML explanation to readable text.

1. Uninstall the APODesktop app from your device.

• detect when the user plugs in a new monitor and update the wallpaper