Skip to main content

Download maps for mobile devices over broadband, with a personal computer.

Project description

Mobile Map Downloader is a command line program to download maps from the Internet and install them on a mobile device, such as a smart phone.

The program is intended to run on a (personal) computer, that has a fast and cheap Internet connection, and a large hard disk. The downloaded maps are stored on the personal computer. Only the maps that are used for the current activity need to be installed on the mobile device. When different maps are required for an other activity they can be quickly installed from the personal computer’s hard disk, without lengthy downloads.

The software is currently in beta state. It can be productively used by adventurous people, or semi experts. Expect it to lack some functionality, to crash often, and to sometimes do unwanted things.

Currently the offline map programs OsmAnd and Oruxmaps are supported:

Maps can be installed from Osmand and from Openandromaps, which means there is currently only one source of maps for each program:

If you find any errors, or if you have good ideas for the program, please put them into the project’s issue tracker:


The program has only been tested on Linux. It should run on Mac OS X and Windows with only minor modifications, however installation on these operating systems is probably more complicated.

On Linux, open a terminal, get administrator/root privileges and type:

pip install mobile-map-downloader --pre -U

Alternatively you can install the program with Virtualenv. With Virtualenv you don’t need root privileges, and can delete the program from your computer without a trace:

virtualenv virtualenv/  #can use any name for the directory
cd virtualenv
source bin/activate
pip install mobile-map-downloader --pre -U

Broken pip in openSUSE 13.2

The Python installation program pip is broken in openSUSE 13.2, and possibly other Linux distributions: The present pip is for Python 3, while the system Python is Python 2.7.8. The programs pip2 or pip2.7 are missing.

Therefore pip can’t install any programs for the system Python on openSUSE 13.2.

As a workaround a new pip can be easily installed from the program’s website: Download the script and run it with the system’s regular Python interpreter. (This requires root privileges.):


This will create a working pip on your computer, which can then install mobile-map-downloader. The process is described in more detail in Pip’s documentation:


List the maps of France, that the program can download:

dlmap lss "*France*"

Patterns with wildcards should be quoted, because the shell might fill them in.

Install maps of France for OsmAnd, on a certain device:

dlmap -m /var/run/media/eike/1A042-B123/ install "osmand/France*"

The program has a built in help facility, detailed information about its changing set of features has to be taken from it:

dlmap -h

Each subcommand has its own help message:

dlmap install -h


The program is written in the Python programming language, version 2.7. Contributions of code are very welcome. The program has currently only been tested on Linux. It uses however no Linux specific functionality, so porting to other operating systems should be easy.

Development is coordinated on Github:

The issue tracker for errors and good ideas is here:

The program’s page on PyPI, the Python Package Index, is:

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mobile-map-downloader-0.1.11.tar.gz (24.7 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page