https://github.com/chippokiddo/fairylights

Decorative lights for macOS
https://github.com/chippokiddo/fairylights

macos macos-app macos-application

Last synced: 13 days ago
JSON representation

Decorative lights for macOS

• Host: GitHub
• URL: https://github.com/chippokiddo/fairylights
• Owner: chippokiddo
• License: gpl-3.0
• Created: 2025-03-06T13:16:38.000Z (about 2 months ago)
• Default Branch: main
• Last Pushed: 2025-04-02T13:49:30.000Z (19 days ago)
• Last Synced: 2025-04-02T14:42:36.688Z (19 days ago)
• Topics: macos, macos-app, macos-application
• Language: Swift
• Homepage: https://chippokiddo.github.io/fairylights/
• Size: 13 MB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: .github/README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

• Mac-Menubar-Megalist - Fairy Lights

README

        


	

	
Fairy Lights



![macOS](https://img.shields.io/badge/macOS-14%2B-blue?style=flat&logo=apple)

![Downloads](https://img.shields.io/github/downloads/chippokiddo/fairylights/total)

[![Latest Downloads](https://img.shields.io/github/downloads/chippokiddo/fairylights/latest/total)](https://github.com/chippokiddo/FairyLights/releases/latest)

[![License](https://img.shields.io/github/license/chippokiddo/fairylights)](../LICENSE)

[![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-ffdd00?&logo=buy-me-a-coffee&logoColor=0D0C22)](https://buymeacoffee.com/chippo)

Fairy Lights is a simple, decorative app for macOS built in Swift that float beneath the menu bar.

![Demo](./assets/demo.gif)

## Features

- Subtle, twinkling fairy lights

- Lives in the macOS menu bar

- Select different light modes: classic, pulse, or breathe

- Select bulb color: default (all available colors) or solid color

- Bulb colors: red, orange, yellow, green, blue, purple, and white

## Install

- Download the `FairyLights-x.y.z.zip` file from the [latest release](https://github.com/chippokiddo/FairyLights/releases/latest)

- Unzip the file and move `Fairy Lights.app` into your `Applications` folder

- Control-click or right-click the app and select 'open'

> [!NOTE]

> macOS Gatekeeper may block the app since Fairy Lights is not notarized:

>

> - Go to System Settings → Privacy & Security

> - Scroll down and locate the prompt for `Fairy Lights.app`

> - Click 'open anyway'

>

> Some assets are not included in this project.

## Contribute

Contributions are welcome! Follow these steps to contribute:

1.  Fork the repository

2.  Create a branch with your feature or bug fix

3.  Submit a pull request for review

## Translate

You can help make this app more accessible by contributing translations! This project uses Xcode's string catalogs `Localizable.xcstrings` for localization. To learn how to edit or add translations, refer to [Apple's official documentation](https://developer.apple.com/documentation/xcode/localizing-and-varying-text-with-a-string-catalog).