explaingit

pedrommcarrasco/brooklyn

5,620SwiftAudience · generalComplexity · 1/5LicenseSetup · easy

TLDR

A free macOS screensaver that recreates Apple's animated visuals from its October 2018 Brooklyn event, with options to choose animations, set repeat counts, and toggle between light and dark themes.

Mindmap

mindmap
  root((Brooklyn))
    What it does
      Recreates Apple animations
      Works offline
      Light and dark themes
    Customization
      Choose animations
      Set repeat count
      Random order
    Installation
      Homebrew command
      Manual download
      Security override step
    Tech
      Swift
      macOS screensaver
    Notes
      Not actively maintained
      MIT license
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Install a visually polished Apple-inspired screensaver on your Mac with a single Homebrew command.

USE CASE 2

Customize which animations play, how many times each repeats, and whether they appear in light or dark color themes.

USE CASE 3

Study how Apple-style macOS animations are implemented in Swift by reading the open-source code.

Tech stack

SwiftmacOS

Getting it running

Difficulty · easy Time to first run · 5min

macOS may block the .saver file from an unidentified developer, a Security and Privacy setting or a terminal quarantine-removal command is needed on newer macOS versions.

Free to use for any purpose, including commercially, as long as you keep the copyright notice. The original Apple animations remain Apple's property.

In plain English

Brooklyn is a macOS screensaver that recreates the animated visuals Apple used during its special event on October 30, 2018, held at the Brooklyn Academy of Music. The screensaver was built by an independent developer, Pedro Carrasco, as a way to bring those animations to the Mac desktop. The project is open source under the MIT license, though the original animations remain Apple property. The screensaver works without an internet connection and offers a few customization options. Users can choose which of the animations appear, set how many times each one repeats before moving to the next, and toggle between light and dark color themes. The order of animations can also be set to random. Installing Brooklyn is straightforward. The easiest method is through Homebrew, a popular package manager for macOS, using a single terminal command. Alternatively, the screensaver file can be downloaded manually and double-clicked to install through System Preferences. On newer versions of macOS, the system may flag it as coming from an unidentified developer, which requires a brief step in Security and Privacy settings to allow it. If macOS still blocks it, a terminal command can remove the quarantine flag. Uninstalling follows the same two paths: a Homebrew command or deleting the .saver file directly. The project requires macOS El Capitan (10.11) or later and is written in Swift. It is no longer actively maintained, as noted at the top of the README, and the author states that bug fixes would require a fee arrangement. Contributions through GitHub issues and pull requests are still welcome.

Copy-paste prompts

Prompt 1
I installed the Brooklyn screensaver on macOS but Gatekeeper is blocking it. Give me the exact steps to allow it in System Settings and the terminal command to remove the quarantine flag.
Prompt 2
Show me how to modify Brooklyn's Swift source to add a new animation sequence that cycles between two custom colors.
Prompt 3
I want to build my own macOS screensaver in Swift similar to Brooklyn. What is the minimal ScreenSaverView subclass I need and how do I animate between multiple views?
Open on GitHub → Explain another repo

← pedrommcarrasco on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.