diff --git a/README.md b/README.md
index 0276be7..9a4c82d 100644
--- a/README.md
+++ b/README.md
@@ -3,6 +3,21 @@
 Extremely simple GPX track viewer, meant to be embedded in article webpages.
 Using [leaflet](https://leafletjs.com/) and OpenStreetMap tiles.
 
+## GPX simplify script
+
+Use python to compress a GPX track using gpxpy and the Ramer–Douglas–Peucker algorithm, optionally removing time. Requires `pip3` to install the necessary packages in the virtual environment before running the first time:
+```
+cd python/
+python3 -m venv .
+python3 -m pip install -r requirements.txt
+```
+Then run with:
+
+```sh
+cd python/
+./gpxsimplify.py -f <filename> -d <max distance in meters, float> -t <optional: remove time points>
+```
+
 ### up next:
 1. setup a self-hosted tile server: https://github.com/Overv/openstreetmap-tile-server (resource heavy) or https://github.com/consbio/mbtileserver meant for lightweight hosts
 2. display GPX track metadata