= modRana =

[[PageOutline]]

''[wiki:WikiStartCZ modRana wiki in Czech Language - Česká verze této wiki]''

[[Image(http://www.modrana.org/images/modrana_icon.svg, 10%)]]

!ModRana is a flexible GPS navigation software for (not only) mobile Linux devices. 

!ModRana is based on [http://wiki.openstreetmap.org/wiki/Rana Rana] and written in '''Python'''. The only dependencies other than '''Python 2.5+''' needed for running modRana are '''PyGTK''' and '''Cairo''' for running the ''GTK GUI''. 

For the ''QML GUI'', '''Qt''', '''!PySide''' and '''!QtComponents''' are needed.
 * to enable ''voice navigation'', install '''espeak''' (modRana runs just fine without it but it doesn't "speak" :) )

== [wiki:ScreenshotsEN Screenshots] ==
Visit the [wiki:ScreenshotsENscreesnhot screenshot gallery] to see modRana in its whole glory ! :)

== [wiki:SystemFunctionalityEN Features] ==

This section demonstrates the functionality of modRana.[[BR]]

How to enable '''turn-by-turn navigation with spoken directions''' ?[[BR]]
[wiki:TurnByTurnNavigationEN T-b-T navigation guide]


How to use '''offline routing ?'''[[BR]]
[http://wiki.maemo.org/ModRana_offline_routing_guide modRana offline routing guide] @ Maemo.org wiki.

Where does modRana store maps, tracklogs, POI and configuration files ?[[BR]]
[wiki:DataStorageEN modRana data storage article].

== [wiki:SystemHowtoManualEN Howto/Manual] ==

A short quide describing how to use the various fetures provided by modRana. [work in progress]

 == [wiki:SystemPlatformsEN Supported Platforms] ==

 The target platform for modRana is '''Maemo 5''' on the Nokia '''N900'''.

Are you a N900 user ? Check out [http://talk.maemo.org/showthread.php?t=58861 the modRana thread at talk.maemo.org] :)

!ModRana also works on the Nokia '''N9/N950''', Openmoko '''Neo !FreeRunner''', '''Smart Q7''', '''!OpenPandora''' handheld and standard Linux PCs. 

It is quite possible, that modRana also works on other devices, thanks to the low dependency count.

 == [wiki:SystemDownloadEN Download] ==
Instalation packages are available for:

 * [wiki:SystemDownloadEN#maemo Maemo 5 @ N900]
 * [wiki:SystemDownloadEN#harmattan Installation package for MeeGo 1.2 Harmattan on the Nokia N9 and N950]
 * [wiki:SystemDownloadEN#InstallationpackageforNemoMobile Installation package for Nemo Mobile]
 * [wiki:SystemDownloadEN#shr SHR @ Neo !FreeRunner]
 * [wiki:SystemDownloadEN#deb Ubuntu/Debian (this package works both on x86 and ARM)]


There is also an universal [wiki:SystemDownloadEN#tarball tar archive]. This is also basically the complete modRana source code.

== Donations ==
Donations for the modRana project are more than welcome! :)
{{{
#!html
<form action="https://www.paypal.com/cgi-bin/webscr" method="post">
<input type="hidden" name="cmd" value="_s-xclick">
<input type="hidden" name="encrypted" value="-----BEGIN PKCS7-----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-----END PKCS7-----
">
<input type="image" src="https://www.paypal.com/en_US/i/btn/btn_donate_LG.gif" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!">
<img alt="" border="0" src="https://www.paypal.com/en_US/i/scr/pixel.gif" width="1" height="1">
</form>
<br>
<a href="http://flattr.com/thing/627455/The-modRana-project" target="_blank">
<img src="http://api.flattr.com/button/flattr-badge-large.png" alt="Flattr this" title="Flattr this" border="0" /></a>
}}}

'''bitcoin:'''16jppsSmwEYgb8xVMRaP1YBaK3kBWtFydS

== History ==

!ModRana has been in development since spring 2010 and has achieved some interesting milestones, such as:

* '''fall 2012''' support for offline routing & own offline routing data repository
* '''summer/fall 2012''' modRana wins the '''1st place''' in ''Maemo.org Coding Competition 2012'', ''Updates & Development on Existing Apps'' category
* '''fall 2011''' modRana wins the '''2nd place''' in ''!MeeGo Coding Competition 2011'', ''Location & Navigation'' category
* '''spring 2011''' new QML GUI
* '''summer 2010''' modRana wins the '''3rd''' place in ''Maemo Coding Competition 1'', ''Location & Navigation'' category

 == [wiki:SystemDevelopmentEN Development]==
Information about modRana development & how you can help with it. :)

Contains information of how modRana works under the hood & various development notes.

!ModRana source code is hosted on Github:
[https://github.com/M4rtinK/modrana https://github.com/M4rtinK/modrana]

Pull requests & patches are welcome ! :)

 == Contact the developer ==

My name is '''Martin Kolman''' and you can reach me on:

 jabber: m4rtink ''at'' jabbim ''dot'' cz

 email: modrana ''at'' gmail ''dot'' com

 [wiki:martin_kolman my activity overview]