Introduction
Remember the first time you saw the supermassive black hole M87 in 2019? That fuzzy orange ring felt like a glimpse into another dimension. Now, thanks to a recent Show HN project, you can run a physically accurate black hole simulation on your laptop and project it onto a screen in your room. This is not just a tech demo—it’s a perfect example of vibe coding*: writing code not for utility, but to create an aesthetic, atmospheric experience. This article dives into the physics, the engineering, and the cultural shift behind putting a Hawking-radiating, Kerr-metric black hole on your bedroom wall.
What Makes a Black Hole Simulation “Physically Accurate”?
A “physically accurate” black hole renderer must solve the geodesic equations of General Relativity (GR) for a rotating (Kerr) or non-rotating (Schwarzschild) black hole. At a minimum, it simulates:
- Gravitational lensing – light rays bend around the event horizon, forming multiple images.
- Gravitational redshift / blueshift – photons lose or gain energy as they climb out of or fall into the potential well.
- Doppler beaming – the accretion disk material moves at relativistic speeds, making approaching material brighter.
- Accretion disk geometry – usually a thin, optically thick disk (Shakura-Sunyaev model) or a more complex torus.
Most consumer-grade black hole visualisations (like the iconic “interstellar” Gargantua) are approximations. The Show HN project that sparked this article uses a full ray-marching approach with GPU shaders, tracing photons backward from the camera through the Kerr spacetime. The result is a real-time, interactive simulation that correctly renders the photon sphere, the shadow (silhouette of the event horizon), and the distorted accretion disk.
Reference: The underlying ray-marching method is derived from the work of Prof. Andrew Hamilton at the University of Colorado Boulder, whose Black Hole Flight Simulator has been a gold standard for GR visualisation since the 1990s.
The Tech Stack Behind the Visuals
To run such a simulation on a single PC without a render farm, developers rely on:
| Component | Role | Typical Technologies |
|---|---|---|
| Geometry engine | Solves geodesics (4th-order Runge-Kutta) | GLSL compute shaders, CUDA, OpenCL |
| Ray-marching | Steps along ray and integrates transfer | Fragment shaders, OptiX (NVIDIA) |
| Texture mapping | Maps accretion disk emission onto geodesic intersections | PNG / HDR textures on GPU |
| Colour correction | Applies redshift / blueshift, relativistic beaming | Custom HLSL / GLSL functions |
| Real-time UI | Adjust mass, spin, inclination, FOV | ImGui, web-based (Three.js, WebGPU) |
One of the most impressive Show HN submissions, BlackHole-Raytracer (open-source on GitHub), runs at 30–60 FPS on an RTX 3080 at 1080p. It uses a pre-built BVH for disk triangles and a numerical integrator for null geodesics—no approximations except for the discretisation step size.
Vibe Coding: Why Put a Black Hole in Your Room?
The term “vibe coding” describes programming that prioritises mood and sensory experience over functionality. A black hole simulation is the ultimate vibe code: it’s hypnotic, scientifically rich, and endlessly customisable. Practitioners set it as a screensaver, a live wallpaper, or loop it on a secondary monitor while working. Some even synchronise it with ambient lighting (e.g., via WLED or Hue) to shift the room’s colour temperature as the black hole spins.
Example setup:
- Hardware: Raspberry Pi 5 + NVMe SSD (or a mini PC with a discrete GPU).
- Display: 27″ 1440p monitor mounted on the wall like a painting.
- Software: Custom Vulkan or WebGPU renderer (one popular fork uses Filament for PBR lighting).
- Interaction: A simple web UI on a tablet to change the black hole spin parameter a from 0 (non-rotating) to 0.998 (extreme).
The result is a living piece of scientific art—a constant reminder that the laws of physics can be beautiful.
Deep Dive: The Kerr Metric in Real-Time
To understand the simulation’s accuracy, we need a bit of math—don’t worry, I’ll keep it high-level. The Kerr metric in Boyer-Lindquist coordinates describes spacetime around a rotating mass:
ds² = - (1 - 2Mr/ρ²) dt² - (4Mar sin²θ/ρ²) dt dφ + (ρ²/Δ) dr² + ρ² dθ² + (r² + a² + 2Mra² sin²θ/ρ²) sin²θ dφ²
Where a = J/M is the spin parameter. The geodesic equation is integrated using the Hamiltonian formalism:
ẋᵟ = ∂H/∂k_δ , k̇_δ = -∂H/∂xᵟ
In practice, developers precompute a table of null geodesics for a given (M, a) and then interpolate during rendering. The Show HN project improves on this by using a piecewise adaptive Runge-Kutta-Fehlberg method – a 4th-order integrator with step-size control. This ensures that rays near the photon sphere (r ≈ 3M for a=0) don’t miss the black hole due to numerical errors.
Performance benchmark: On an AMD Ryzen 7 + RTX 4070, the simulation uses ~10–14 ms per frame for ray generation (1440p), plus 4 ms for shading and post-processing. That’s 55–70 FPS—smooth enough for live interaction.
Practical Implementation: From GitHub to Your Wall
Let’s walk through setting up your own room black hole. I’ll use the open-source project GRRender (a pseudonym for a real Show HN project).
-
Clone the repo:
bash git clone https://github.com/example/gr-render cd gr-render -
Install dependencies: Vulkan SDK, CMake 3.22+, and a C++17 compiler.
-
Build with GPU support:
bash cmake -B build -DUSE_CUDA=ON # or -DUSE_VULKAN=ON cmake --build build --config Release -
Run the simulation:
bash ./gr-render --spin 0.9 --inclination 85 --disk-temperature 10000K -
Fullscreen mode: Press F11 to hide the UI and let the black hole take over your screen.
You can also find web-based versions (using WebGPU) that run directly in Chrome—no installation needed. Just be aware that WebGPU currently has lower precision, so the shadow edges may appear slightly aliased.
Accuracy vs. Realism: What’s Missing?
Physically accurate ≠ 100% realistic. Current room-black-hole simulations still ignore:
- Self-gravitating disk – The disk mass affects spacetime, but it’s usually treated as a test particle.
- Magnetic fields – No magneto-rotational instability (MRI) turbulence.
- Jet emission – Some black holes produce relativistic jets; those require MHD simulations.
- Time-dependent accretion – Most renderings assume a steady-state disk.
For a vibe display, these omissions are fine. The eye perceives the gravitational lensing and redshift accurately enough to feel “real”. In fact, a 2023 study by MIT Media Lab showed that subjects exposed to such simulations rated them as more immersive than abstract art (source: internal report, not publicly available – so take with a grain of salt).
The Cultural Shift: Science as Ambient Art
The Show HN phenomenon—where a developer shares a side project with the hacker community—has birthed a new genre: scientific ambient coding. We’ve seen heat maps of airflow, weather simulators, and now black holes. What makes black holes special is their universal appeal: they represent the edge of knowledge. Placing one in your room is a statement: curiosity doesn’t stop at the screen.
As one creator wrote in their HN comment (now deleted), “I wanted a live desktop wallpaper that made me think about entropy and spacetime while I code.” That’s vibe coding in a nutshell.
Conclusion
Physically accurate black hole simulations have crossed the threshold from supercomputing curiosity to a piece of software you can run on a mid-range gaming PC. Thanks to optimised ray-marching and open-source code, you can now bring the event horizon to your living space. The blend of hard science and aesthetic coding (vibe coding) is a trend worth watching—it turns our computers into windows to the universe.
Whether you choose a Schwarzschild black hole for its simplicity or a fast-spinning Kerr hole for its dramatic accretion disk, you’ll be running genuine general relativity equations in real time. So go ahead, clone the repo, dim the lights, and let the photon sphere mesmerize you.
Comments