Help make live wallpaper control feel native.

Good places to start

• Regression tests for per-display assignment, persistence, shuffle, and resource policies.
• Media validation and AVFoundation failure handling.
• Screen Saver Beta activation and rollback coverage.
• Accessibility, keyboard navigation, localization, and clear troubleshooting copy.

Requirements

Use macOS 26 or later with Xcode 26 or later. The current project has three targets: VibePapers, ScreenSaver, and VibePapersTests. Local development and unsigned builds do not require Apple Developer Program membership.

Build and test without signing

1. 1
   Build the app

   Build the VibePapers scheme with code signing disabled.

2. 2
   Run the tests

   Run the macOS test target on Apple Silicon with code signing disabled.

3. 3
   Package the public beta

   Use the repository’s unsigned-release script to create the DMG, checksum, and update manifest.

The release script requires the official HTTPS update, download, support, privacy, and donation URLs plus an Ed25519 public/private key pair. Keep the private key outside the repository. Consult BUILDING.md in the app source for the complete manual build, signing, DMG, checksum, update-manifest, and verification workflow.

Browse the source