A fully interactive, real-time 3D Earth wallpaper designed for Wayland/Quickshell. It features accurate celestial mechanics (sun position, sidereal time, moon orbit) and dynamic cloud covers.
- Real-Time Sun & Moon: Accurate celestial tracking based on current UTC time.
- ISS Orbital Mode: After 30 seconds of inactivity, the camera seamlessly transitions into a 5x speed orbit mimicking the International Space Station (51.6° inclination).
- Parallax Background: The background Milky Way stars rotate at a 1:10 parallax ratio, creating deep 3D optical illusions.
- Dynamic Clouds: Cloud maps are generated dynamically based on real-time meteorological data (via
vtexture_server.py).
quickshell(Wayland Desktop Shell)python3(for cloud stitching and asset downloading)curl(used by QML for geolocation)
-
Download Textures The massive 4K/8K textures are ignored from version control to keep the repo lightweight. Run the download script to automatically fetch them from public archives:
python3 download_assets.py
-
Start the Dynamic Texture Server Start the python backend to generate dynamic cloud layers:
python3 vtexture_server.py
-
Launch Quickshell Start the actual UI:
quickshell shell.qml
- Mouse Drag: Rotate the Earth manually.
- Scroll Wheel: Zoom in and out.
- Idle: Stop interacting for 30 seconds to automatically trigger the ISS orbital cinematic flyby.