Visualizes Moves App location history


0.3.03 years ago4 years agoMinified + gzip package size for @claygregory/moves-viz in KB


Moves App Visualizer

Create visualizations from your Moves App location history.


Install the command line client via NPM:

npm install -g @claygregory/moves-viz


First, you'll need your Moves App export, extracting the JSON archive for the storyline.json of interest. For example, use [export]/json.zip/full/storyline.json to visualize your complete location history.

As a command-line app, basic usage takes the form:

moves-viz [command] path/to/storyline.json path/to/output-image.png


Plot an overview map of your travels using default settings using the map command:

moves-viz map storyline.json map.png

Or customize the map output, selecting a color theme and map projection:

moves-viz map --projection conic-conformal --theme solarized --height 900 --width 1600 storyline.json map.png

Additional options can be found via moves-viz map --help.

Small Multiple Cities

Plot a city-based small multiples grid, inspired by Nicholas Felton's GPX Map Mosaic, using the cities command:

moves-viz cities storyline.json cities.png

Or customize the cities output, selecting a theme and limiting display to the top 10 cities:

moves-viz cities --theme solarized --limit 10 --height 600 --width 1500 storyline.json cities.png

Additional options can be found via moves-viz cities --help.

Color Themes

Use --theme to select from the below color palettes.

Name --theme Example Description
Accent accent Based on the Color Brewer Accent palette
Default default Based on the D3 Category10 palette
Pastel pastel Based on the Color Brewer Pastel1 palette
Set1 set1 Based on the Color Brewer Set1 palette
Solarized solarized Based on Ethan Schoonover's Solarized palette

Output Format

A PNG file is created by default. If you'd like an SVG, use --format svg.

Output Size

You can control the height/width of the output image with --height <size-in-pixels> and --width <size-in-pixels>.

Filter Date Range

Filter your activity to a specific date/time range using --start-date <date-optional-time> and --end-date <date-optional-time>. The dates should be specified in ISO8601 format; time is optional.

Additional Help

To discover basic command and usage information:

moves-viz --help

Include the command to see all available options:

moves-viz [command] --help


See the included LICENSE for rights and limitations under the terms of the MIT license.

If you find any bugs or have a feature request, please open an issue on github!

The npm package download data comes from npm's download counts api and package details come from npms.io.