= 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] '''Running modRana''' Just find the modRana or modRana QML icon and press it. :) To start modRana from the command line interface, for the classic GTK GUI run: {{{ modrana-gtk }}} For the QML GUI run: {{{ modrana-qml }}} == Sailfish cutting edge packages == Cutting modRana edge packages for Sailfish OS are available from the Mer OBS. To add the repository and install modRana, you can use the following commands: {{{ zypper ar http://repo.merproject.org/obs/home:/MartinK:/sailfish:/modrana/sailfishos_1.0.3.8_latest_armv7hl/ zypper refresh zypper install harbour-modrana }}} After installation, the modRana icon should show up as usual. To launch modRana from the command line, use this: {{{ sailfish-qml harbour-modrana }}} == Installation package for !MeeGo 1.2 Harmattan on the Nokia N9 and N950 == #harmattan Packages for Harmattan are available from: [http://modrana.org/packages/harmattan/ http://modrana.org/packages/harmattan/] Just grab the one with the highest version with your browser or with wget and install it. After installation, the 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 now 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] '''NOTE: this package is VERY outdated, get the modRana tarball & clone it from git to get a more recent version''' === Cloning modRana from git === This is an alternative method for having up-to-date modRana on your device. :) First install Git: {{{ opkg update opkg install git }}} Then clone modRana & run it: {{{ git clone http://github.com/M4rtinK/modrana.git cd modrana ./run/neo }}} To update the Git clone, just run git pull from inside the ''modrana'' directory: {{{ git pull }}} === !FreeRunner & SHR notes === * [wiki:QtMokoInstalationEN a walkthrough for installation on QTMoko] * if running modRana from tarball or Git on '''SHR''', you need to install some missing dependencies: {{{ opkg install python-misc python-netclient python-json python-compression }}} * in default configuration, tiles are stored in '''''/root/.modrana/maps/''''', 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 '''''/root/.modrana/''''' * 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 '''''/root/.modrana/''''' * '''''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.