Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

2008: OSMaware is a Python command-line tool which takes an OSM .osc file (a change set in OSM map over time) and produces a KML file of the mappers activity.

KMLs are available in three versions:

  • V0 shows only one placemark per user with summary informations and are mainly intended for big files like world day or hour changes.
  • V1 is the most detailed version with one placemark per node but produces big KMLs.
  • V2 shows all the nodes but in the form of polygons instead of placemarks and is "lighter" than V1.


python -i inputfile [-k kmlversion] [-e elevation] [- o outputfile]

  • inputfile is the .osc file or archive (gz or bz2) or an http link to a distant file or archive. If you want to directly use archives and/or distant files on Windows you'll have to put 7zip and/or wget in your folder or path first. Some osc files can be found here.
  • outputfile is an optional name for the output kml (without the .kml extension). By default the kml name as the same name as the .osc file
  • kmlversion is a number which characterized the type of kml produced. 1 (a placemark per node, BIG, default), 2 ("lines",lighter than 1) and 0 (the lightest kml). elevation is a height in meter used in certain kml using lines (0= to the ground). By giving an elevation nodes are visible from further away.


The KML doesn't show ways. It is not intended to help compare or help mapping but just to be "aware" of mappers activity. For legal reasons do not use any data of Google Earth/Google Maps/etc to help you mapping in Open Street Map


"awp.monkey" for a SAX patch (instead of ElementTree? parsing) to allow a smaller memory footprint on big file for OSMAware (see issue1 on project's website)


🌐 Automatically exported from






No releases published


No packages published