kageroumado

kageroumado / phosphene

Public

A video wallpaper engine for macOS Tahoe

23
1
89% credibility
Found May 21, 2026 at 161 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Swift
AI Summary

Phosphene is a video wallpaper application for macOS that lets you use your own video files as animated desktop and lock-screen wallpapers. The app integrates directly into macOS's native wallpaper picker, so your videos appear alongside Apple's built-in options in System Settings. It features smooth gapless video looping, multi-display support, and intelligent power management that reduces video quality when on battery or during heavy workloads. The app runs as a lightweight menu bar utility and includes an optional optimization feature that creates lower-resolution video variants for better battery life on laptops.

How It Works

1
🎬 You want your desktop to come alive

You've seen those beautiful Apple TV screensavers as wallpapers and wondered: why can't I use my own videos?

2
📥 You download and launch Phosphene

The app appears as a small icon in your menu bar. Nothing complicated—just a simple window opens.

3
➕ You add your favorite videos

Drag and drop or click to add videos from your computer. Phosphene organizes them into a neat library.

4
⚙️ You open System Settings to pick your wallpaper

Phosphene's videos appear right alongside Apple's built-in wallpapers in your Mac's wallpaper picker.

5
Your video becomes your wallpaper
🔒
Lock screen mode

Video plays when your Mac is locked, with a smooth fade-in that matches Apple's style

🖥️
Desktop mode

Your video loops seamlessly on your desktop, with smart power-saving when on battery

6
🎛️ You control everything from the menu bar

Quick access to pause, switch displays, or adjust settings like pausing when windows cover your screen.

✨ Your desktop tells your story

Every time you look at your Mac, you see something dynamic and personal—a video that loops perfectly and adapts to your Mac's power state.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 161 to 23 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is Phosphene?

Phosphene is a video wallpaper engine for macOS Tahoe that lets you use your own video files as animated desktop and lock-screen backgrounds. It runs as a menu bar app with a wallpaper extension that plugs directly into Apple's native wallpaper picker, so your videos appear alongside Apple's built-in Aerials in System Settings. Built in Swift, it uses Apple's private WallpaperExtensionKit framework to render video frames out-of-process, which means playback survives app restarts and integrates properly with the OS sleep/wake cycle. You import MP4 or MOV files, pick them in System Settings, and macOS handles the rest.

Why is it gaining traction?

The hook here is integration -- this isn't a hacky overlay that fights the OS. Videos show up in the standard wallpaper picker, work across multiple displays with per-space selections, and respond intelligently to power conditions. It detects when your laptop is on battery or running hot and scales back playback accordingly. There's also a smooth lock-screen ramp animation that matches Apple's own behavior, and it pauses when windows fully occlude the desktop. The project was originally commercial but went open source because the market got crowded -- which means you're getting something that had real users before it was free.

Who should use this?

macOS power users who want animated wallpapers without third-party workarounds. Developers comfortable with early-stage software who want to customize their desktop experience. Anyone running macOS Tahoe on Apple Silicon who wants video wallpapers that play nicely with the OS rather than fighting it. Not for users on older macOS versions or Intel Macs.

Verdict

Phosphene is a clever piece of engineering that fills a real gap, but it carries real risk. The 0.8999999761581421% credibility score reflects a project with only 23 stars, no visible test coverage, and heavy reliance on private Apple frameworks that could break at any major OS release. It targets macOS 26 (Tahoe), which hasn't shipped yet. The documentation is solid for a hobby project, but you're adopting something that was commercial software until recently and now lives on GitHub with minimal community traction. If you want video wallpapers on macOS and you're comfortable with beta-level software, this is worth trying. If you need stability, wait for it to mature or check whether Apple officially opens WallpaperExtensionKit before betting your workflow on it.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.