Skip to content

About

Deep Field puts a moving space scene behind your windows: a lensed black hole, a spiral galaxy, an aurora seen from orbit, 19 scenes in all. Each one starts from real physics and is drawn like an old screen would draw it, with big pixels and ordered dithering.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

Deep Field: animated space wallpapers for macOS

Black holes, galaxies, auroras and ringed planets, moving on your Mac's desktop as dithered pixel art.
It lives in the menu bar and pauses whenever you can't see it.

The black hole scene: a lensed accretion disk turning

Each scene starts from real physics, like the way a black hole bends light or a galaxy's arms turn, and is drawn the way an old screen would draw it: big pixels, a handful of colors, and ordered dithering. Everything moves, and every so often something happens, like a comet drifting past or a supernova going off in the background.

Install

Download DeepField.dmg from the latest release, open it, and drag Deep Field to Applications. It runs on macOS 14 or later, on Apple silicon and Intel. The app is signed and notarized and updates itself.

The first time you open it, a short guide lets you pick a scene and try a few looks on a large preview. Your desktop doesn't change until you choose Set as Wallpaper at the end. After that Deep Field lives in the menu bar, where you'll find Customize…, Launch at Login and the guide again.

Scenes

Black Hole
Black Hole
A lensed accretion disk and photon ring. Planets bend as they pass behind.
Star Meets Black Hole
Star Meets Black Hole
A star stretched by tides, feeding a glowing stream into the disk.
Wormhole
Wormhole
A window into another universe, with our sky wrapped round its rim.
Binary Stars
Binary Stars
Two real star types in orbit, eclipsing each other.
Trinary Stars
Trinary Stars
A close pair and a distant third, all lighting their planets.
Galaxy
Galaxy
Spiral, barred, elliptical, irregular or ring, turning like the real thing.
Pulsar
Pulsar
A spinning neutron star sweeping its lighthouse beams.
Comet
Comet
Jets from the nucleus, a blue ion tail and a curved dust tail.
Star Close-up
Star Close-up
The edge of a star, with loops, flares and eruptions.
Planetary Nebula
Planetary Nebula
The glowing shell a dying star threw off.
Ringed Planet
Ringed Planet
Rings and planet shadowing each other, with moons passing.
Aurora from Orbit
Aurora from Orbit
Aurora curtains over Earth's night side, real city lights below.
Gas Giant Storms
Gas Giant Storms
Flowing cloud bands and spinning storms, up close.
Protoplanetary Disk
Protoplanetary Disk
A young star in a ringed dusty disk, with planets clearing the gaps.
Neutron Star Merger
Neutron Star Merger
Two neutron stars spiral together and merge in a kilonova, again and again.
Dyson Swarm
Dyson Swarm
A star wrapped in crossing rings of glinting collector panels.
Rogue Planet
Rogue Planet
A dark, sunless world drifting past the Milky Way, its poles aglow.
Eclipse
Eclipse
A total eclipse from another world, with planets and skies you choose.
Quasar
Quasar
A galaxy's blazing core firing jets out to glowing radio lobes.
Black Hole Merger
Black Hole Merger
Two black holes spiral together, bending the starlight behind them, and merge.
Live Earth
Live Earth
Earth right now over a place you pick, with the real Moon, stars, clouds and aurora forecast.

In motion

Star Meets Black Hole loop
Star meets black hole (3x speed)
Pulsar loop
Pulsar, one 3-second rotation
Coronal mass ejection
Star Close-up: a coronal mass ejection (14x)
Comet tail disconnection
Comet: the ion tail breaks off (12x)
Something emerges from the wormhole
Wormhole: something comes out (9x)
A supernova in the background sky
A supernova and its light echo (10x)

Events like these are rare on purpose, a few an hour. You set how often each one happens, and the Show Me button next to it plays one right away.

Make it yours

Click the menu bar icon and choose Customize…. Pick a scene from the gallery, and the panel beside the preview shows everything you can change for it: its shape and motion, its colors, its events and the camera. The other sections cover the background sky, the image (exposure, contrast, bloom and so on) and the pixel look (pixel size, number of colors, dither pattern). Settings save as you go.

Found a look you like? Save it as a preset from the Presets menu in Customize, then switch between your presets from the menu bar icon. Presets export as small .deepfield files you can share, and anyone with Deep Field can import them.

A few more things you can change:

  • Reset next to a scene's name puts that scene's settings and colors back to their defaults.
  • Separate settings for this scene in the Image section gives a scene its own exposure, bloom and pixel look, so a bright scene and a dark one can each look their best.
  • Star field in the Sky section rearranges the background stars, nebulae and galaxies. Type a number to come back to a sky you liked, or press Randomize.
  • Twinkling stars have their own brightness and speed, next to how often they twinkle.

The Customize window, Scene section, with the galaxy selected

Choose a palette preset, or pick every color yourself:

The black hole in the six palette presets

Change the look itself: add bloom or a vignette, use bigger pixels, or turn dithering off.

The same scene with default settings, bloom and vignette, a coarse Bayer 4x4 look, and no dither

Change scenes on a schedule

In the Schedule section of Customize, have Deep Field rotate through your presets and scenes every few minutes or hours (in order or shuffled), or switch at set times on the days you pick, like a calm scene for the workday and something brighter in the evening. Choose how each switch looks: a dithered dissolve, a crossfade, a camera pan, the old scene drifting off into the distance, a warp, a black hole sweeping across that bends one scene into the next, or a random one each time. Turn the schedule on and off, or skip ahead, from the menu bar icon. A Focus filter takes precedence while it's on.

Focus modes and Shortcuts

Deep Field can change with your Focus. In System Settings > Focus, choose a Focus, add a Focus Filter, pick Deep Field, and choose one of your presets or a scene. It switches when the Focus turns on and goes back to how it was when the Focus ends. The same choices are actions in the Shortcuts app (Apply Deep Field Preset and Set Deep Field Scene), for any automation you like.

Command line

Everything above also works from a terminal. Link the deepfield command onto your PATH once:

/Applications/DeepField.app/Contents/MacOS/DeepField install

Then change the wallpaper, its settings and presets, and render stills, videos and time-lapses:

deepfield scene galaxy galaxyType=barred --fade 4 --style warp   # switch, with a transition
deepfield set bloom=0.6 dither=blueNoise palette.core=#ffd27a     # tweak what's showing
deepfield keys                                                    # this scene's settings
deepfield preset apply "Late Night"; deepfield event supernova
deepfield render shot.png --size 5120x2880
deepfield render video loop.mp4 --duration 8 --loop
deepfield render timelapse earth.mp4 --scene liveEarth --speed 3600

Changes go to the running app and show at once; when it isn't running they're saved for its next launch. deepfield help lists every command, and deepfield completion zsh|bash|fish prints tab completion for your shell.

A galaxy with and without dark matter

The same galaxy with and without a dark matter halo, sped up

The Galaxy scene has a dark matter switch. With it on, the outer stars orbit about as fast as the inner ones, which matches what astronomers measure. Turn it off and the outer disk falls behind, which is what we'd expect if visible matter were all there is.

Eclipses from other worlds

Stand on gray rock, ice, rust desert or cracked volcanic basalt, put a gas giant, a ringed giant or a cratered moon in the sky, and give the world an atmosphere if you like.

The eclipse seen from four worlds: gray rock under a teal giant, ice under a ringed giant, a rust desert with an atmosphere, and volcanic basalt with a cratered moon

Black hole mergers, as LIGO hears them

Two black holes spiral together and merge, with the gravitational wave signal drawn along the bottom

Gravitational waves carry off the pair's orbital energy, so the two black holes close in faster and faster, bending the starlight behind them into arcs and a ring. Their shadows stretch toward each other, join, and spin on as one lopsided hole that rings down into a sphere, slowed here so you can watch it. The line along the bottom is the signal a detector would record: the rising chirp, the merger and the ringdown.

Load a real detection, from GW150914 (the first ever heard) to GW231123 (the most massive), to use its masses, spins and viewing angle. Then choose how big the black holes are, which sets what surrounds them:

The black hole merger as a stellar pair in empty space, in a quasar's gas disk, in a star cluster, and as a supermassive pair in a gas disk

Black holes merging inside a star cluster
Intermediate black holes merging in a dense star cluster
Supermassive black holes merging inside a gas disk
Supermassive black holes in the gas disk they've cleared

Phone and lock screen

The Phone section turns the current scene into an iPhone wallpaper, framed so the subject sits below the Lock Screen clock. Save it as a still, or as a Live Photo that you can add straight to Photos. iOS often won't animate Live Photos on the Lock Screen unless they came from the Camera, so expect a still there.

Phone wallpaper exports: black hole, galaxy, pulsar and star close-up

macOS shows a regular desktop picture on the lock and login screens. Turn on Use Scene on Lock Screen and Deep Field sets a still of your scene there too, then puts your old pictures back when you turn it off.

Light on your battery

Deep Field draws at a third of your screen's resolution (so the GPU shades about one pixel in nine) at 24 frames a second, and less in Low Power Mode. It stops entirely when the desktop is covered, when the displays sleep, or when you switch users. Most scenes take under a millisecond of GPU time per frame.

Building from source and contributing

git clone https://github.com/narrowstacks/deep-field.git && cd deep-field
./build.sh && open build/DeepField.app

docs/DEVELOPMENT.md covers the code layout, how the rendering works, the command line tools for snapshots and benchmarks, and how releases are made.

Before your first pull request is merged, you'll be asked to sign the Contributor License Agreement by posting a comment on the pull request. It lets the maintainer keep Deep Field open source while also using contributions in other editions of the app, such as versions for iPhone and Apple TV.

License

Deep Field is free software under the GNU General Public License v3.0. You can use, change and share it, and anything you distribute that's built from it must be under the same license, with its source. The license doesn't cover the name Deep Field, so please give forks their own name.

About

Deep Field puts a moving space scene behind your windows: a lensed black hole, a spiral galaxy, an aurora seen from orbit, 19 scenes in all. Each one starts from real physics and is drawn like an old screen would draw it, with big pixels and ordered dithering.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages