= Download = [[PageOutline]] ''[wiki:SystemDownload modRana download page in Czech]'' == Installation package for Maemo 5 Fremantle on the Nokia N900 == #maemo !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) * [wiki:maemo5PackagingNotes Maemo 5 packaging notes] == Installation package for !MeeGo 1.2 Harmattan on the Nokia N9 and N950 == #harmattan ''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 [http://repo.pub.meego.com/home:/MartinK:/modrana/MeeGo_1.2_Harmattan_Maemo.org_MeeGo_1.2_Harmattan_standard/armel/ 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 become root: {{{ devel-su }}} Then add the modRana COBS repository, update repositories & install modRana: {{{ echo "deb http://repo.pub.meego.com//home:/MartinK:/modrana/MeeGo_1.2_Harmattan_Maemo.org_MeeGo_1.2_Harmattan_standard/ ./" > /etc/apt/sources.list.d/modrana-cobs.list apt-get update apt-get install modrana }}} 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 can't put files to /usr/bin so this startup script is used): {{{ sh /opt/modrana/run/harmattan }}} == Installation package for Nemo Mobile == Just add the modRana-nemo COBS repository and install modRana using zypper: {{{ su zypper ar http://repo.pub.meego.com/home:/MartinK:/modrana:/modrana-nemo/CE_MW_Shared_Mer_Core-next_armv7hl/ modrana-nemo zypper up zypper install modrana }}} Thats it, you should have a nice blue modRana icon in your icon grid. :) You can also start modRana from command line like this: {{{ modrana }}} '''Optional - running the modRana GTK GUI''' I've succeeded in building the GTK library and its Python bindings for Nemo, so you can also run modRana with the classic GTK UI on Nemo. Just add my Nemo repository and install GTK & PyGTK: {{{ zypper ar http://repo.pub.meego.com/home:/MartinK:/nemo/CE_MW_Shared_Mer_Core-next_armv7hl/ zypper install gtk2 zypper install pygtk2 }}} And then you can run the modRana GTK UI like this: {{{ modrana-gtk }}} == Installation package for SHR on the Neo !FreeRunner == #shr [http://www.modrana.org/packages/modrana_0.29-1_all.ipk] [wiki:QtMokoInstalationEN 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 == #deb [http://www.modrana.org/packages/modrana-0.29-1_all_SVN.deb] == ''Tarball'' == #tarball This folder contains tarballs with an universal version of modRana and basically also contains the complete modRana source code: [http://www.modrana.org/tarballs/modrana/] * just unpack and run modrana.py * prerequisites: '''python''' (cca '''2.5'''+), '''GTK2''' and '''Cairo''', optionally '''Simplejson''' * when on Maemo 5, install '''python-hildon''' and '''python-dbus''' and run with '''python modrana.py -d n900''' * install '''espeak''' to enable text to speech As the cutting edge tarball is generated automatically, it might be more up-to-date than the tarballs in the above mentioned directory. === Cutting edge tarball === there is also a [https://github.com/M4rtinK/modrana/tarball/master cutting edge tarball], generated automatically from the modRana Git repository. You can download, extract modRana like this: {{{ wget https://github.com/M4rtinK/modrana/tarball/master -O modrana.tar.gz tar -xvf modrana.tar.gz }}} Then ''cd'' into the M4rtinK-modrana-''tag'' directory and run modRana: {{{ python modrana.py }}} For more options, see the modRana CLI help: {{{ python modrana.py --help }}} == A simple script for testing internet connectivity == [http://nlp.fi.muni.cz/trac/gps_navigace/attachment/wiki/SystemDownload/test_internet_connectivity.py?format=raw test_internet_connectivity.py] This is a CLI script for testing the availability of internet connectivity. == Changelog == Summary changelogs have been moved to the [wiki:ChangelogEN changelog page] due to making the download page too long. :) An [https://github.com/M4rtinK/modrana-packaging/blob/master/modrana/changes up-to-date changelog] is usually also available from the modRana packaging repository. It is generated semi-automatically when packages are being built so it should be generally more up-to-date than the summary changelog. == Licence == !ModRana is licensed under '''GPL v3''' and all third party modules under their own respective (open source) license.