Free software graphical interface for Therion cave mapping written in Flutter.
User-friendly interface to the powerful Therion 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.
- Visually distinguish all point, line, and area types supported by Therion.
- Graphical interface for editing all supported options of points, lines, and areas supported by Therion.
- Multiple mouse and keyboard pan and zoom options.
- On save, original file lines are only changed if an actual edit modified them, which facilitates version control management.
- Uses Therion as the source of truth regarding supported features; i.e., if Therion supports it, Mapiah should support it as well.
- As a secondary effect, tries to update and detail the Therion Book so it better reflects Therion features.
- Equivalent versions for Linux, MacOS and Windows.
- Unlimited undo/redo.
- Redos available after some undos and new actions merged in the undo queue.
Mapiah 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.
If 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.
Linux AppImage and Flatpak/Flathub and Windows versions are being used regularly. MacOS version lacks a developer with MacOS to properly test it.
Available at Mapiah releases.
Mapiah Flatpak version moved back to Flathub.
If you have previously installed a Flatpak package directly downloaded from Mapiah releases, please uninstall it and install the Flathub version instead. You will need Flathub installed in your system first: Flathub setup instructions.
flatpak remove org.mapiah.mapiah
flatpak install io.github.rsevero.mapiahIf you have already installed the Flathub version, you can update it with:
flatpak update io.github.rsevero.mapiahIf 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.
Available at Mapiah releases.
As Mapiah has no Apple compatible signing yet its necessary to allow special permission to run Mapiah in MacOS: Open Any Way
Available at Mapiah releases.
Apparently Microsoft Defender is keen on flagging unknown executables as having some kind of malware. Sometimes as Bearfoos.A!ml, sometimes as Trojan:Win32/Wacatac.B!ml. Maybe others.
If you want to be extra sure, you can check Mapiah's setup exe file with some online virus scanner service before installing it.
As 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.
Please register bugs and enhancement suggestions as a Mapiah Issue.
When reporting bugs, please consider the following advice, which tries to make everybody happier:
- 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.'
- 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.
- 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?):
- Provide detailed steps explaining how to reproduce the bug;
- Provide minimal files necessary to reproduce the bug;
- Provide videos showing the bug (especially recommended for interaction-related issues);
- Any other info that might help the developers visualize the issue you are reporting.
If you have some free time and want to see the above recommendations more extensively described, read How to Report Bugs Effectively. I read it a few decades ago and am still impacted.
Mapiah comes from the (Brazilian) Portuguese word mapear.
In Portuguese, Let's go mapping? is Vamos mapear?
In Brazil, it is usually pronounced as Vâmu mapiá?
As the internet doesn't deal well with accents, mapiá became mapiah.
Rodrigo Severo – rsev AT pm.me
Distributed under the GNU GPL 3 license. See LICENSE for more information.
https://github.com/rsevero/mapiah
- Fork it (https://github.com/rsevero/mapiah/fork)
- Create your feature branch (
git checkout -b feature/fooBar) - Commit your changes (
git commit -am 'Add some fooBar') - Push to the branch (
git push origin feature/fooBar) - Create a new Pull Request