A menu bar app that shows one quote a day from goodthoughts and sets it as your desktop wallpaper with one click.
The wallpapers are drawn by the goodthoughts site, which publishes them with a JSON feed at https://goodthoughts.page/wallpapers.json. The app reads the feed, works out today's quote from the date, and applies its image to each screen. Every Mac gets the same quote on the same day.
Note
macOS has no public way to set the wallpaper on every Space, so Apply changes the current desktop only.
- Download
goodthoughts-<version>.dmgfrom Releases, open it, and drag GoodThoughts to Applications. - Open it from Applications. The app isn't notarised by Apple (there's no paid developer account behind it), so macOS stops it the first time:
- macOS 15 Sequoia and later: macOS says it couldn't verify the app. Click Done, then open System Settings → Privacy & Security, scroll to Security, click Open Anyway next to "GoodThoughts was blocked", and confirm with your password.
- macOS 13 Ventura and 14 Sonoma: Control-click GoodThoughts in Applications, choose Open, then Open again.
- Click the g in the menu bar, then the gear (or press ⌘,) for settings. Turn on Open at login and Set each morning there if you want a new wallpaper every day.
- Optionally, turn on Reminder and pick a time (09:00 by default) to get a notification with the day's quote. Click it to open the quote's page. It comes once a day, or you can have it send more quotes from the feed every 1 to 6 hours until a time you choose (21:00 by default). macOS asks for permission the first time; if you say no, the settings page links to System Settings → Notifications.
You only do this once. After that the app updates itself: it checks once a day and asks before installing, or click Updates in the popover.
Note
On privacy: the app runs in the macOS App Sandbox with no access beyond outgoing network connections. It contacts goodthoughts.page for the quotes and wallpapers, and github.com to check for updates, and sends nothing about you or your Mac. Reminders are local notifications scheduled on your Mac up to a week ahead from the saved quotes; nothing extra is sent anywhere. Every update is checked against the project's signing key before it's installed. You can read all of the code here.
- macOS 13 Ventura or later
- To build: Xcode 16 or later and XcodeGen (
brew install xcodegen)
The Xcode project is generated from project.yml and isn't committed.
xcodegen generate
open GoodThoughts.xcodeprojOr from the command line:
xcodebuild build -project GoodThoughts.xcodeproj -scheme GoodThoughts -destination 'platform=macOS'
xcodebuild test -project GoodThoughts.xcodeproj -scheme GoodThoughts -destination 'platform=macOS'Tip
Run xcodegen generate again after pulling changes to project.yml or adding files.
Without Xcode, scripts/run.sh builds the app with the Command Line Tools and opens it. It needs XcodeGen too. That build leaves out Sparkle, which comes in as a Swift package only Xcode can link.
The menu bar icon is generated from the brand mark by swift scripts/make-menubar-icon.swift. Rerun it and commit MenuBarIcon.pdf when the mark changes.
project.yml: the XcodeGen spec for the app and test targetsGoodThoughts/: the app, with bundled fonts and the icon inResources/scripts/: the local run script, the icon and placeholder-wallpaper generators, the.dmgpacker and the appcast writerdocs/RELEASING.md: cutting a release and looking after the update keyGoodThoughtsTests/: unit tests.github/workflows/ci.yml: builds (Debug and Release) and tests on a macOS runner for pull requests andmain.github/workflows/release.yml: publishes a.dmgand the Sparkle appcast when av*tag is pushed
Feature complete for a first release. The app reads the live feed at https://goodthoughts.page/wallpapers.json. Debug builds fall back to a bundled sample feed with placeholder wallpapers only when there's no network and no cached feed.