{"id":39926401,"url":"https://github.com/rsevero/mapiah","last_synced_at":"2026-04-04T14:02:56.407Z","repository":{"id":205179891,"uuid":"713609114","full_name":"rsevero/mapiah","owner":"rsevero","description":"Graphical interface for cave mapping with Therion written in Flutter.","archived":false,"fork":false,"pushed_at":"2026-02-24T15:28:31.000Z","size":11113,"stargazers_count":9,"open_issues_count":0,"forks_count":3,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-02-24T15:41:46.176Z","etag":null,"topics":["flutter-app","graphical-user-interface","therion"],"latest_commit_sha":null,"homepage":"","language":"Dart","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/rsevero.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-11-02T21:50:34.000Z","updated_at":"2026-02-24T15:32:25.000Z","dependencies_parsed_at":"2025-11-29T17:07:48.110Z","dependency_job_id":null,"html_url":"https://github.com/rsevero/mapiah","commit_stats":null,"previous_names":["rsevero/mapiah"],"tags_count":52,"template":false,"template_full_name":null,"purl":"pkg:github/rsevero/mapiah","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rsevero%2Fmapiah","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rsevero%2Fmapiah/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rsevero%2Fmapiah/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rsevero%2Fmapiah/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rsevero","download_url":"https://codeload.github.com/rsevero/mapiah/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rsevero%2Fmapiah/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29987656,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-01T22:42:38.399Z","status":"ssl_error","status_checked_at":"2026-03-01T22:41:51.863Z","response_time":124,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["flutter-app","graphical-user-interface","therion"],"created_at":"2026-01-18T18:00:30.300Z","updated_at":"2026-04-04T14:02:56.336Z","avatar_url":"https://github.com/rsevero.png","language":"Dart","readme":"\u003c!-- SPDX-License-Identifier: GPL-3.0-or-later --\u003e\n\u003c!-- Copyright (C) 2023- Mapiah Ltda --\u003e\n# Mapiah\n\n[Free software](https://www.gnu.org/philosophy/free-sw.en.html) graphical interface for [Therion](https://therion.speleo.sk/) cave mapping written in [Flutter](https://flutter.dev/).\n\n## Main objectives\nUser-friendly interface to the powerful Therion mapping software.\n\nAs an intended side effect, it aims to completely replace xTherion, the venerable but ostensibly ancient Therion graphical interface.\n\nAlso create a thriving community of users and developers to make it as powerful and user friendly as such community needs and creates.\n\n## Interesting characteristics\n* Visually distinguish all point, line, and area types supported by Therion.\n* Graphical interface for editing all supported options of points, lines, and areas supported by Therion.\n* Multiple mouse and keyboard pan and zoom options.\n* On save, original file lines are only changed if an actual edit modified them, which facilitates version control management.\n* Uses Therion as the source of truth regarding supported features; i.e., if Therion supports it, Mapiah should support it as well.\n  * As a secondary effect, tries to update and detail the Therion Book so it better reflects Therion features.\n* Equivalent versions for Linux, MacOS and Windows.\n* Unlimited undo/redo.\n* Redos available after some undos and new actions merged in the undo queue.\n\n## Current status\nWith the release of version 0.3.0, Mapiah is considered to have reached \"real editing\" full capabilities.\n\nMapiah is in fast development stage, but it is already usable for real mapping work. It is being used by the author and some other people to map real caves, and it is already being used in some caving courses.\n\nIf you have TH2 files you want to edit and want to give Mapiah a try, please do. If you find any issue, please report it as a [Mapiah Issue](https://github.com/rsevero/mapiah/issues).\n\nLinux AppImage and Flatpak/Flathub and Windows versions are being used regularly. MacOS version lacks a developer with MacOS to properly test it.\n\n## Installation\n\n### Linux\n\n#### AppImage\nAvailable at [Mapiah releases](https://github.com/rsevero/mapiah/releases).\n\n#### Flatpak\nMapiah Flatpak version moved back to manual Flatpak distribution.\n\nThis was necessary because running Therion from a Flathub distributed package is a nightmare. I am sorry from the trouble. I really hope this issue is definitely solved now.\n\nTo go back to non Flathub packages:\n\n```bash\nflatpak remove io.github.rsevero.mapiah\nflatpak install --user --from https://flatpak.mapiah.org/org.mapiah.mapiah.flatpakref\n```\n\nIf you have already installed the non-Flathub version, you can update it with:\n\n```bash\nflatpak update org.mapiah.mapiah\n```\n\n##### Install from Mapiah GitHub Pages Flatpak repo\nYou can install using the `.flatpakref` link below:\n`https://flatpak.mapiah.org/org.mapiah.mapiah.flatpakref`\n\nIf that URL returns `404`, wait a few minutes and try again. New releases can take a short time to appear on GitHub Pages.\n\n```bash\n# Option 1: install directly from the generated flatpakref\nflatpak install --user --from https://flatpak.mapiah.org/org.mapiah.mapiah.flatpakref\n\n# Option 2: add the generated repository and install from it\nflatpak remote-add --if-not-exists mapiah https://flatpak.mapiah.org/repo/index.flatpakrepo\nflatpak install --user mapiah org.mapiah.mapiah\n```\n\n#### Other formats\nIf someone is interested in creating Linux packages in other formats like arch, deb, rpm, snap or other package and is interested in my help, please contact me at rsev AT pm.me.\n\n### MacOS\nAvailable at [Mapiah releases](https://github.com/rsevero/mapiah/releases).\n\nAs Mapiah has no Apple compatible signing yet its necessary to allow special permission to run Mapiah in MacOS: [Open Any Way](https://support.apple.com/en-us/102445#openanyway)\n\n### Windows\nAvailable at [Mapiah releases](https://github.com/rsevero/mapiah/releases).\n\nApparently Microsoft Defender is keen on flagging unknown executables as having some kind of malware. Sometimes as [Bearfoos.A!ml](https://answers.microsoft.com/en-us/windows/forum/all/bearfoosaml-false-alarm/37707c6a-8222-44ad-a604-d75918dfb519), sometimes as [Trojan:Win32/Wacatac.B!ml](https://github.com/flutter/flutter/issues/118430). Maybe others.\n\nIf you want to be extra sure, you can check Mapiah's setup exe file with some online virus scanner service before installing it.\n\n## Reporting bugs\n\nAs is probably the case in all Free Software projects, the developers of Mapiah aim to produce completely bug-free software. As it happens in all software, they fail.\n\nPlease register bugs and enhancement suggestions as a [Mapiah Issue](https://github.com/rsevero/mapiah/issues).\n\nWhen reporting bugs, please consider the following advice, which tries to make everybody happier:\n\n* Check if the behavior you are identifying as a bug is actually a bug. For applicable types of issues, remember that Mapiah treats Therion as the 'source of truth.'\n* If applicable, check if the Therion Book clearly defines the behavior you are expecting. If not, please consider submitting an update for the Therion Book.\n* Remember that it is almost impossible for a developer to fix an issue the developer can't reproduce or at least see. To help with that, you can (should?):\n  * Provide detailed steps explaining how to reproduce the bug;\n  * Provide minimal files necessary to reproduce the bug;\n  * Provide videos showing the bug (especially recommended for interaction-related issues);\n  * Any other info that might help the developers visualize the issue you are reporting.\n\nIf you have some free time and want to see the above recommendations more extensively described, read [How to Report Bugs Effectively](https://www.chiark.greenend.org.uk/~sgtatham/bugs.html). I read it a few decades ago and am still impacted.\n\n## Changelog and Roadmap\n\n[Changelog](https://github.com/rsevero/mapiah/blob/main/CHANGELOG.md)\n\n[Roadmap](https://github.com/rsevero/mapiah/blob/main/ROADMAP.md)\n\n## Name origin\n\n_Mapiah_ comes from the (Brazilian) Portuguese word _mapear_.\n\nIn Portuguese, _Let's go mapping?_ is _Vamos mapear?_\n\nIn Brazil, it is usually pronounced as _Vâmu mapiá?_\n\nAs the internet doesn't deal well with accents, _mapiá_ became _mapiah_.\n\n## Meta\n\nRodrigo Severo – rsev AT pm.me\n\nDistributed under the GNU GPL 3 license. See [LICENSE](https://github.com/rsevero/mapiah/blob/main/LICENSE.md) for more information.\n\n[https://github.com/rsevero/mapiah](https://github.com/rsevero/mapiah)\n\n## Contributing\n\n1. Fork it (\u003chttps://github.com/rsevero/mapiah/fork\u003e)\n2. Create your feature branch (`git checkout -b feature/fooBar`)\n3. Commit your changes (`git commit -am 'Add some fooBar'`)\n4. Push to the branch (`git push origin feature/fooBar`)\n5. Create a new Pull Request\n","funding_links":[],"categories":["Surveying software"],"sub_categories":["Data management and sketching"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frsevero%2Fmapiah","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frsevero%2Fmapiah","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frsevero%2Fmapiah/lists"}