Visualize your Moves app location history
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
maps
screenshots
src
themes
.eslintrc.yml
.gitignore
.npmignore
LICENSE.md
README.md
package-lock.json
package.json

README.md

Moves App Visualizer

Create visualizations from your Moves App location history.

Installation

Install the command line client via NPM:

npm install -g @claygregory/moves-viz

Usage

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

Map

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

License

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