Loading Configurations

What is a .mapeosettings file?
A .mapeosettings file is a tar file, similar to a zip file. You can see the contents of the file by changing the file extension to .tar and using any application that can extract tar files.
Testing 
Before loading your preset configuration file into the phone, use mapeo-settings lint to test your files to make sure they will compile on the phone.
Run the following command if you are using the default template.
1
npm test
2
...
3
Presets valid
Copied!
Mapeo Mobile
Now, you are ready to load your settings to Mapeo Mobile.
Using manual file transfer
1.Rename the .mapeosettings file to .tar 
2.Then expand .tar file by double clicking to open it
3.Copy that folder onto the phone
1
  /sdcard/Android/data/com.mapeo/files/presets/default
2
  /sdcard/Android/data/com.mapeo.qa/files/presets/default
Copied!
See https://github.com/digidem/mapeo-mobile#usage for latest published documentation
1
 /sdcard/Android/data/com.mapeo.qa/files/styles/default
2
 /sdcard/Android/data/com.mapeo/files/styles/default
Copied!
Using Terminal adb
1.Plug in the device to your computer using a USB cable.
2.Set the mode for USB debugging on the phone to 'Transfer Files'.
3.In the terminal, typing adb devices should give you the following output:
1
$ adb devices
2
List of devices attached
3
ZY223D4VVS  device
Copied!
​If your device is not found or is unauthorized, make sure it is plugged in all the way and then see this troubleshooting guide.
Now, you'll need to place the presets folder in the appropriate directory on the Android device using adb push
1
adb push ./mapeo-settings-myproject-v1.0.0/* /sdcard/Android/data/com.mapeo/files/presets/default
Copied!
Did it work? Test that the files are available on the device by using the shell. 
1
$ adb shell ls /sdcard/Android/data/com.mapeo/files/presets/default
Copied!
If it worked correctly, you should see the following output
1
VERSION
2
icons
3
icons.json
4
icons.png
5
icons.svg
6
metadata.json
7
presets.json
8
style.css
9
translations.json
Copied!
Mapeo Desktop
Automated import
Mapeo Desktop supports importing .mapeosettings files in the user interface.
After you've created your settings file, you can import it by navigating to File->Import Configuration....
Manual import
You can also extract the .mapeosettings file as a tar file into the following directory:
1
USERDATA/Mapeo/presets/default
Copied!
USERDATA is the per-user application data directory, which by default points to:
%APPDATA% on Windows
$XDG_CONFIG_HOME or ~/.config on Linux
~/Library/Application Support on macOS
This folder (default) expects these files directly in under this default folder (i.e. no sub-folder with a different name):
1
presets.json
2
icons.svg
3
etc...
Copied!
​

Configuration - Previous

Adding a Project Key

Next - Configuration

Aerial Imagery

Last modified 1yr ago

Export as PDF

Copy link

Contents

What is a .mapeosettings file?

Testing

Mapeo Mobile

Using manual file transfer