{"id":20801739,"url":"https://github.com/timschneeb/komootgpx","last_synced_at":"2025-05-07T00:13:27.414Z","repository":{"id":43415586,"uuid":"351948207","full_name":"timschneeb/KomootGPX","owner":"timschneeb","description":"Download Komoot tracks and highlights as GPX files (including metadata). Supports bulk-download","archived":false,"fork":false,"pushed_at":"2025-05-05T20:55:54.000Z","size":62,"stargazers_count":129,"open_issues_count":3,"forks_count":10,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-05-05T21:15:49.089Z","etag":null,"topics":["bulk-download","gps","gpx","komoot","map","outdoor","poi","sports"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/timschneeb.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":"2021-03-27T00:46:24.000Z","updated_at":"2025-05-05T20:55:58.000Z","dependencies_parsed_at":"2024-04-17T16:39:10.501Z","dependency_job_id":"f8fe26cb-4259-4d09-adee-705190a718be","html_url":"https://github.com/timschneeb/KomootGPX","commit_stats":null,"previous_names":["timschneeb/komootgpx","thepbone/komootgpx"],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timschneeb%2FKomootGPX","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timschneeb%2FKomootGPX/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timschneeb%2FKomootGPX/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timschneeb%2FKomootGPX/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/timschneeb","download_url":"https://codeload.github.com/timschneeb/KomootGPX/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252788532,"owners_count":21804284,"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":["bulk-download","gps","gpx","komoot","map","outdoor","poi","sports"],"created_at":"2024-11-17T18:20:36.591Z","updated_at":"2025-05-07T00:13:27.388Z","avatar_url":"https://github.com/timschneeb.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# KomootGPX\nDownload Komoot tracks and highlights as GPX files with metadata\n\n[Python 3 or later](https://www.python.org/downloads/) is required.\n\n## Features\n* Download recorded \u0026 planned trips as GPX files\n* Bulk-download all trips stored in your profile (requires authentication)\n* Includes metadata such as estimated duration, total elevation, difficulty and the original Komoot trip URL\n* Can add trip highlights as POIs into the GPX file\n  * Includes user comments \u0026 image URLs for each highlight POI, as those often contain helpful information about the location\n\n\n## Installation\nDownload from [PyPI](https://pypi.org/project/komootgpx/):\n```\npip install komootgpx\n```\n\n## Testing\nTo run from local clone of repo (without installation):\n```\nuv run python -m komootgpx --help\n```\n\n## Usage\n\n### Run script in interactive mode\n```\nuv run komootgpx\n```\n```\nEnter your mail address (komoot.de)\n\u003eexample@mail.com\n\nEnter your password (input hidden)\nPassword:\n\nLogging in...\nLogged in as 'thepbone'\n\n3331210XX =\u003e Example trip A (hike; 20.766km; tour_recorded)\n3331214XX =\u003e Example trip B (hike; 13.863km; tour_planned)\n\nEnter a tour id to download\n\u003e3331210XX\n\nFetching tours of user '153434028XXX'...\nFetching tour '3331210XX'...\nFetching highlight '2635XX'...\nFetching highlight '15840XX'...\nGPX file written to '~/Development/KomootGPX/Example trip A-3331210XX.gpx'\n```\n\n### Display advanced usage information\n```\nkomootgpx --help\n```\n```\nkomootgpx.py [options]\n[Authentication]\n        -m, --mail=mail_address            Login using specified email address\n        -p, --pass=password                Use provided password and skip interactive prompt\n        -n, --anonymous                    Skip authentication, no interactive prompt, valid only with -d\n\n[Tours]\n        -l, --list-tours                   List all tours of the logged in user\n        -d, --make-gpx=tour_id             Download tour as GPX\n        -a, --make-all                     Download all tours\n        -s, --skip-existing                Do not download and save GPX if the file already exists, ignored with -d\n        -I, --id-filename                  Use only tour id for filename (no title)\n        -D, --add-date                     Add date to file name\n        --max-title-length=num             Crop title used in filename to given length (default: -1 = no limit)\n\n[Filters]\n        -f, --filter=type                  Filter by track type (either \"planned\" or \"recorded\")\n        --start-date                       Filter tours on or after specified date (optional, format YYYY-MM-DD)\n        --end-date                         Filter tours on or before specified date (optional, format YYYY-MM-DD)\n\n[Generator]\n        -o, --output                       Output directory (default: working directory)\n        -e, --no-poi                       Do not include highlights as POIs\n        --max-desc-length=count            Limit description length of POIs in characters (default: -1 = no limit)\n```\n\n### Authentication\nIt's required to be properly authenticated with username (email) and password to perform most of available operations:\n * list user's tours (both planned and completed)\n * download all tours\n * download tour that has Visibility set to \"Only me\" or \"Close friends\"\n\nWithout authentication you can download any tour that is public (i.e. Visibility set to \"Anyone\"). To disable authentication use `--anonymous` option.\n\nIn case given tour id is not available without authentication you'll receive following message: `Error 403: {'status': 403, 'error': 'AccessDenied', 'message': 'Access denied without authentication.'}`.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimschneeb%2Fkomootgpx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftimschneeb%2Fkomootgpx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimschneeb%2Fkomootgpx/lists"}