sonoma-wallpaper-downloader

KO | EN

gitlite — search

#javascript #hacktoberfest #go #docker #nodejs #macos #java #windows #awesome #kubernetes #vue #pytorch #ios #openai

sonoma-wallpaper-downloader

(★ 20)

This is a simple Tauri application designed to download the current video wallpaper in macOS Sonoma.

sonoma-wallpaper-downloader 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Mac Video Wallpaper Manager

A Tauri + React application for browsing, downloading, and managing macOS video wallpapers (Sonoma and above).

## Features

- Two launch modes:
  - **Download Screensavers** – browse, preview, and download individual macOS Sonoma video wallpapers.
  - **Manage downloaded screensavers** – list all locally downloaded videos under `Library/Application Support/com.apple.idleassetsd/Customer`, see sizes, and optionally delete them.
- HTML5 preview modal for each video.
- Download progress tracking.
- Signed & notarized universal binary (Intel + Apple Silicon).
- Works on macOS Sonoma 14.0+ (may work on later versions if Apple keeps the same data format).

![I made a video too](https://github.com/fuzzywalrus/sonoma-wallpaper-downloader/assets/2363648/71fcb78d-e6c7-47e0-9c59-defc427fc787)

[Watch the YouTube video](https://www.youtube.com/watch?v=D6yynEDJ5gI)

I took inspiration from https://github.com/mikeswanson/WallGet, which is a Wallpaper downloader for macOS Sonoma that uses a Python script to trigger downloading all of the macOS video wallpapers.

However, I wanted to do something a bit different and allow users to download the individual wallpapers and save them wherever they would like. Downloads may take several minutes, depending on your internet connection. Currently, there are about 130+ videos, totaling 65 GBs of videos. Apple has introduced more videos over time on the Apple TV and will likely add more for macOS as well in future OS releases. With any luck the format will stay the same under macOS and this app will work in future version of macOS.

The app now features a new look and feel, and allows for removing the videos from the system if one so chooses to help manage disk space.

## Usage

1. Download the latest `.dmg` from [Releases](https://github.com/fuzzywalrus/sonoma-wallpaper-downloader/releases).
2. Drag **Mac Video Wallpaper Manager** into `Applications`.
3. Launch the app.
4. On first launch choose:
   - **Download Screensavers** to use the original download experience, or
   - **Manage downloaded screensavers** to see/delete videos already stored on disk.
5. To manage existing files, grant the app **Full Disk Access** in  
   `System Settings → Privacy & Security → Full Disk Access`, then relaunch the app.

## Pre macOS 14 notes

Users on non-14.0+ will bounce to all the wallpapers released as of macOS 14.1.1 (23B81). It's important to note that the videos are 4k 240 FPS in HEVC. Older OSes may not support the video format. Older computesr may not be able to playback the video files. T

Click the image or title to trigger a download.

## Downloading the App

Go to the [Releases](https://github.com/fuzzywalrus/sonoma-wallpaper-downloader/releases) and download the latest `.dmg`.  
The app is a universal binary, so it works on both Apple Silicon and Intel Macs.

## So what is this app doing exactly....?

macOS 14 Sonoma shipped with video wallpapers and screensavers akin to the Apple TV. These are video files hosted by Apple and referenced in `Library/Application Support/com.apple.idleassetsd/Customer` in several files. This application reads the appropriate files and then generates a list of the available video files to the host operating system and creates a pictorial list so users can download them.

Realistically the download function could be a webpage with hardcoded URLs but I wanted it to work regardless of what Apple changes. In theory, if Apple updates the OS to include new video wallpapers or makes the URLs on a per-request or per-CPU ID basis, this application should be able to automatically include them as long as the operating system has been updated.

The initial build was an Electron app written in vanilla JavaScript. It has since been migrated to **Tauri + React**, reducing the application size from ~190 MB to about **13 MB** and improving startup time and memory usage.  Version 1.1.0 has been refactored to use TypeScript, to help with the development process and to improve the code quality.

### Future release ideas

- Additional sorting and filtering options (by location, time of day, etc.).
- Smarter handling when Apple adds new videos in future macOS versions.

# Troubleshooting / FAQ

### Problem: I can't open the video:

The application at this time doesn't display the download state, you may have to wait a bit. Also, if you are running an older macOS, it may not support HEVC 4k 240 FPS video

### Can you add different resolution support or different formats?

No. These are the only URLs Apple provides to the videos. If you'd like to change the frames-per-second or resolution, Quicktime can export to different resolutions and you can control the slow motion effect within it. Alternately, Handbrake may work at converting the videos. However, this may come using Aerial as a reference point.

I will not be making conversions of the videos as they're copyright of Apple.

### What is the copyright of the video files?

I do not know off the top of my head. This application works by reading the existing system pref files on Sonoma, particularly, only two files to generate the list of videos and thumbnails. I am not hosting or distributing anything. This is simply a different front-end for what Apple already provides.

These files were produced by Apple or licensed by Apple. I'd _highly_ recommend not using the videos for anything commercial, only personal projects or for your own personal enjoyment.

### Can you add more videos or let me add my own videos to my system preferences?

No. There are applications that do offer alternatives to Apple's screen savers and wallpapers. I've investigated letting users customize videos and in my very quick surface test, it doesn't appear that it is editable without going into the SQLlite database. A portion the DB is encrypted.

If you're a developer, you may want to poke around yourself in `Library/Application Support/com.apple.idleassetsd/`.

# Developers

This Tauri app builds a universal binary for ARM64/x86 Macs.

## Setup

### Requirements

- Node.js
- OptionaL: Xcode developer tools installed on your Mac if you'd like to notarize the application.

1. Clone the repository:
   ```bash
   git clone https://github.com/fuzzywalrus/sonoma-wallpaper-downloader.git
   cd sonoma-wallpaper-downloader
   ```

2. Install dependencies:
   ```
   npm install
   ```

3. Start the development server:
   ```bash
   npm run tauri:dev
   ```

## Publishing Updates

1. Update the version in `package.json`

2. Build and publish:
   ```bash
   npm run build:sign
   ```

## Technologies Used

- React - Frontend UI framework
- Tauri - Desktop application framework
- bplist-parser - For parsing Apple Property List files
- tauri-plugin-update - For managing application updates

## Building

You'll need to create a `.env` file or disable signing.

If you have a valid Apple Developer account, you can create an app-specific password in the Apple ID portal and configure your Team ID. See `.env.example` for the exact variables (`APPLE_ID`, `APPLE_PASSWORD`, `APPLE_TEAM_ID`, etc.).

With `.env` configured, `npm run build:sign` will build, sign, notarize, and staple the DMG.  
The packaged application will be available under:

```text
src-tauri/target/universal-apple-darwin/release/bundle/dmg/
```

## Misc Notes

## Acknowledgements

- Apple for the original wallpapers
- Tauri team for the desktop application framework
- Mike Swanson for the original WallGet project

sonoma-wallpaper-downloader

sonoma-wallpaper-downloader 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

sonoma-wallpaper-downloader

sonoma-wallpaper-downloader 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README