Skip to content

About

Turn real streets into animated nightscapes. Create and export wallpapers of your favorite places.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

42 Commits

Folders and files

Repository files navigation

Lumen Streets

Turn a city you love into a living nightscape wallpaper.

Explore in 3D, follow the moving lights and frame a view for your screen.

Try it online · Gallery · Documentation · 繁體中文

Shanghai and the Huangpu River in Lumen Streets

Rendered in Lumen Streets. Map data © OpenStreetMap contributors and Overture Maps; height-source credits are listed in Attribution.

Make it your night

  • Explore in 3D. Start with a featured city or search for a favourite place. Pan, tilt and rotate to find your view.
  • Watch the streets move. Simulated traffic brings the nightscape to life, from busy avenues to quiet waterfronts.
  • Frame your wallpaper. Choose a screen ratio, add a place title and shade an edge to make room for desktop icons. Export a still image or animation.
  • Save and share. Keep your view and traffic in a scene file, send a view link, or embed a nightscape on a website.

From city to wallpaper in 40 seconds

Watch the New York wallpaper walkthrough

On your desktop

Shanghai nightscape used as a Windows desktop wallpaper, with app icons on the shaded left edge

Shanghai · Huangpu River on a Windows desktop. Download a 4K wallpaper or explore the featured cities.

See the wallpaper guide for setup and export options for formats and sizes.

Run locally

Install Git, Node.js 24 and Python 3.12 with pip and venv, then:

git clone https://github.com/Gway0521/lumen-streets.git
cd lumen-streets
npm ci
npm run dev

Open http://127.0.0.1:5180/. The first start prepares an isolated Python environment for building data. To host your own instance, follow Hosting.

Visitors need a WebGL2-capable browser and internet access. Building heights may be estimated; lights and traffic are artistic simulations. See browser compatibility and building data.

Documentation and contributing

Documentation covers wallpaper setup, saved scenes, hosting and development. Bug reports, translations and landmark models are welcome; start with Contributing. Changes are listed in the v0.3.0 release notes.

License

Code: AGPL-3.0-only. OpenStreetMap data: ODbL. Keep source credits with publicly shared exports; see Attribution.

About

Turn real streets into animated nightscapes. Create and export wallpapers of your favorite places.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages