This is nominally a “travel blog”, or something, but I also write code, and sometimes screensavers, so I thought I’d try putting this out there to see how it goes. Let me know what you think! mail@tolar.town or on twitter @tolar.

Writing screensavers for macs is a little weird. But once you get past a few oddities, it can be lots of fun!

For purposes of this post, I assume you have some knowledge of and experience with Xcode and Swift. We’ll build a simple screensaver that spins a green square.

If you want to go ahead and download the complete source, you can find it on GitHub.

Setup your project

Let’s start with your Xcode project setup before we dive in to code: File -> New project. In the project template selection screen, select macOS -> Screen Saver.

Project selection

Continue with setup until you have a project. Xcode will generate an Objective-c subclass of ScreenSaverView for you, but that’s no fun. Swift is the new hot thing, right? Go ahead and delete those files (***View.h and ***View.m). Create a new Swift file. Here we call it GreenSquareScreenSaverView, but you can name it as you please. (Note: if you change the name of the class, be sure to also update it in your Info.plist “Principal class” key.) You can use this stub code:

import Foundation
import ScreenSaver

class GreenSquareScreenSaverView: ScreenSaverView {
    override init?(frame: CGRect, isPreview: Bool) {
        super.init(frame: frame, isPreview: isPreview)
        self.animationTimeInterval = 1 / 30.0
    }
    
    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
    
    override func startAnimation() {
        super.startAnimation()
    }
    
    override func stopAnimation() {
        super.stopAnimation()
    }
    
    override func draw(_ rect: NSRect) {
        super.draw(rect)
    }
    
    override func animateOneFrame() {
    }    
}

Congrats, you have a functional screensaver! It might not do much apart from showing a blank screen, but it’ll build.

Install your screensaver

One major difference between screensavers and apps is that you can’t simply “Run” from Xcode. To install the screensaver:

1. Build from Xcode.
2. Find the screensaver file under “Products”.
3. Right-click on it & select “Open with External Editor.”
4. This will open System Preferences and install the screensaver. (The first time, you’ll have to select the screensaver here).

Install the screensaver

Add a mac app target to make testing easier

Troubleshooting screensavers is a pain in the butt. I highly recommend doing the bulk of your development using a mac app target. Then make sure to test it in screensaver mode, as this is treated a bit differently by macOS.

First, add a new target:

1. Select your project on the left.
2. Under “Targets”, at the bottom select the “+” button.
3. Under “macOS”, select “App”.
4. Continue with the prompts. I suggest naming it something like “Preview”.

Hook up your mac app to the screensaver code you have. We need to expose the screensaver view class (and any other code you have written or will write):

1. Select the file(s) on the left.
2. On the right, select the File Inspector icon
3. Under “Target Membership”, make sure your screensaver & mac app are selected.

Fix target membership

You’ll need to fake the animation in the mac app. Here is some stub code for a view controller (this should only have the mac app as a target):

import AppKit

class PreviewViewController: NSViewController {
    var screensaverView: GreenSquareScreenSaverView? = nil
    
    var timer: Timer? = nil
    
    var isAnimating: Bool = false {
        didSet {
            toggleAnimationTimer()
        }
    }
    
    override func loadView() {
        screensaverView = GreenSquareScreenSaverView(frame: CGRect.zero, isPreview: true)
        self.view = screensaverView ?? NSView()
    }
    
    override func viewDidAppear() {
        super.viewDidAppear()
        
        isAnimating = true
    }
    
    override func viewWillDisappear() {
        super.viewWillDisappear()
        
        isAnimating = false
    }
    
    private func toggleAnimationTimer() {
        if isAnimating {
            if timer == nil {
                timer = Timer.scheduledTimer(withTimeInterval: 1/30.0, repeats: true) { [weak self] (_) in
                    self?.animate()
                }
            }
        } else {
            if let timer = timer {
                timer.invalidate()
                self.timer = nil
            }
        }
    }
    
    func animate() {
        if isAnimating, let screensaverView = screensaverView {
            screensaverView.animateOneFrame()
        }
    }
}

Then in your AppDelegate, you can instantiate your PreviewViewController and pass it to the window:

import Cocoa

@NSApplicationMain
class AppDelegate: NSObject, NSApplicationDelegate {

    var window: NSWindow!
    var previewViewController: PreviewViewController?

    func applicationDidFinishLaunching(_ aNotification: Notification) {
        let previewViewController = PreviewViewController()
        self.previewViewController = previewViewController

        // Create the window and set the content view. 
        window = NSWindow(
            contentRect: NSRect(x: 0, y: 0, width: 800, height: 600),
            styleMask: [.titled, .closable, .miniaturizable, .resizable, .fullSizeContentView],
            backing: .buffered, defer: false)
        window.center()
        window.setFrameAutosaveName("Main Window")
        window.contentView = previewViewController.view
        window.makeKeyAndOrderFront(nil)
    }
}

Now if you build & run the Preview mac app, you’ll have your screensaver running inside the app, and tied to Xcode for debugging, stepping through code, troubleshooting, etc.

You should see a single window with a black background color.

Write code!

If you want to eventually port your code to iOS or tvOS, you may want to stick with something like layers (CALayer) that are easy to use cross-platform. But if you’re focused on screensavers, AppKit is the mac corollary of UIKit, which you might be familiar with if you’ve built iOS apps. NSView and NSViewController are your friends!

For now, let’s add a little green square and rotate it, so you don’t have to stare at a blank screensaver. Create a new Swift file GreenSquareView:

class GreenSquareView: NSView {
    init() {
        super.init(frame: .zero)
        wantsLayer = true
        layer?.backgroundColor = NSColor.green.cgColor
    }
    
    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }    
}

Let’s update a few things in your ScreenSaverView subclass. Create a property:

let greenSquareView = GreenSquareView()

Then, in the init(), add:

addSubview(greenSquareView)

We’ll resize the frame in draw():

    override func draw(_ rect: NSRect) {
        super.draw(rect)
        
        var squareFrame = NSRect.zero
        squareFrame.size = NSSize(width: 150, height: 150)
        squareFrame.origin.x = (rect.width - squareFrame.width) / 2.0
        squareFrame.origin.y = (rect.height - squareFrame.height) / 2.0
        greenSquareView.frame = squareFrame
    }

And we can animate it in the stub animateOneFrame():

    override func animateOneFrame() {
        greenSquareView.rotate(byDegrees: 1)
    }

So if we put that together, our GreenSquareScreenSaverView now looks like:

import Foundation
import ScreenSaver

class GreenSquareScreenSaverView: ScreenSaverView {
    let greenSquareView = GreenSquareView()
    
    override init?(frame: CGRect, isPreview: Bool) {
        super.init(frame: frame, isPreview: isPreview)
        self.animationTimeInterval = 1 / 30.0
        addSubview(greenSquareView)
    }
    
    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
    
    override func startAnimation() {
        super.startAnimation()
    }
    
    override func stopAnimation() {
        super.stopAnimation()
    }
    
    override func draw(_ rect: NSRect) {
        super.draw(rect)
        
        var squareFrame = NSRect.zero
        squareFrame.size = NSSize(width: 150, height: 150)
        squareFrame.origin.x = (rect.width - squareFrame.width) / 2.0
        squareFrame.origin.y = (rect.height - squareFrame.height) / 2.0
        greenSquareView.frame = squareFrame
    }
    
    override func animateOneFrame() {
        greenSquareView.rotate(byDegrees: 1)
    }
}

Animation

The ScreenSaverView class offers you a straightforward way to animate, if what you want to do involves regular updates, like a rotating green square. But that should not restrict you from doing your own CoreAnimation or NSAnimation.

Swift classes: beware, beware, be aware

There’s a fun little bug where sometimes when you create a Swift class, macOS will try to instantiate it as a ScreenSaverView. Your screensaver will quietly crash, but you’ll see a black screen. You can dive into the Console.app, where you might find that it’s trying to call: -[GreenSquare.GreenSquareView initWithFrame:isPreview:]: unrecognized selector sent to instance 0x7fd13af16950

Fortunately, there’s an easy fix!

Back in Xcode, select your project on the left, then your screensaver target, then “Build Phases”. Under “Compile Sources”, ensure that your ScreenSaverView subclass is the first Swift file.

Fix Build Phases

Code!

The code mentioned here is over on github.com/rhaining/screensaver-demo.

App preview

What else?

What else do you want to learn? Hit me up: mail@tolar.town or on twitter @tolar.

Other screensavers

I’ve published a couple of screensavers this year, if you want to check them out.

• Presidential Hopefuls visualizes polling data in a fun, weird way.
• Zooooom is a parody of a zoom call that I built with my friend Harper. You can check out the source code at github.com/rhaining/zooooom-screensaver.

Check them out and let me know what you think!

Every Easter Sunday on 5th Avenue in Midtown Manhattan, outside St Patrick’s Cathedral, there is an Easter Parade. It’s bananas. You see everything from traditional Easter bonnets to outlandish performance art projects to political statements.

This being a pandemic year, they couldn’t have the traditional gathering, so one group put together a Zoom call, complete with multiple rooms, dance parties with various styles of music, and a promenade, where folks could virtually “raise their hand” to show off their outfits. Here are some I took pictures of. Check them out!

The Zoom Easter parade was also a fundraiser for Stonewall Village NYC. Support them by donating on their site.

I took some pictures at the 2017 parade – if you want to see the real deal, check them at at Flickr.

It has been 4 weeks since Governor Andrew Cuomo shut down non-essential businesses in New York. He would later expand it to the New York PAUSE, similar to many other governmental policies called lockdown, shelter-in-place, and the like. The new normal has become wearing masks & gloves during the rare times I leave my apartment: to Foodtown, BQE Liquor & Wines, Meathook, or for a walk around the neighborhood, trying my best to avoid the swarms of people in parks or huddled around the newly minted takeout windows at bars & pizzerias.

I have been cooking and baking a lot! A few items I’ve been especially happy about: roast chicken, ribs, oatmeal creme pies, roast pork, New Mexican style pork (“carne adovada”), dill shrimp orzo salad, brisket, burrito pie, nachos. I also started experimenting with breads: no-knead loaves, white bread, english muffins, flour tortillas.

I’ve also loved the video calls that have popped up in place of happy hours, brunches, virtual dinners, Easter parades, dance parties.

I bought a full-sized digital piano with weighted keys, which I’ve been enjoying relearning, and which provides a nice break from the monotony of lockdown. And I started playing Animal Crossing on Switch, which is pretty fun.

Foodtown, the Friday before the lockdown began. It took 45 minutes just to check out. During normal times, there’s at most 1-2 people ahead of me in the checkout line.

At home: the weird final Democratic primary debate, where Bernie & Joe social distanced; me wearing my first mask; and my new piano.

Food! Bread, ribs & green beans, Ritz chicken & brussels, burrito pie, brisket nachos, oatmeal creme pies, white loaf, brisket tacos, english muffins.

A lot more video calls these days! Family chat, virtual dinners, remote stretch, tfw dance party, karaoke crew sans any real karaoke.

Neighborhood store signs: Pharmacy, Allswell, Egg, Brooklinen, Van Leeuwen, Muji, Two Boots, Fellow Barber, Teddy’s, Junk, Egg, Hive.

Out and about: city warnings, street art warnings, dance party, cops observing the park attendees, USPS social distancing, street art inspiration, Spring, Ghostbeard, Billy Barnacles, Meathook social distancing, playground closed, park social distancing, and friends’ social distancing.

Over MLK weekend, I went to New Orleans with some friends. It was my first visit there, but we jam-packed the weekend with lots of good food, drinks, catching up, walking around, listening to music. Oh yeah, and holding alligators in a swamp boat.

I split up the pictures across a few posts. Check them out:

• Architecture in the French Quarter
• Walking the streets
• Music
• Food
• Bars
• Swamp tour
• Shopping
• A few random things

French Quarter: Royal Street

French Quarter: Royal Street

French Quarter: Royal Street

French Quarter: Chartres Street

French Quarter: Decatur Street

Clint & Tolar

Reverend Zombie’s House of Voodoo: Come on in and shop for a spell

$$

We encountered many bros

Doreen Ketchens

Second Line in the French Quarter

Y’all, the food.

Willa Jean: a biscuit with egg, sausage, & pimiento cheese

Willa Jean: shrimp & grits, with etoufee gravy

Country Club: the crew

Country Club: a drink (along with blurry Jacqui & Clint)

Country Club: wall flowers

Country Club: tacos

Killer Poboys: ham & pimiento cheese

Cafe du Monde: beignets & coffee

Cafe du Monde: staff

Antoine’s: place setting

Antoine’s: gumbo

Antoine’s: steak with soft-shelled crab and lump crab meat, and asparagus

Antoine’s: baked alaska

Antoine’s: baked alaska slice

Antoine’s: Tolar, Peter, Adam, Jacqui, Tolar (📷 Clint)

Me in the dungeon

Adam

Adam & Peter

Amaro flight at Gianna’s

A wedding party crashed our quiet cocktail hour at Jewel of the South.

Adam and the birds

Riding an alligator

Clint and an alligator

Before the tour

A tree

Alligator

Swamp grave

Swamp

Peter, Adam, Tolar

A raccoon

Swamp river

Our guide

I’m holding a tiny baby alligator!

A gator head I bought at the gift shop