{
  "id": "map-tiles-downloader",
  "name": "Map Tiles Downloader",
  "short_name": "mt-downloader",
  "kind": "utility",
  "status": "active",
  "maturity": "stable",
  "description": "Cross-platform terminal utility for downloading selected OpenStreetMap or Thunderforest areas for offline use in MeshCore and Meshtastic apps, with interactive region selection, size estimates and automation subcommands.",
  "image": "icon.png",
  "screenshots": [
    {
      "file": "screenshot.png",
      "caption": "Interactive offline map region downloader"
    }
  ],
  "maintainers": [
    {
      "name": "tekk",
      "url": "https://github.com/tekk"
    }
  ],
  "repository": "https://github.com/tekk/map-tiles-downloader",
  "license": "CC-BY-4.0",
  "languages": [
    "python"
  ],
  "platforms": [
    "linux",
    "macos",
    "windows",
    "docker"
  ],
  "interfaces": [
    "tui",
    "cli"
  ],
  "capabilities": [
    "mapping"
  ],
  "install": [
    {
      "type": "pypi",
      "package": "mt-downloader",
      "url": "https://pypi.org/project/mt-downloader/",
      "command": "pipx install mt-downloader"
    },
    {
      "type": "github-release",
      "url": "https://github.com/tekk/map-tiles-downloader/releases"
    },
    {
      "type": "docker",
      "url": "https://github.com/tekk/map-tiles-downloader",
      "command": "docker build -t mt-downloader ."
    },
    {
      "type": "source",
      "url": "https://github.com/tekk/map-tiles-downloader"
    }
  ],
  "popularity": {
    "githubStars": 30,
    "githubForks": 3,
    "githubWatchers": 0,
    "githubOpenIssues": 5,
    "githubContributors": 2,
    "releaseDownloads": 1026,
    "latestReleaseDownloads": 0,
    "lastChecked": "2026-06-23"
  },
  "verification": {
    "sourceAvailable": true,
    "releasesAvailable": true,
    "signedReleases": false,
    "ciBuilds": true,
    "hasDocumentation": false,
    "lastChecked": "2026-06-23"
  },
  "tags": [
    "offline-maps",
    "map-tiles",
    "openstreetmap",
    "meshtastic"
  ],
  "last_reviewed": "2026-06-23",
  "source": {
    "path": "data/software/map-tiles-downloader/software.yaml",
    "updatedAt": "2026-06-24T05:12:55+02:00"
  },
  "latest_version": "1.3.6",
  "released": "2026-05-11",
  "releases": [
    {
      "version": "v1.3.6",
      "name": "v1.3.6",
      "datetime": "2026-05-11T14:03:18Z",
      "url": "https://github.com/tekk/map-tiles-downloader/releases/tag/v1.3.6",
      "prerelease": false,
      "notes": "Bug fix release: force UTF-8 stdio so `mt-downloader list regions` and other commands work on Windows consoles (which default to cp1252 and could not encode non-ASCII region names like *Łódź* or *Kočovce*).",
      "notesHtml": "<p>Bug fix release: force UTF-8 stdio so <code>mt-downloader list regions</code> and other commands work on Windows consoles (which default to cp1252 and could not encode non-ASCII region names like <em>Łódź</em> or <em>Kočovce</em>).</p>\n"
    },
    {
      "version": "v1.3.5",
      "name": "v1.3.5",
      "datetime": "2026-05-11T11:42:28Z",
      "url": "https://github.com/tekk/map-tiles-downloader/releases/tag/v1.3.5",
      "prerelease": false,
      "notes": "Patch release. Documentation: README now describes the region-name behavior introduced in v1.3.4.",
      "notesHtml": "<p>Patch release. Documentation: README now describes the region-name behavior introduced in v1.3.4.</p>\n"
    },
    {
      "version": "v1.3.4",
      "name": "v1.3.4",
      "datetime": "2026-05-11T11:03:48Z",
      "url": "https://github.com/tekk/map-tiles-downloader/releases/tag/v1.3.4",
      "prerelease": false,
      "notes": "Show human-readable region names in country menus.\n\nResolves admin1 codes to real names where possible:\n- US states via geonamescache's get_us_states()\n- Other countries: each admin1 is labeled with its most populous city (e.g. \"08 (around Toronto)\"), making the geonames adm1 numbers identifiable.\n\nFixes #3.",
      "notesHtml": "<p>Show human-readable region names in country menus.</p>\n<p>Resolves admin1 codes to real names where possible:</p>\n<ul>\n<li>US states via geonamescache's get_us_states()</li>\n<li>Other countries: each admin1 is labeled with its most populous city (e.g. \"08 (around Toronto)\"), making the geonames adm1 numbers identifiable.</li>\n</ul>\n<p>Fixes #3.</p>\n"
    },
    {
      "version": "v1.3.3",
      "name": "v1.3.3",
      "datetime": "2025-10-09T11:08:27Z",
      "url": "https://github.com/tekk/map-tiles-downloader/releases/tag/v1.3.3",
      "prerelease": false,
      "notes": "**Full Changelog**: https://github.com/tekk/map-tiles-downloader/compare/v1.3.2...v1.3.3",
      "notesHtml": "<p><strong>Full Changelog</strong>: <a href=\"https://github.com/tekk/map-tiles-downloader/compare/v1.3.2...v1.3.3\" target=\"_blank\" rel=\"noopener noreferrer\">https://github.com/tekk/map-tiles-downloader/compare/v1.3.2...v1.3.3</a></p>\n"
    },
    {
      "version": "v1.3.2",
      "name": "v1.3.2",
      "datetime": "2025-10-09T10:58:42Z",
      "url": "https://github.com/tekk/map-tiles-downloader/releases/tag/v1.3.2",
      "prerelease": false,
      "notes": "**Full Changelog**: https://github.com/tekk/map-tiles-downloader/compare/v1.3.1...v1.3.2",
      "notesHtml": "<p><strong>Full Changelog</strong>: <a href=\"https://github.com/tekk/map-tiles-downloader/compare/v1.3.1...v1.3.2\" target=\"_blank\" rel=\"noopener noreferrer\">https://github.com/tekk/map-tiles-downloader/compare/v1.3.1...v1.3.2</a></p>\n"
    },
    {
      "version": "v1.3.1",
      "name": "v1.3.1",
      "datetime": "2025-10-09T09:01:30Z",
      "url": "https://github.com/tekk/map-tiles-downloader/releases/tag/v1.3.1",
      "prerelease": false,
      "notes": "**Full Changelog**: https://github.com/tekk/map-tiles-downloader/compare/v1.3.0...v1.3.1",
      "notesHtml": "<p><strong>Full Changelog</strong>: <a href=\"https://github.com/tekk/map-tiles-downloader/compare/v1.3.0...v1.3.1\" target=\"_blank\" rel=\"noopener noreferrer\">https://github.com/tekk/map-tiles-downloader/compare/v1.3.0...v1.3.1</a></p>\n"
    },
    {
      "version": "v1.3.0",
      "name": "v1.3.0",
      "datetime": "2025-10-09T08:46:40Z",
      "url": "https://github.com/tekk/map-tiles-downloader/releases/tag/v1.3.0",
      "prerelease": false,
      "notes": "**Full Changelog**: https://github.com/tekk/map-tiles-downloader/compare/v1.2.9...v1.3.0",
      "notesHtml": "<p><strong>Full Changelog</strong>: <a href=\"https://github.com/tekk/map-tiles-downloader/compare/v1.2.9...v1.3.0\" target=\"_blank\" rel=\"noopener noreferrer\">https://github.com/tekk/map-tiles-downloader/compare/v1.2.9...v1.3.0</a></p>\n"
    },
    {
      "version": "v1.2.9",
      "name": "v1.2.9",
      "datetime": "2025-10-09T08:41:30Z",
      "url": "https://github.com/tekk/map-tiles-downloader/releases/tag/v1.2.9",
      "prerelease": false,
      "notes": "**Full Changelog**: https://github.com/tekk/map-tiles-downloader/compare/v1.2.8...v1.2.9",
      "notesHtml": "<p><strong>Full Changelog</strong>: <a href=\"https://github.com/tekk/map-tiles-downloader/compare/v1.2.8...v1.2.9\" target=\"_blank\" rel=\"noopener noreferrer\">https://github.com/tekk/map-tiles-downloader/compare/v1.2.8...v1.2.9</a></p>\n"
    },
    {
      "version": "v1.2.8",
      "name": "v1.2.8",
      "datetime": "2025-10-09T08:19:37Z",
      "url": "https://github.com/tekk/map-tiles-downloader/releases/tag/v1.2.8",
      "prerelease": false,
      "notes": "**Full Changelog**: https://github.com/tekk/map-tiles-downloader/compare/v1.2.7...v1.2.8",
      "notesHtml": "<p><strong>Full Changelog</strong>: <a href=\"https://github.com/tekk/map-tiles-downloader/compare/v1.2.7...v1.2.8\" target=\"_blank\" rel=\"noopener noreferrer\">https://github.com/tekk/map-tiles-downloader/compare/v1.2.7...v1.2.8</a></p>\n"
    },
    {
      "version": "v1.2.6",
      "name": "v1.2.6",
      "datetime": "2025-10-08T14:33:07Z",
      "url": "https://github.com/tekk/map-tiles-downloader/releases/tag/v1.2.6",
      "prerelease": false,
      "notes": "**Full Changelog**: https://github.com/tekk/map-tiles-downloader/compare/v1.2.5...v1.2.6",
      "notesHtml": "<p><strong>Full Changelog</strong>: <a href=\"https://github.com/tekk/map-tiles-downloader/compare/v1.2.5...v1.2.6\" target=\"_blank\" rel=\"noopener noreferrer\">https://github.com/tekk/map-tiles-downloader/compare/v1.2.5...v1.2.6</a></p>\n"
    }
  ],
  "changelogSource": "github",
  "changelogUpdatedAt": "2026-06-23T22:03:44.430Z"
}