Jump to content

Mepo: Difference between revisions

From postmarketOS Wiki
Milesalan (talk | contribs)
Remove excessive whitespace
Milesalan (talk | contribs)
Add information on integrations & more information on links
Line 6: Line 6:


== Installation ==
== Installation ==
Mepo is available on postmarketOS edge but not on postmarketOS stable currently. The reason for this is that zig (which mepo is written in) is not available on Alpine outside of Alpine's testing repository. On postmarketOS edge you should install one of the following packages:
Mepo is available on postmarketOS edge but not on postmarketOS stable currently. The reason for this is that zig (which mepo is written in) is not available on Alpine outside of Alpine's testing repository. On postmarketOS edge you should install one of the following packages:


Line 18: Line 17:


If you wish to use Mepo on postmarketOS stable you may either use the Mepo Flatpak or pull from the testing alpine repository.
If you wish to use Mepo on postmarketOS stable you may either use the Mepo Flatpak or pull from the testing alpine repository.
== Integrations ==
Mepo integrates with [https://nominatim.org/ Nominatim] and [https://wiki.openstreetmap.org/wiki/Overpass_API Overpass] for POI searches, [https://www.graphhopper.com/ GraphHopper] for routing, and [https://gitlab.freedesktop.org/geoclue/geoclue/-/wikis/home Geoclue] for location services. Unlike other OSM map applications, these integrations take the form of shellscripts (and are thus user-editable) and utilize Mepo's plain-text DSL / API called [http://mepo.milesalan.com/mepolang.html Mepolang]; mepolang can additionally be used by end-users to [http://mepo.milesalan.com/scriptingguide.html create their own custom scripts].


== Pictures ==
== Pictures ==
Line 27: Line 29:


== Links ==
== Links ==
* [https://mepo.milesalan.com Mepo website]
* [https://mepo.milesalan.com Mepo Documentation Website]
* [http://mepo.milesalan.com/installguide.html Mepo Install Guide]
* [http://mepo.milesalan.com/userguide.html Mepo User Guide]
* [https://sr.ht/~mil/mepo Srht Project page]
* [https://sr.ht/~mil/mepo Srht Project page]
* [https://pkgs.alpinelinux.org/package/edge/testing/aarch64/mepo Mepo Alpine Package]
* [https://pkgs.alpinelinux.org/package/edge/testing/aarch64/mepo Mepo Alpine Package]
* [https://mepo.milesalan.com/demos.html Demo Videos]
* [https://mepo.milesalan.com/demos.html Demo Videos showing usage on pmOS phone & screencasts]
* [https://cast.postmarketos.org/episode/15-Interview-Miles-Alan-Sxmo-fbp-Mepo/ postmarketOS podcast discussing Mepo]
* [https://cast.postmarketos.org/episode/15-Interview-Miles-Alan-Sxmo-fbp-Mepo/ postmarketOS podcast discussing Mepo]  


[[Category:Apps]]
[[Category:Apps]]

Revision as of 18:36, 24 October 2022

Alt text
Mepo demo image

Mepo is a fast, simple, and hackable OSM map viewer for desktop & mobile Linux devices (like the PinePhone, Librem 5, pmOS devices etc.) and both environment's various user interfaces (Wayland & X inclusive). Mepo works both offline and online, features a minimalist both touch/mouse and keyboard compatible interface, and offers a UNIX-philosophy inspired underlying design, exposing a powerful command language called Mepolang capable of being scripted to provide things like custom bounding-box search scripts, bookmarks, and more.

Mepo in development was explicitly designed with postmarketOS UI environments as a targeted primary usecase. To this end, Phosh, Sxmo, and Plasma Mobile were all tested in development and work well with Mepo. Additionally X desktop environments (like i3) and Wayland enviroments (like sway) work with mepo. Being based on SDL it will generally run faster then other map applications.

Installation

Mepo is available on postmarketOS edge but not on postmarketOS stable currently. The reason for this is that zig (which mepo is written in) is not available on Alpine outside of Alpine's testing repository. On postmarketOS edge you should install one of the following packages:

apk add mepo-scripts-zenity # For Plasma Mobile

apk add mepo-scripts-bemenu # For Swmo, Phosh, desktop Wayland

apk add mepo-scripts-dmenu # For Sxmo, desktop X

If you wish to use Mepo on postmarketOS stable you may either use the Mepo Flatpak or pull from the testing alpine repository.

Integrations

Mepo integrates with Nominatim and Overpass for POI searches, GraphHopper for routing, and Geoclue for location services. Unlike other OSM map applications, these integrations take the form of shellscripts (and are thus user-editable) and utilize Mepo's plain-text DSL / API called Mepolang; mepolang can additionally be used by end-users to create their own custom scripts.

Pictures

Links