Version 71 (modified by Martin Kolman, 12 years ago) (diff)



modRana download page in Czech

Installation package for Maemo 5 Fremantle on the Nokia N900

ModRana is available from the Extras-devel repository, in the Location & Navigation section.

  • If you want to install from the command line, type this as root:
    apt-get install modrana
  • modRana will be installed to /opt/modrana, this folder also includes the configuration files
  • tiles are stored in /home/user/MyDocs/.maps/ (a hidden folder)

Installation package for MeeGo 1.2 Harmattan on the Nokia N9 and N950

The Qt/QML GUI used on Harmattan is a work in progress. As result this package currently provides less features than the package for Fremantle. Still, the interface should be much more snappy. :)

ModRana is available from this OBS repository. Once the Harmattan version reaches feature parity with Fremantle, it will be also released to Nokia Store and Apps for MeeGo.

How to install First install dependencies using apt-get (you need to be root for this):

apt-get install python-pyside.qtgui python-pyside.qtdeclarative python-qtmobility

Then download & install the modRana package. After installation, modRana icon should show up among the other icons. To run modRana from the CLI, use this command (if the package wants to be Ovi store compatible, it should put files to /usr/bin):

sh /opt/modrana/run/harmattan

Installation package for SHR on the Neo FreeRunner

a walkthrought for intalation on QTMoko

  • on SHR unstable the packages python-netclient and python-misc need to be installed
  • in default configuration, tiles are stored in /usr/share/modrana/cache/images, because the on device space is limited, it is advised to store the tiles on the memory card, the path can be modified in user_config.conf in the modRana main folder
  • modRana stores tiles in the same way (when not using sqlite to store tiles) as TangoGPS/FoxtrotGPS - you can configure bot to share the same map folder
  • map layers can be configured in map_config.conf in the main modRana folder
  • Maps folder sharing configuration example:
    • our TangoGPS tiles are stored in /home/root/Maps, f.e. a OpenStreetMap layer in /home/root/Maps/OSM
    • we set tile_folder in user_config.conf to /home/root/Maps
    • then we set the !openStreetMap layer prefix OSM (/home/root/Maps/OSM -> OSM)
    • modRana will then use for OpenStreetMap layer tiles this path: /home/root/Maps + OSM -> /home/root/Maps/OSM

Installation package for Ubuntu and Debian


This archive contains an universal version of modRana and basically also contains the complete source:

  • just unpack and run
  • prerequisites: python (cca 2.5+), GTK2 and Cairo, optionally Simplejson
  • when on Maemo 5, install python-hildon and python-dbus nad run with python n900
  • install espeak to enable text to speach

Cutting edge tarball

there is also a cutting edge tarball, generated automatically from the modRana Git repository.

You can download, extract modRana like this:

wget -O modrana.tar.gz
tar -xvf modrana.tar.gz

Then cd into the M4rtinK-modrana-tag directory and run modRana:


For more options, see the modRana CLI help:

python --help

A simple script for testing internet connectivity

This is a CLI script for testing the availability of internet connectivity.


* modRana V0.34 *

released: 08.08.2012

  • more efficient and robust track logging .1
    • logging is incremental and does not slow down as the tracklog gets longer .1
    • logging to two separate temporary files for more robustness against software or device crash .1
    • modRana check for temporary tracklog files from last session on startup and exports them to GPX .1
  • fix logging trace not displaying properly .1
    • drawing the logging trace should now be also more efficient .1
  • the distict color selector now has captions in the target colors .1

* modRana V0.33 *

released: 21.07.2012

  • automatic rerouting .1
  • faster online routing .1
  • various routing fixes .1
  • less verbose TTS debugging messages .1

* modRana V0.32 *

released: 15.06.2012

  • CLI interface .1
    • zoomlevel, centering & focus can be set by CLI parameters
    • CLI search
      • local, address & wikipedia search are supported
      • show results in modRana or return a static map URL
      • proper success/error codes
    • use --help to list available options
      • includes usage examples
  • automatic device detection .1
  • LAST_KNOWN_POSITION keyword .4
  • Wikiwides improvements - thanks ! :
    • hide POI label under on higher zoomlevels .5
  • N900: GPS hotfix .5
  • add missing python-hildon dependency .6
  • faster routing with separate geocoding .7

* modRana V0.31 *

released: 15.05.2012

(released to Extras-devel)

  • preliminary QML GUI
  • improved tile loading
  • show all POI button - thanks Wikipwide !
  • visible POI are saved on shutdown & restored at startup
  • clickable links
  • Wikipedia article has a clickable link to full article
  • improved icons
  • fix link opening
  • various other fixes

* modRana V0.30 *

released: 03.04.2012

(released in the form of preview packages only to test the GUI separation, new packaging system and QML GUI)

  • initial QML GUI
  • faster tile download
  • fix track logging
  • correctly handle zero-length tracklogs
  • fix download-along tracklog
  • fix screen redrawing in GTK GUI
  • show proper window header in QML GUI
  • better layer selection dialog in QML GUI
  • fix point selection in P2P routing in GTK GUI
  • fix appearance of point selection buttons in GTK GUI
  • link to the whole Wikipedia article can be opened from modRana in GTK GUI
  • clickable links for the About screen in GTK GUI
  • fix listable menu for Wikiepdia search results
  • make-all-POI-visible button, thanks Wikiwide !
  • improved About menu in QML GUI
  • save & restore visible POI

* modRana V0.29 *

  • Wikipedia search (via Geonames)
    • results include a 300 character abstract, accessible by clicking the on map label
  • Wikipedia and address search results can now be used for routing and saved to POI
    • multiple result handling
    • on map clickable labels
  • two click map layer selection
    • also used for the navigation language selection
  • fast mode switching by pressing the menu icon for 400+ms
  • values of option items can now depend on the current mode
    • EXAMPLE: disable map rotation when in cycle mode but enable it in car mode
    • it is possible to list all per mode states for an option
    • individual options can now be reset to their default values
  • better readable text in POI and Search result detail menus
  • fixed GPSD problems in latest SHR
  • fixed a few menus where pressing the back button would not trigger a jump to map screen
  • the height profile now shows imperial units on its Y-axis in imperial unit mode
  • various backend fixes and improvements

* modRana V0.28 *

  • new patch from Gkuenning
    • smart rounding of imperial units for voice output
    • fix for turn announcement triggers
    • unit conversion module improvements
    • improved substitution list & more efficient substitution code Thanks a lot ! :)
  • other improvements:
    • geocoding (address search) GUI - finally! :)
    • fix for Unicode characters showing only as boxes
    • more readable POI search result list & captions
    • track recording now works again
    • more logically placed cancel button for "in progress" operations

* modRana V0.27 *

  • patch for better handling of imperial units by Gkuenning - thanks ! :)
  • fix overlapping labels on height profile with imperial units
  • modRana now has a profile folder in /home/user/.modrana
  • configuration files are now in the profile folder
  • tracklogs are now in MyDocs/tracklogs
  • cleanup example tracklogs
  • properly use os.path.join in place of simple concatenation
  • general refactoring and code cleanup
  • remove GUI source files from installation package

* modRana V0.26 *

  • improved speed and time based patch by Gkuenning - thanks ! :)
  • assured sane turn announcements (between 10 and 20 s)
  • advanced distance rounding for shorter voice messages
  • enlarge pointReachedDistance if smaller than traveling speed per second (eq. modRana should no longer skip turns due to high speed)
  • fix missing python-simplejson dependency
  • patch by Gkuenning that adds speed and time based navigation voice message triggering - thanks a lot ! :)
  • fix overlaid labels on route profile
  • fix big route profile labels not being visible
  • decrease GPS fix latency (both liblocation & GPSD)
  • new GPSD protocol support
  • support for folder based modules

* modRana V0.25 *

  • map rotation is now optimized - only tiles that are really visible will be now loaded and drawn
  • map overlay has also been optimized - it should be now as fast as a normal single-layer map, thanks to caching
  • line wrapping & bigger font for turn-by-turn navigation
  • progress on the current route is now shown for turn-by-turn navigation
  • more visible buttons for turn-by-turn navigation
  • the About screen in the Info submenu now contains contact information for the modRana project
  • a few new icons were added
  • there is now a "EV charging" preset in POI search
  • fixed a few notification that were not showing up
  • the text-to-speach CLI string can now be interactively edited after switching to manual mode in Options->Sound->Voice
  • added a missing dependency on python-hildon
  • added a "Dr.\" should now be correctly substituted for "Drive" in voice output

* modRana V0.24 *

  • fix needless redrawing in centered mode slowing down map rendering
  • fix GUI not redrawing after pressing buttons
  • new way of loading tiles which gives priority to currently visible tiles first
  • lowered default number of automatic tile download threads to lessen I/O load
  • new info menu with an About submenu showing current version :)
  • better N900 integration
    • proper App-Menu which enables fast access to often used features (centering, map rotation, etc.)
    • volume keys are now used for zooming by default
    • modRana now uses Hildon banners for notifications
    • zoom feedback using a Hildon banner
  • sound can now be turned ON and OFF
  • saving of automatically downloaded map tiles can be now turned off

* modRana V0.23 *

  • new optional map dragging technique, which is a lot faster but not so pretty as the default one
  • support for long pressing buttons
  • long press of the escape button (green arrow in upper left corner) switches directly to the map screen
  • configurable threshold for disabling centering by dragging the map
  • startup timing
  • fixed broken list scrolling in options
  • fixed black screen at startup caused by the new shifted centering code

* modRana V0.22 *

  • tapping on buttons no longer disables centering
  • map movement is now properly synchronized with position indicator movement(while centering is on)
  • support for centered icons that use a nice themeable background
  • properly sized icons to avoid needless resizing
  • reworked button text rendering
  • proper spaceport icon
  • fixed text entry not working in fullscreen\* fixed usability issues with text entry popups

-> tapping outside the popup no longer saves popup content -> tapping outside the popup also cancels POI adding, if in progress -> previously entered text is now highlighted by default

* modRana V0.21 *

  • don't redraw on background
  • add theme support + an example "night" theme
  • ensure routing start while moving
  • cache cairo drawn icons to improve performance
  • center text on icons
  • add a 64x64 icon
  • enable navigation box hiding
  • add previous/next turn buttons

* modRana V0.20 *

  • optimized map drawing
    • all time consuming tile related operations (loading, sending download requests,...) were moved to a separate thread
    • there is now a limit on the number of concurrent automatic tile download threads
  • sequential sqlite access. which might fix some of the "database locked" issues
  • shutdown should be now more robust and better logged
  • fixed button hiding not working correctly
  • SHR@NEO FreeRunner:
    • fixed wrong speed being displayed in SHR on the Neo FreeRunner?
    • gpsd output speed toggle (knots per second in gpsd vs meters per second in FSO-gpsd) in options->GPS

* modRana V0.19 *

  • N900: multi mode screen blanking control (always on, while moving, while moving in fullscreen, while in fullscreen, with GPS fix,..)
  • use Russian voice for street names that contain Cyrillic literals
  • navigation is now auto-started by default
  • initial dbus support
  • fix wrong speed being displayed for metric units
  • fix weird behavior occurring after searching for extremely long roads (like Moscow-Honolulu :)
  • fix last directions step message not being displayed
  • Ubuntu 10.04: fix crash on startup caused by missing device module
  • fix directions CSV rules only being used once and not accepting Unicode

* modRana V0.18 *

  • asynchronous online service access
  • multilingual directions and voice navigation

* modRana V0.17 *

  • improved POI functionality - finally ! :)
    • store current position, place on the map, local search results or manually specified POI
    • easy route finding from the current position to a POI
    • show POI on the map
    • categories
    • old POI import
    • CSV export
    • can share database with Mappero (optional)
  • all routes now show the route info button on the map screen
  • improved terminal output logging
    • creates a new log fail for each modRana session (provided that logging is enabled in options->debug->log stdout
  • many small improvements

* modRana V0.16 *

  • optional sqlite tile storage - especially usefull on FAT32 like filesystems
    • tiles are stored in a single file
    • this avoids small tiles taking up many large clusters
    • tiles should therefore take up much less space than when storing to files and folders
  • special state tiles
  • batch tile download is now improved and faster
  • modRana stdout to file logging support

* modRana V0.15 *

  • automatic map rotation support
  • map scaling support (2X,4X)

* modRana V0.14 *

  • turn-by-turn navigation
  • espeak based voice navigation

* modRana V0.13 *

  • draw logging trace
  • distinct track coloring + manual color selection
  • folder based tracklog categories
  • more robust tracklog handling
  • valid and OSM compatible GPX output
  • better looking generic icons


  • default tile folder is now .maps in MyDocs
    • this makes modRana share maps with Mappero and Maep

* modRana V0.12 *

  • bugfix release

* modRana V0.11 *

  • GUI for track logging -> directly to a GPX file
  • tracklog cathegories
  • deleting tracklogs
  • ondemand tracklog loading => much faster aplication start
  • limit on the maximum number of in memmory tiles(user feedback - thanks)
  • netwok usage modes - full/partial(= no automatic tile dl)
  • slight improvements of the user interface
  • added new icons
  • new MTB layer for Czech republic

* modRana V0.10 *

  • now widget, showing remaining distance/time
  • imporoved OSD route profile widget
  • more intuitive tracklog visibility setting

* modRana V0.09 *

* modRana V0.08 *

  • text input
  • address routing
  • toll and highway avoidance

* modRana V0.07 *

  • map overlay support
  • route profile widget
    • activate a tracklog in tools -> set active
    • if upgrading from older version, delete the cache file on Neo in cache/tracklogs/tracklog_cache.txt
  • show current pozition on the route profile
  • the map should be show, even if these is no space left on the device

* modRana V0.06 *

  • the map is now more sharp and uninterrupted
  • GPS on the N900 was confirmed as working

* modRana V0.05 *

  • Neo FreeRunner package
  • TangoGPS compatible tile storage
  • map layer configuration in map_config.conf
  • improved batch tile download

* modRana V0.04 *

  • N900 GPS support
  • fully configurable user interface (using the user_config.conf config file)
    • each profile can have a custom UI
    • size and position of UI buttons and elements can be changed
    • size and position of information widgets can be configured
    • information widgets: time, speed, speed statistics, coordinates...
  • tiles folder can be set from the config file
    • on the N900 /home/user/MyDocs/modRana_tiles/, is used (to modify the tile folder path on N900, change it in the N900 section)
  • position indicator indicator
  • by using the first CLI argument, the current device type can signalized to modRana
    • for now, its is used mainly for N900 specific features or initial screen/window resolution
    • supported codes: n900, neo, n95, eee, q7, square, ipaq
  • potecially faster method for loading map tiles
  • improved threading support (thanks ivir for feedback)


ModRana is licensed under GPL v3 and all third pasty modules under their own respective (open source) license.

Attachments (2)

Download all attachments as: .zip