pull/this/repo
RepoMac and Windows utilities#macos#live-wallpaper#threejs#open-source

Deskworlds: free living 3D wallpapers for your Mac

By Pull This RepoPosted 4 min read

Short answer

Deskworlds is a free, MIT-licensed app that turns your Mac wallpaper into one of seven small living 3D worlds, such as a koi pond, a coral reef or a bonfire. The creatures react to your cursor and you feed them from the menu bar. It needs macOS 13 or newer, and there is no app download yet: you build it with a few Terminal commands.

Deskworlds turns your Mac desktop into a tiny living 3D world. Pick a koi pond and your cursor becomes a fingertip in the water: it leaves ripples, a koi drifts over if you hold still, and the fish scatter if you swipe fast. Click Feed and the whole pond races for the food. It is free and open source, and it is a Mac answer to Wallpaper Engine, which is Windows only.

What is Deskworlds?

Deskworlds is an open source project by chaseleantj, released under the MIT licence. In the README's words, it "puts a small living 3D world on your Mac desktop". The world draws on top of your normal desktop picture, which is not changed, and your icons and clicks keep working. Everything runs locally with Three.js and WebGL2, with no account, analytics or internet connection.

The repo was created on 18 September 2026 and had 469 stars when we checked on 18 November 2026.

Which worlds come with Deskworlds?

There are seven:

WorldWhat reacts
Riverbedfish you can feed
Coral reefreef fish you can feed
Bettaa betta that turns to watch a moving cursor
Plasma globelightning that reaches for your cursor
Koi pondkoi that come close, startle and race for food
Bonfireflames and sparks you can stir up
Lake stormholiday lights along the rail you can switch on

The cursor behaviours in the table come from the project's scene code and from what we saw running each world in the hosted gallery.

How do you install Deskworlds on a Mac?

You build it yourself; there is no ready-made app to download yet. You need macOS 13 or newer. In Terminal, first install Apple's free command line tools, skipping this if you already have them:

terminal
xcode-select --install

Then download the project and run the installer from inside it:

terminal
git clone https://github.com/chaseleantj/deskworlds.git
cd deskworlds
sh wallpaper/install.sh

The installer compiles the app, puts it at ~/Applications/Deskworlds.app and adds a login item so it starts with your Mac. The README says the first frame takes about 20 seconds to appear.

If the installer says swiftc is missing, the command line tools did not finish installing. Run xcode-select --install again and wait for Apple's installer window to complete.

To update, run git pull in the deskworlds folder, then the installer again. To remove it completely:

terminal
sh wallpaper/uninstall.sh

What can you do from the menu bar?

Everything lives behind the small Deskworlds icon in your menu bar. Based on the app's source:

  • World switches between the seven worlds.
  • Feed drops a pinch of food in the fish worlds. The same slot becomes Stir the Fire in Bonfire and Holiday Lights in Lake storm.
  • Pause freezes the world; choose it again to resume.
  • A status line at the top says why the world is still, for example Paused, Low Power Mode or screen off.
  • Quit stops the wallpaper until your next login.

If Reduce Motion is on in your Accessibility settings, Deskworlds starts paused. Choose Pause again to wake it.

Does Deskworlds use a lot of battery?

It is built to back off. The README says it lowers its frame rate on battery or when windows cover the desktop, and stops completely when the desktop is hidden, the screen is locked or Low Power Mode is on. It reads your cursor position and window sizes to do this, but does not record keystrokes or ask for special permissions. A 3D scene is still running, so on a laptop expect some extra drain.

Can you try Deskworlds in a browser first?

Yes, and it is the quickest way to pick a world. Every world runs in any browser with WebGL2 at the hosted gallery. Click the scene to drop food, press Space to pause, F for full screen and H to hide the controls; the menu at the top right switches worlds. To run the gallery locally with Node.js 20 or newer:

terminal
npm start

Then open http://127.0.0.1:8080.

What is the catch?

  • Mac only for the wallpaper itself. On Windows or Linux you can still run the worlds in a browser.
  • No app download. You build it in Terminal with Apple's command line tools.
  • Battery. The slowdowns help, but it is a live 3D scene.
  • Quiet repo. The last push was 22 October 2026 and there are no tagged releases, so updates come through git pull.

How does Deskworlds compare with other live wallpapers?

AppPriceRuns onNotes
Deskworldsfree, MITmacOS 13+seven interactive 3D worlds, built from source
Wallpaper EngineUS$4.99 on SteamWindows 10 and 11the famous paid one
Lively Wallpaperfree, GPL-3.0Windows 10 and 11videos, web pages and interactive wallpapers
Komorebifree, GPL-3.0Linuxanimated and video wallpaper manager
linux-wallpaperenginefree, GPL-3.0Linuxplays Wallpaper Engine wallpapers, but needs the files from a Steam copy

The Wallpaper Engine price and platforms are from its Steam US store page, read on 15 November 2026.

Who is Deskworlds for?

It suits Mac users who want a desk that feels alive without paying or installing a heavy app, and anyone curious how far Three.js can go in a few small scenes. Developers get a clean example too: each world lives in its own folder under scenes/, with no dependencies to install.

If you like code-drawn worlds, see Web Ocean, a whole ocean simulated in one web page, and Abyssal Garden, an underwater world drawn entirely in code. For tidying the rest of your Mac, DiskWise is a free cleaner.

What did we run for the video?

We ran every world in the authors' hosted browser gallery, clicking to feed the koi and moving the cursor over the plasma globe, and captured that. The real Mac desktop shot is the authors' own README video. We did not build or install the Mac app, so the install and menu steps here come from the README, the install script and the app's source.

Pull it. Stash it.

Questions people ask

Is there a Wallpaper Engine for Mac?

Wallpaper Engine itself runs on Windows 10 and 11 only, according to its Steam store page, where it cost US$4.99 when we checked on 15 November 2026. Deskworlds is a free, open source way to get a living, interactive wallpaper on a Mac running macOS 13 or newer.

Is Deskworlds free?

Yes. It is open source under the MIT licence, with no account, no analytics and no internet connection needed. Everything runs locally with Three.js and WebGL2.

Does Deskworlds drain my MacBook battery?

It tries not to. The README says it lowers its frame rate on battery or when windows cover the desktop, and stops when the desktop is hidden, the screen is locked or Low Power Mode is on. It is still a 3D scene, so expect some extra battery use.

Can I try Deskworlds without installing it?

Yes. Every world runs in any browser with WebGL2 at the project's hosted gallery, chaseleantj.github.io/deskworlds. That works on Windows and Linux too, though only the Mac app sets it as your wallpaper.

Does Deskworlds need special permissions?

No. The README says it reads your cursor position and window sizes, but does not record keystrokes or request any special permissions. Desktop icons and clicks keep working as usual.

Sources

  1. 1deskworlds repository and README
  2. 2Deskworlds hosted browser gallery
  3. 3Deskworlds menu bar app source (wallpaper/Wallpaper.swift)
  4. 4GitHub API: chaseleantj/deskworlds (stars, licence, language, created date, checked 2026-11-18)
  5. 5Wallpaper Engine on the Steam US store (price and platforms, read 2026-11-15)
  6. 6rocksdanister/lively
  7. 7christianloopp/komorebi
  8. 8Almamu/linux-wallpaperengine

Get tomorrow's repo in your feed

One free, open source repo a day as a short video, shown working, with the catch named. Pull it. Stash it.