https://github.com/harryfrzz/hazel
A free & open source macOS live wallpaper app that plays videos as your desktop background
https://github.com/harryfrzz/hazel
live mac swift wall
Last synced: 2 months ago
JSON representation
A free & open source macOS live wallpaper app that plays videos as your desktop background
- Host: GitHub
- URL: https://github.com/harryfrzz/hazel
- Owner: harryfrzz
- License: gpl-3.0
- Created: 2026-03-30T08:04:44.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-18T14:12:35.000Z (3 months ago)
- Last Synced: 2026-05-03T04:42:49.028Z (2 months ago)
- Topics: live, mac, swift, wall
- Language: Swift
- Homepage: https://usehazel.app/
- Size: 1.64 MB
- Stars: 10
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## What's Hazel?
A free & open source macOS live wallpaper app that plays videos as your desktop background
## Features
- Set any video as your live wallpaper
- Loop or play once options
- Mute/unmute audio
- App Hides into menu bar
- Low resource usage
## Installation
1. Download the latest release from GitHub
2. Open `hazel.dmg`
3. Drag and move the app to the Applications folder
> [!NOTE]
> The Hazel app may not appear in Spotlight search. To open it, simply open Finder and navigate to the Applications folder, then double click Hazel
## Usage
- Click the menu bar icon and choose the "Hazel" option to open the library window
- Click "+" to add videos
- Select a video to set it as your wallpaper
- Right click a wallpaper for options (loop, mute, remove)
- Use the menu bar to change wallpaper fit or toggle open on startup
## Requirements
- macOS 13.0 or later
## Feedback
I’d love to hear your thoughts and feedback!
You can open an **issue** to share your ideas or suggestions
If you enjoy Hazel, consider giving the repo a ⭐️
## Credits
Special thanks to the original artist for the app icon used in Hazel ❤️
Pinterest: https://in.pinterest.com/kyurakatsuya/
Instagram: https://www.instagram.com/_lunara28
**All rights belong to the respective creator**