Urban Eye 3D is a JOSM plugin that provides a dedicated 3D view (dockable or floating) to visualize loaded buildings and building parts (building=* and building:part=*).

While 3D visualization of OSM data has existed for years through external tools, the absence of a dedicated 3D viewer in JOSM (particularly since the discontinuation of Kenzi 3D) has been a notable gap.

Urban Eye 3D solves this problem! Mappers and 3D building enthusiasts can now preview their edits directly within JOSM before commiting changes to OpenStreetMap.

• 3D visualization of building models according to Simple 3D Buildings specification
• Visualization of Earth surface with flat objects: roads, rivers, grassland and others.
• Intuitive navigation, similar to modern 3D editors:
  • Orbit (left mouse drag)
  • Zoom (mouse wheel)
  • Pan (right mouse drag)
• Two modes: solid and wireframe. Press 'z' to switch between them
• Real-time updates: Changes made in JOSM instantly reflect in the 3D view
• Rendering only – no editing or export functionality

See features.md for the list of supported tags and roof shapes.

• Several roof shapes (mansard, half-hipped and cross_gabled) are supported for quadrilateral polygons only. Support for those roof shapes on arbitrary non-convex polygons may be added in future versions.

Please install Urban Eye 3D just like any other plugin in JOSM:

1. In JOSM, open the menu Edit → Preferences, find the Plugins tab.
2. If needed, hit the "Download list" button,
3. Select the "Available" radio button,
4. Type "urba..." in the search field,
5. Don’t forget to check the box,
6. Enjoy!

As a JOSM plugin written in pure Java, it works perfectly on Windows, Mac, and Linux. Some users have reported problems with graphics drivers on certain Linux distributions, but with Linux, you're on your own :)

Inspired by the GNU GPL-licensed Blosm project and following JOSM's plugin licensing recommendations, this code is licensed under GNU GPL v3.

The licensing for third-party assets used in this project (such as textures) is detailed in the ASSET-LIST.md file.

Contributions are welcome!

• See the the Contribution guide in case you would like to contribute code or artwork.
• You can also contribute to this project by giving us a star :)

The Urban Eye is watching!