Skip to content

fatihkan/wallnetic

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

135 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Wallnetic

Live Video Wallpaper Engine for macOS

macOS Swift SwiftUI Metal App Store CI License Version

demo-video.mp4

What is Wallnetic?

Wallnetic brings live video wallpapers to your Mac desktop. Transform your workspace with dynamic, animated backgrounds that run efficiently in the background.

Wallpaper Engine has 40M+ users on Windows — now Mac users finally have a native alternative built with SwiftUI and Metal.

Buy Me A Coffee

Features

Netflix-Style Interface

  • Home, Explore, Popular, and Discover tabs
  • Full-screen hero banner with auto-rotating showcase
  • Horizontal carousel sections with hover previews
  • Dark theme optimized for media browsing

Discover Wallpaper Sources

  • Browse 6 wallpaper sources: Pixabay, Pexels, MyLiveWallpapers, DesktopHut, MoeWalls, MotionBGs
  • In-app browser with automatic video download detection
  • Scan any page to find and download all videos
  • Progress tracking with auto-import to library

Live Video Wallpapers

  • Play any video file (MP4, MOV, M4V, GIF, WebM) as your desktop background
  • Seamless looping with zero stuttering
  • Drag & drop or file picker import
  • Crossfade transitions between wallpaper changes

Per-Space Wallpapers

  • Set different wallpapers for each macOS Space (virtual desktop)
  • Auto-switches when changing Spaces via Mission Control
  • Right-click any wallpaper > "Set for This Space"

Lock Screen Video

  • Video wallpaper on lock screen with clock overlay
  • Uses current wallpaper or a specific selection
  • Auto-detects screen lock/unlock

Multi-Monitor Support

  • Set different wallpapers for each display
  • Same wallpaper across all monitors option
  • Automatic display detection and hot-plug support

Wallpaper Effects

  • Brightness, contrast, saturation, blur, tint, and vignette
  • 8 presets: None, Dim, Vivid, Moody, Film, B&W, Dreamy, Focus
  • Real-time CIFilter effects on video layer

Time-of-Day Auto Switch

  • 4 time slots: Morning, Afternoon, Evening, Night
  • Assign wallpapers per slot with configurable hours

Notification Center Widget

  • Glassmorphism clock widget with wallpaper background
  • Play/pause and next wallpaper controls
  • Favorites quick-switch thumbnails
  • Small, Medium, and Large sizes

Dynamic Island

  • Floating control pill at the top of your screen
  • Compact mode: wallpaper thumbnail + play/pause
  • Expanded mode: full controls, rename, shuffle, favorite
  • Notch-aware layout — wraps around MacBook Pro notch
  • Auto-collapse after 5 seconds

Wallpaper Rename

  • Right-click any wallpaper > Rename
  • Custom display titles without changing file names
  • Available on all screens: Home, Explore, Popular, Library
  • Reset to original name anytime

Dock Icon Hiding

  • Settings > General > "Hide Dock icon"
  • Run as menu bar-only app
  • Access via menu bar icon or Dynamic Island

Striking UI Effects

  • Glow cards with hover effects
  • Neon navigation tabs
  • Glass morphism backgrounds
  • Staggered entrance animations
  • Animated gradient backgrounds

Smart Power Management

  • Auto-pause on battery power
  • Pause when fullscreen apps are active
  • Automatic resume when conditions change

Apple Shortcuts & Siri

  • Set Wallpaper, Next Wallpaper, Toggle Playback, Random Wallpaper
  • Siri: "Change wallpaper in Wallnetic"
  • macOS 14+ required

Performance

  • Metal GPU acceleration for smooth playback
  • 3 performance modes: Quality, Balanced, Battery Saver
  • Minimal CPU usage (~2-5%)
  • Async image caching

Installation

Requirements

Component Requirement
macOS 13.0 (Ventura) or later
Processor Apple Silicon (M1/M2/M3/M4) or Intel
RAM 4 GB minimum
Storage 50 MB + your video files

Mac App Store

Download on the Mac App Store

Direct Download

Platform Download
macOS (Apple Silicon) Wallnetic_1.1.0_arm64.dmg
macOS (Intel) Wallnetic_1.1.0_x86_64.dmg

"Wallnetic is damaged and can't be opened" — This happens because the DMG is not notarized by Apple. Run this command in Terminal after dragging Wallnetic to Applications:

xattr -cr /Applications/Wallnetic.app

Then open the app normally. Alternatively, right-click > Open > Open, or go to System Settings > Privacy & Security > Open Anyway.

Build from Source

git clone https://github.com/fatihkan/wallnetic.git
cd wallnetic/src/Wallnetic
brew install xcodegen
xcodegen generate
open Wallnetic.xcodeproj
# Build and run (Cmd + R)

Requires Xcode 15.0+ and macOS 13.0+


Tech Stack

Component Technology
Language Swift 5.9
UI SwiftUI
Video Engine AVFoundation + AVPlayerLooper
GPU Rendering Metal
Architecture MVVM + Services
Widget WidgetKit
In-App Purchase StoreKit 2
Project Gen XcodeGen

Keyboard Shortcuts

Shortcut Action
Cmd + I Import videos
Cmd + P Toggle play/pause
Cmd + N Next wallpaper
Cmd + F Search
Cmd + O Open main window
Cmd + , Settings

Roadmap

v1.0 — Core

  • Video playback engine with seamless looping
  • Multi-monitor support
  • Library management with collections and favorites
  • Smart power management
  • Metal GPU rendering
  • Notification Center widget
  • Menu bar controls

v1.1 — Current

  • Netflix-style UI redesign
  • Discover wallpaper sources (Pixabay, Pexels, web browser)
  • Per-Space wallpapers
  • Lock screen video
  • Wallpaper effects (blur, brightness, tint, vignette)
  • Time-of-day auto switch
  • Apple Shortcuts & Siri integration
  • GIF/WebM/WebP format support
  • Crossfade transitions
  • Performance modes

v1.2 — Current

  • Dynamic Island — floating control pill at screen top (notch-aware)
  • Wallpaper rename — custom display titles via right-click > Rename
  • Dock icon hiding — run as menu bar-only app
  • Striking UI effects — glow cards, neon navigation, glass morphism, staggered animations
  • Code review bug fixes — Equatable/Hashable contract, import file copy, force-unwrap safety

v2.0 — Planned

  • AI video generation from text prompts
  • Audio visualizer overlay on desktop
  • 3D perspective wallpaper carousel
  • Global hotkeys for wallpaper control
  • Now Playing overlay on desktop
  • Wallpaper marketplace
  • Music reactive mode
  • iCloud library sync

Changelog

v1.2.0

  • Dynamic Island: Floating pill UI at screen top with compact/expanded modes, playback controls, rename, and auto-collapse. Notch-aware layout for MacBook Pro.
  • Wallpaper Rename: Custom display titles via customTitle field. Right-click > Rename on all screens (Home, Explore, Popular, Library).
  • Dock Icon Hiding: Settings > General > "Hide Dock icon" to run as menu bar-only app.
  • Striking UI Effects: Glow cards, neon navigation tabs, glass morphism, shimmer, staggered entrance animations, animated gradient background.
  • Bug Fixes: Equatable/Hashable contract violation, importVideo copying wrong file after format conversion, force-unwrap safety on NSScreen and array access, infinite loop prevention in random wallpaper.

v1.1.0

  • Netflix-style UI redesign with Home, Explore, Popular, Discover tabs
  • Discover wallpaper sources (Pixabay, Pexels, MyLiveWallpapers, DesktopHut, MoeWalls, MotionBGs)
  • Per-Space wallpapers, Lock screen video, Wallpaper effects
  • Time-of-day auto switch, Apple Shortcuts & Siri integration
  • GIF/WebM/WebP format support, Crossfade transitions, Performance modes

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Author

Fatih Kan


License

This project is licensed under the MIT License — see the LICENSE file for details.

Privacy

Wallnetic does not collect any personal data. All wallpapers are stored locally on your Mac. See PRIVACY.md for details.


Made with care for Mac users who deserve better wallpapers.

About

Live Video Wallpaper Engine for macOS — Dynamic Island controls, Netflix-style UI, 6 wallpaper sources, per-Space wallpapers, lock screen video, Metal GPU acceleration, multi-monitor support, and Notification Center widget.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages