{"id":17184074,"url":"https://github.com/jamesjarvis/mappyboi","last_synced_at":"2025-04-13T18:01:56.088Z","repository":{"id":39272651,"uuid":"319406288","full_name":"jamesjarvis/mappyboi","owner":"jamesjarvis","description":"Let's see if we can build a heatmap?","archived":false,"fork":false,"pushed_at":"2024-10-23T19:59:16.000Z","size":218,"stargazers_count":6,"open_issues_count":4,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-05T22:46:16.256Z","etag":null,"topics":["data-visualization","golang","gpx","heatmap","location-history"],"latest_commit_sha":null,"homepage":"https://jamesjarvis.io/posts/2020/12/map-visualising-location-history/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jamesjarvis.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-12-07T18:18:00.000Z","updated_at":"2024-10-23T19:59:19.000Z","dependencies_parsed_at":"2023-12-09T17:25:23.117Z","dependency_job_id":"09bf52fc-f078-4137-a626-b80a1ec7f814","html_url":"https://github.com/jamesjarvis/mappyboi","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamesjarvis%2Fmappyboi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamesjarvis%2Fmappyboi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamesjarvis%2Fmappyboi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamesjarvis%2Fmappyboi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jamesjarvis","download_url":"https://codeload.github.com/jamesjarvis/mappyboi/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240109566,"owners_count":19749171,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["data-visualization","golang","gpx","heatmap","location-history"],"created_at":"2024-10-15T00:42:21.307Z","updated_at":"2025-02-23T21:31:33.631Z","avatar_url":"https://github.com/jamesjarvis.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📍 Mappyboi\n\n![Heatmap example](https://user-images.githubusercontent.com/22618981/101420497-36556180-38ea-11eb-9417-d25dda5ae421.png)\n\nGenerates a heatmap of where you have been, using data from:\n- Google Takeout (Location History)\n- Apple Health Export\n- Strava (or other assorted .gpx files)\n- Strava (or other assorted .fit files)\n- Polarsteps Data Export\n\n\nIf you have multiple gpx or fit directories, it is recommended to run multiple times, changing the directory path but keeping the same base file.\nOnly new points will be added.\n\n## Installation\n\n```bash\ngo install github.com/jamesjarvis/mappyboi/v2\n```\n\n## Usage\n\n```txt\nUSAGE:\n   mappyboi v2 [global options] command [command options] [arguments...]\n\nAUTHOR:\n   James Jarvis \u003cgit@jamesjarvis.io\u003e\n\nCOMMANDS:\n   help, h  Shows a list of commands or help for one command\n\nGLOBAL OPTIONS:\n   --base_file FILE, --base FILE                        Base location history append only FILE, in .json or .json.gz (by suffixing with .gz mappyboi will compress the resulting file, using significantly less storage)\n   --google_location_history FILE, --glh FILE           Google Takeout Location History FILE\n   --gpx_directory DIRECTORY, --gpxd DIRECTORY          GPX DIRECTORY to load .gpx files from\n   --fit_directory DIRECTORY, --fitd DIRECTORY          FIT DIRECTORY to load .fit files from\n   --polarstep_directory DIRECTORY, --pstepd DIRECTORY  Polarstep DIRECTORY to load locations.json files from\n   --output_type value, --ot value                      Output format, must be one of [ MAP ] (default: \"MAP\")\n   --output_file FILE, --of FILE                        Output FILE to write to\n   --output_reduce_points value, --rp value             If you struggle to open the file in a browser due to too many points, reduce the number of points by increasing this value. (default: 0)\n   --output_randomise_points, --rand                    If you want to export the view of the points, but otherwise randomise the data to prevent perfect tracking, this will randomise the order. (default: false)\n   --output_filter_start_date value, --from value       To filter the output to only include points on or after the provided timestamp\n   --output_filter_end_date value, --to value           To filter the output to only include points on or before the provided timestamp\n   --version, -v                                        print the version\n   --help, -h                                           show help\n```\n\n```bash\nmappyboi \\\n  --base_file all_locations.json \\\n  --google_location_history=\"/path/to/Location History.json\" \\\n  --gpx_directory=\"/path/to/workout-routes\" \\\n  --fit_directory=\"/path/to/workout-routes\" \\\n  --polarstep_directory=\"/path/to/polarsteps\" \\\n  --output_reduce_points 10 --output_randomise_points \\\n  --output_filter_start_date=\"2024-01-01T00:00:01Z\"\n  --output_filter_end_date=\"2024-03-01T00:00:01Z\"\n  --output_type MAP \\\n  --output_file heatmap.html\nopen heatmap.html\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjamesjarvis%2Fmappyboi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjamesjarvis%2Fmappyboi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjamesjarvis%2Fmappyboi/lists"}