Skip to content

A macOS screensaver with various convex polyhedra bouncing across the screen.

License

Notifications You must be signed in to change notification settings

yuzawa-san/PolyhedraSaver

Repository files navigation

PolyhedraSaver

by yuzawa-san

Example

GitHub release (latest by date) GitHub All Releases build

This is a macOS screensaver with various convex polyhedra bouncing across the screen. It is inspired by X11's ico and mxico.

Dozens of common polyhedra are included:

Coordinate Data Attribution

The original data from Kobayashi and Suzuki lacks an SPDX license, but states that the original README files be included in this project. Here are their README files: English and Japanese

Installation

The minimum build target is macOS 10.15 (Catalina) for technical reasons. Manual installation or Homebrew installation is available.

  • Download a release ZIP archive.
  • Open Polyhedra.saver.zip to uncompress.
  • Due to the lack of code signing (that costs money), it is necessary to tell the system to trust this download by running xattr -d "com.apple.quarantine" /path/to/your/Polyhedra.saver
  • Open Polyhedra.saver which will load the screen saver System Preferences pane. This will install the screensaver.
  • Configure the screensaver.

Alternative shell version:

# Download a tagged version (see shield above)
curl -OL https://github.com/yuzawa-san/PolyhedraSaver/releases/download/TAG/Polyhedra.saver.zip
# Decompress
unzip Polyhedra.saver.zip
# Load screensaver into System Preferences
open Polyhedra.saver
# Clean up
rm -rf Polyhedra.saver.zip Polyhedra.saver

Homebrew

Ideally, this project would be distributed via Homebrew main repo, however that is not possible at this point in time. Please star this project if you want a homebrew distribution as they require projects to have a certain provenance to be added.

A self-maintained tap is available for use. To install tap:

brew tap yuzawa-san/tap

To install:

brew update
brew install --no-quarantine --cask polyhedrasaver

The code is not signed, so the --no-quarantine flag will be needed to have your system trust it.

To update:

brew update
# upgrade all Homebrew software
brew upgrade
# update just this
brew upgrade --no-quarantine --cask polyhedrasaver

Building

Open the Xcode project and build using the IDE or by running xcodebuild clean build -configuration Debug Open the Polyhedra.saver product, which will open the screensaver in the System Preferences.