Mapiah
User friendly multiplatform Therion map editor
Mapiah developers ✓ Verified
io.github.rsevero.mapiahUser-friendly multiplatform interface to the powerful Therion cave mapping software.
As an intended side effect, it aims to completely replace xTherion, the venerable but ostensibly ancient Therion graphical interface.
Also create a thriving community of users and developers to make it as powerful and user friendly as such community needs and creates.
Screenshots
Observed history
| App | Change | Version | When ↓ |
|---|
No observed changes yet.
The initial import establishes a baseline. Future version changes will appear here.
Browse the app catalogue →Upstream releases
Release notes supplied by the developer. These dates are not Flathub package publication times.
0.3.09 Mar 2026
0.3.0 - 2026-03-09 - The Great Fanfarra release
New features:
- Include contents of 'therion.log' file at end of Therion output.
- If there are more than 3 newer versions available, warn the user of the newer versions on all runs instead of just showing the "New version available" dialog once a day.
- At the "Therion run" window, create a "Run Therion" button. [requested by Edvard]
- Enable shortcuts Esc, Ctrl+T and T at "Therion run" window.
- Adding start and end time at Therion run output.
- When creating a point or a line point, it should snap to near elements.
- When clicking on an area, Ctrl (or Meta+Click) selects the area (and not the line), Shift+Ctrl+Click (or Meta+Shift+Click) selects the line (and not the area).
- Created keyboard shortcut Ctrl+X that creates a "Map connection" line between the "section" point and the "base" point the section refers to. [requested by Edvard]
- At flathub_disable.md, explain why Flathub version is being disabled.
- At "newer versions available" page, also show how many commits and how many days the users installed version is old.
- Release name and URL at About dialog.
Fixed bugs:
- Newer version available window not appearing in Flathub version.
- On very fast Therion executions, therion.log file content not being included in Therion run output.
- Bézier created from straight lines are too tight.
- Status bar info for selected elements not internationalized.
- Current PLA type at PLA type selection overlay with too small left and bottom margins.
- Zoom to file or to scrap should not consider images not visible.
- When clicking on the name of an image, checkbox is not changed on "available images" dialog box.
Infrastructure maintenance:
- Enabling github created flatpak generation.
- New "New version available" page.
- Created debug new version structure.
- Improving newer version available messages.
- Mapiah constants should start with 'mp' prefix. Save the 'th' prefix for Therion related constants.
- Simplifying and reorganizing code related to Bézier curves and straight line segments simplification and conversion.
- Review portuguese translations of PLA types and subtypes.
- Renaming mpSubtype* localization strings to thSubtype*.
- Included "Used on:..." on translation strings.
- Created scripts/generate_releases_brief.dart and assets/releases/releases_summary.json to speed new version check.
- Including "Accept-Encoding: gzip" on all http requests.
- All clearBoundingBox() calls clear ancestor bounding boxes.
0.2.395 Mar 2026
0.2.39 - 2026-03-05 - The Seeds of Love release
New features:
- Created keyboard shortcuts to run Therion: Ctrl+T (choose THConfig file and run Therion) and T (run Therion).
- Showing PLA type and subtype at PLA overlay window.
- Setting PLA type and subtype at PLA overlay window.
- Element type showing also subtype on multiple elements clicked overlay window.
- Flathub/flatpak release running embedded Therion.
Fixed bugs:
- THConfig select file dialog not accepting common thconfig files. [reported by CaverBruce (issue #16)]
- PLA types of created elements not added as last and most used types.
- Creating new line with a subtype throws.
- Test 3400 failing.
- Test 3500 failing.
- Unknown subtypes shown as internal subtype ID (all user type subtypes).
- Setting subtype should update the last used subtype for the PLA type.
Infrastructure maintenance:
- Converted MPGeneralController to a MobX store.
- Created MPButtonTypes chooseTHConfigAndRunTherion and runTherion to run Therion.
- Created TH2FileEditcontroller.getTHFileWidgetBuildContext().
- Removed unused methods from TH2FileEditElementEditController.
- Created addPoint() method in TH2FileEditElementEditController.
- Monitoring subtypes with last used PLA types.
- flutter upgrade to 3.41.3
- flutter pub upgrade --major-versions
- Embedding Therion (and its dependencies) in Flathub/Flatpak release.
0.2.381 Mar 2026
0.2.38 - 2026-06-01 - The Run therion in Flathub release (not accepted by Flathub)
Fixed bugs:
- Flatpak release not running Therion from Mapiah.
0.2.371 Mar 2026
0.2.37 - 2026-03-01 - The Run Therion release (not sent to Flathub)
New features:
- Created Settings page.
- Settings page with real time per setting type validation.
- Settings page with "reset" button for each setting and for all settings.
- Created new settings type: FilePickerExecutable.
- Running Therion.
- Tracking warnings and errors on Therion run output.
- Debug output on Windows search for therion install info.
- Caching Therion install path on windows on search.
- MacOS Therion runner implementation.
- "Choose THConfig file and run Therion" and "Run Therion" buttons painted red if no Therion found.
- "Choose THConfig file and run Therion" and "Run Therion" buttons directed to appropriate help page in case no Therion is found.
Fixed bugs:
- 'Cancel' button on settings page not closing page.
- Therion run output should be selectable as a whole and not only single lines.
- Therion run output has no line breaks after copy/paste.
- Searching for Therion install path on windows always failing.
- Therion run on Windows.
- Windows tests.
- Set therion path not used on Windows.
- Regression on appLocalizations initialization on MapiahHome.
Infrastructure maintenance:
- Included "Current status" section in README.md. [requested by CaverBruce]
- Included "Choose THConfig and run Therion" and "Run Therion" buttons in both MapiaHome and TH2FileEdit pages.
- Moved business logic of running therion from MPRunTherionDialogWidget to new MPTherionRunner.
- Added MPTherionRunner ok < warning < error escalation test.
- Added multi line selection + clickable warnings and errors test.
- MPTherionRunner checking exit code at end of therion run.
- Fixed therion run for flatpak releases.
- Renamed MPSettingsType -> MPSettingType and MPSettingTypeType -> MPSettingTypeType.
- Renamed MPSettingType -> MPSettingID and MPSettingTypeType -> MPSettingType.
- Unified therion executable path setting and therion executable path for encoding discovery.
- Renamed MPSettingsController.getTYPE -> getTYPEWithDefault.
- Created MPSettingsController.getTYPEIfSet() that returns null if not set.
- Created MPBaseTherionRunner class with getUserDefinedTherionExecutablePath() method.
- therionExecutablePath and preferredExecutablePath from MPTherionRunner not used on Linux.
- Created MPLinuxTherionRunner.


