SumoGUIMac

Native macOS SUMO viewer

SumoGUI Mac

A lightweight SwiftUI + Metal alternative to sumo-gui for opening SUMO scenarios, running or attaching over TraCI, visualizing live traffic, and inspecting the objects that matter.

View on GitHub Build locally
macOS native SwiftUI shell, Metal renderer
TraCI ready Launch or attach to SUMO
Alpha scope Viewer and inspection workflows
MIT Open-source app, SUMO separate

Running live SUMO traffic, not just a mockup.

SumoGUIMac displaying the FlowDemo intersection with live vehicles, sidebars, inspector, and playback controls
FlowDemo running from flowdemo.sumocfg at 154 seconds with 78 live vehicles.

Built for everyday SUMO viewing on macOS.

SumoGUIMac focuses on the workflows researchers and engineers reach for first: open a scenario, watch traffic move, inspect objects, tune visualization, and attach to controller-driven runs.

Open normal SUMO files

Load .sumocfg and .net.xml files, including additional polygons and POIs, without converting projects into a custom format.

Run or attach with TraCI

Launch a local SUMO process or attach as a viewer client to an external run driven by another controller.

Render with Metal

Draw lanes, junctions, live vehicles, selected routes, polygons, POIs, and background decals with a native GPU renderer.

Inspect live objects

Select vehicles and edges, copy identifiers, follow vehicles, highlight routes, set breakpoints, and chart selected-object variables.

Mac-first controls

Use familiar sidebars, inspector tabs, toolbar actions, keyboard shortcuts, Open Recent, and native dark-mode presentation.

Research-friendly licensing

The app is MIT licensed and interoperates with a separately installed Eclipse SUMO runtime over TraCI.

Less surface area than SUMO GUI. More native where it counts.

The alpha is intentionally narrow: a lightweight viewer and inspector, not a full replacement for netedit, 3D mode, detector tooling, or every advanced SUMO GUI panel.

That narrower scope is the point. It gives macOS users a clean way to work with SUMO scenarios when the upstream GUI feels out of place or unreliable on modern systems.

Alpha-ready, with honest edges.

This is ready to present as a lightweight macOS alternative, while staying clear about the pieces that still belong to a later parity pass.

Working now

  • Native app shell with sidebar, map, inspector, toolbar, menus, recent files, and shortcuts.
  • SUMO launch and external TraCI attach for live simulation playback.
  • Metal rendering for roads, junctions, vehicles, selections, routes, polygons, POIs, and decals.
  • Object selection, follow camera, breakpoints, route copy/select, and tracker charts.
  • Visualization settings with lane, vehicle, junction, palette, legend, and XML import/export support.

Still missing

  • Detached tracker windows and arbitrary TraCI variable picking.
  • Large-network profiling, one-hour stability runs, and top hot-path optimization.
  • External multi-client TraCI smoke testing with a controller and viewer order.
  • Developer ID signing, notarization, and release-channel polish.
  • Full SUMO GUI parity areas such as netedit, 3D, detector tooling, and deep person/container views.

Build the current alpha locally.

SumoGUIMac does not bundle Eclipse SUMO. Install SUMO separately, then build the native macOS app from source.

Terminal macOS 14+ / Xcode 15+ 
git clone https://github.com/christofilojohn/SumoMacGUI.git
cd SumoMacGUI
swift test
xcodebuild -project SumoGUIMac.xcodeproj \
  -scheme SumoGUIMacApp \
  -configuration Debug \
  -destination platform=macOS build

Built beside the SUMO ecosystem.

SumoGUIMac interoperates with a user-installed Eclipse SUMO runtime and is not affiliated with or endorsed by the SUMO maintainers. Please credit Eclipse SUMO, the open-source Simulation of Urban MObility project developed primarily by DLR's Institute of Transportation Systems, when using this work in research, demos, or derived projects.

Eclipse SUMO SUMO DOI