Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL

fedesanchez0/shader-lab

Media & Design

A live Metal shader playground for Apple platforms with adjustable effects, photo filters, text overlays and wallpaper export.

155
11
Swift
MIT
1 day old

What it is

Shader Lab is a SwiftUI app for experimenting with live Metal shaders on Apple devices. It bundles fifteen effects: full-screen generators such as a heatmap, wave ribbons, an iridescent sphere and a cyanotype-style fractal plant, plus photo effects including warp, ripple, pinch, fluted glass, chromatic aberration and rain on a window. Each effect exposes parameters that update the canvas as you drag them.

The app runs on iPhone, iPad, a foldable iPhone Duo layout, Apple TV, Apple Vision Pro and Apple Watch, with separate layouts for each. On iPhone, iPad and Duo you can overlay text, open a Code tab that shows the selected Metal function with current values filled in, export the source as a .metal file, and export the rendered result to Photos as a wallpaper. The same build also includes an experimental HomeView screen that runs on Apple's internal HomeView SDK inside a virtual machine.

It is aimed at people who want to explore shader effects interactively, produce wallpapers, or read and reuse the Metal source. It is not a shader authoring suite: the catalog is fixed in code rather than created by the user in the app.

Quick start

  1. Install Xcode 27.1 or later (iOS 27.1 SDK), or use Bitrig.
  2. Open Shader Lab.xcodeproj. The Shader Lab scheme builds for iPhone, iPad, Apple TV and Apple Vision Pro; the watch app is embedded in the iPhone app, and Shader Lab Watch App builds it separately.
  3. To run on a physical device, set your development team and replace the placeholder bundle identifier with one of your own.

No packages or setup scripts are required. In the running app, pick an effect, adjust its parameters, then tap Export to save the current canvas to Photos; on iPhone the export is upright even in landscape, and can be set from Photos with Share → Use as Wallpaper. Running the HomeView variant is a separate, longer procedure involving vphone-cli; see the project's HomeView virtual machine instructions.

The project's unit and UI test suites can be run, for example, with bitrig test -destination 'platform=iOS Simulator,name=iPhone 17'.

Constraints

  • Minimum OS versions: iOS/iPadOS 26, tvOS 26 and visionOS 26, with hinge-aware iPhone Duo layout requiring iOS 27.1; the watch app requires watchOS 11. Building needs the iOS 27.1 SDK.
  • The HomeView screen cannot run on real HomeView hardware; Apple has not opened that SDK, and the screen is built as a tvOS app for the virtual machine.
  • The code is MIT-licensed, with an exception: the Rain shader adapts “Heartfelt” and remains under CC BY-NC-SA 3.0, which disallows commercial use and requires share-alike adaptations. That restriction matters if you plan to ship Rain in a paid app.
  • Bundled macOS wallpapers and the Clownfish image are Apple's and used for demonstration; the MIT license does not cover bundled photos or Apple imagery. Review the acknowledgements before redistributing assets.
  • The project has no third-party libraries or Swift packages; it relies only on Apple frameworks.

HotRepo's take

Shader Lab appeared on HotRepo's new-project list for 2026-11-17 with 100 stars gained in the roughly 14-hour window from 2026-11-16 19:35 to 2026-11-17 09:46 UTC, alongside 8 forks; it has no recorded GitHub daily rank. That is a single early snapshot, so it shows initial attention rather than a trend. The project's distinguishing technical choices are the fixed shader catalog with dynamic parameter panels that carry values across effects, the shared 30 Hz canvas clock, and the reduced-resolution rendering for soft gradients. The multi-platform layouts, especially the iPhone Duo crease handling and the TV layout sized to a 544-point square, are the parts most worth evaluating against your own device targets.

Written by AI from the project's README, updated . The project's own docs are the source of truth.

You might also like

  1. GaelQuinta/minecraft-metal-shadersNative Metal shaders that give Minecraft Java on Apple Silicon Macs shadows, clouds, water reflections and HDR at Retina resolution.Java103
  2. Kianuni/CamloAn iOS app that turns iPhone Lock Screen wallpapers into animated slide-to-unlock transitions and 3D depth effects.Swift114
  3. ZSeven-W/openpencilAn AI-native vector design tool where prompts and agent teams build UI on a live canvas, for designers and devs.Rust6,574
  4. kgoedecke/doopA multiplayer design canvas where humans and AI agents edit HTML frames together over MCP.TypeScript1,509
  5. antfu/furifontA Japanese font that draws furigana into its own glyphs, so plain text shows readings without ruby markup or JavaScript.TypeScript405