Skip to content

Latest commit

 

History

History
74 lines (47 loc) · 2.83 KB

README.md

File metadata and controls

74 lines (47 loc) · 2.83 KB

Kotlin Logo screensaver for macOS

Screensaver GIF

Logo set, size, count, and speed can be customized by going to System Settings, Screen Saver, and Options... with this screensaver selected.

Use the Options button Customize parameters

Available image sets:

  • Kotlin logos
  • Kodee

You can also browse for your own folder of images.

Note: Use a folder with accessible permissions, for example, create a ~/screensaver-images folder, and place your images there. The screen saver looks for PNG and SVG images in the custom folder. Folders located in places like your Downloads folder will likely show their images in the preview, but not work with the actual screen saver. If this happens, try to place the folder in a different location.

Read the blog post

The journey and technical details of creating this screen saver is documented in Building a macOS screen saver in Kotlin on zsmb.co.

Installation

Release builds are currently not signed and notarized, however you can still install these builds by following the steps below. Alternatively, you can build the screensaver from source.

Use an unsigned release build

  1. Download the latest release build from Releases.

  2. Unzip the downloaded file.

  3. Open KotlinLogos.saver, install it as prompted, this will take you to Screen Saver within System Settings.

  4. When selecting the screen saver, you'll be warned that Apple can not check it for malicious software. Choose "OK", and then select another screen saver to stop the popup from repeatedly showing up.

    See image

  5. Go to Privacy & Security in System Settings, scroll down to Security, and click "Open Anyway" under the message about KotlinLogos.saver

    See image

  6. Go back to Screen Saver, select the screensaver again, and choose "Open" which should now be available.

    See image

  7. Enjoy!

Build it yourself

Build the artifact:

cd KotlinLogos
xcodebuild -scheme KotlinLogosRelease build

Then, to install it:

  1. Locate the output file:

    • Open KotlinLogos in XCode, Product -> Show Build Folder in Finder, browse to Products/Debug/KotlinLogos.saver.
    • Full path should be ~/Library/Developer/Xcode/DerivedData/KotlinLogos-[...]/Build/Products/Debug/KotlinLogos.saver.
  2. Install the screensaver by either

    • Opening it to install it in System Settings OR
    • Manually copying it to ~/Library/Screen Savers/