# Mapeo Desktop

## Install

Download Mapeo Desktop from the [Mapeo website](https://www.digital-democracy.org/mapeo/) and double click the file to launch the installer. For more on installation, see [installing-mapeo-desktop](https://docs.mapeo.app/complete-reference-guide/mapeo-desktop-installation-setup/installing-mapeo-desktop "mention").

## Mapeo Desktop for managing Mapeo Mobile data (Observations mode)

**Observations** mode in Mapeo Desktop is designed for viewing, managing and exporting data collected with Mapeo Mobile. The steps below will cover the basics for testing **Observations** mode.

{% hint style="info" %}
For more detailed instructions and information on how to use Mapeo Desktop for creating territory data (**Territory** mode), see the Complete Reference Guide section on [mapeo-desktop-use](https://docs.mapeo.app/complete-reference-guide/mapeo-desktop-use "mention").
{% endhint %}

## Synchronize Mapeo Mobile data

To get started, synchronize collected data from a Mapeo Mobile device. To synchronize via Wi-Fi, as detailed below, the Mapeo Mobile and Mapeo Desktop devices must be near each other.

### Connect to Wi-Fi

Make sure both the <img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FBnlXQiDXSUwl79ooRjRE%2FMm-icon.png?alt=media&#x26;token=3235ef71-9f29-4ab3-89f0-4a605d81c8e6" alt="" data-size="line"> **Mapeo Mobile** device and the <img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FFAdFfIFGpMRnNzVDcK6i%2FMd-icon.png?alt=media&#x26;token=f55b5fc0-8c3c-42e4-ad1b-02b2aa4a7889" alt="" data-size="line"> **Mapeo Desktop** device are connected to the same Wi-Fi network. (An internet connection is not required.)

### Enter Synchronize mode

In <img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FBnlXQiDXSUwl79ooRjRE%2FMm-icon.png?alt=media&#x26;token=3235ef71-9f29-4ab3-89f0-4a605d81c8e6" alt="" data-size="line"> **Mapeo Mobile**, tap the <img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FSn1FbGF79VfE9wgQYQOE%2Fapp_icons_Sync_35px.png?alt=media&#x26;token=401d7926-1a00-4ecb-a87e-9c0b0ebf52f6" alt="" data-size="line"> **Synchronize** button to enter the **Synchronize** screen.\
\
![](https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FoYMWNY2sfaw8yJMGRTVw%2FSync_screen_button.jpg?alt=media\&token=be6828ea-6f22-46ab-a3e9-e30b0c36de8e)

In <img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FFAdFfIFGpMRnNzVDcK6i%2FMd-icon.png?alt=media&#x26;token=f55b5fc0-8c3c-42e4-ad1b-02b2aa4a7889" alt="" data-size="line"> **Mapeo Desktop**, click on **Synchronize** in the **Mapeo modes** panel.

![](https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FeVDEfogCDZh0tSqR1mAw%2FMd_Synchronize_mode.jpg?alt=media\&token=c8afe1d9-c6bf-430d-b094-ecf23d16d0bc)

### Start synchronization

On the Mapeo Desktop **Synchronize** screen, identify the mobile device you would like to synchronize with and click on the **Synchronize** <img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FWE5xdxyFxmmkWizNBgu0%2Fmapeo-icon-sync-black-%403x.png?alt=media&#x26;token=d52f80db-d229-4ec6-9265-e2bd1fd0da67" alt="" data-size="line"> button below its name.

![](https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FaZozJEDbEf7emc7HUGIW%2FMd_Synchronize_mode_sync_with_mobile.jpg?alt=media\&token=aef9f15b-e6a8-4dd9-a4e9-ebe740468019)

{% hint style="warning" %}
**IMPORTANT**: Keep the **Synchronize** screen open on BOTH devices until the synchronization is complete. Interrupting the sync process can result in permanently corrupted data.
{% endhint %}

{% hint style="info" %}
In order to synchronize, Mapeo devices must be connected to the **same Wi-Fi network**, and using the **same project configuration**.

For more detailed instructions on synchronizing in Mapeo Desktop, see [syncing-data](https://docs.mapeo.app/complete-reference-guide/mapeo-desktop-use/using-mapeo-desktop-to-manage-mapeo-mobile-data/syncing-data "mention").
{% endhint %}

## View observations

To view synchronized data, click on **Observations** in the **Mapeo modes** panel.

![](https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FTsEMQQTLYWqlwXmf12z3%2FMd_Observations_mode.jpg?alt=media\&token=0a1ec8e8-056f-4d49-9bd1-76f314c63660)

### Map view

By default, observations are displayed as dots on a map. Click on an individual dot to view the details of that observation.

![](https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FTgtv9r0Am8Z7sYtSPd4Z%2FMd_map_hover.jpg?alt=media\&token=f20d97b6-15e0-4fa9-b706-726a70cd828e)

### Media view

To view observations as a gallery of images, click on **Media** in the **Toolbar** above the map. Click on an individual image to view the details of that observation.

![](https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2F5IwpW8HEVOwpWASrBvPD%2FMd_media_view_button.jpg?alt=media\&token=1cb86a51-4d35-46a6-b83b-47af406b4308)

### **Report view**

To view observations in the form of a report, click on **Report** in the **Toolbar.**

![](https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FqjaU5VMO9Ub6EZkKhK0U%2FMd_report_view_button.jpg?alt=media\&token=c771e6f8-7aaa-46a3-9bf3-edfe3457c864)

## **Filter observations**

To look at a subset of your observations in **Map**, **Media** or **Report** view, use the **Filter** panel to select a specific data range, a subset of categories, or specific data values from details fields.

![](https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2F9nZTcTZghwJ9p1z9mOIO%2FMd_Filter_panel.jpg?alt=media\&token=52926905-84a6-4670-b0f9-d0428c104fc6)

## **Edit observations**

From **Map** or **Media** view, click on a dot or image to view the full details of the corresponding observation. From **Report** view, use the <img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2F1RYnWLh8jHaDB16UsSVs%2Fimage.png?alt=media&#x26;token=fe98ba22-fd05-4a32-ada0-012c7183c6f8" alt="" data-size="line"> **EDIT** button in the grey toolbar to open the details of the observation shown in the current page of the report.

With the observation details open, click on a field to add or edit information. Click **SAVE** to save changes.

![](https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FBTY33PQOXAn3GoLZXY6r%2FMd_edit_observation.jpg?alt=media\&token=bdad316d-0a1b-4fee-884e-15f2ca8f63cf)

{% hint style="info" %}
In Mapeo Desktop you cannot modify the creation date, category type or geographic location of an observation.
{% endhint %}

## Delete observations

To delete an observation, open the observation details and click on the<img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FCV8F04U64BeFw457o4oB%2FThree%20dots%20menu.png?alt=media&#x26;token=ebffe98c-6b40-4864-a4ff-5a5dff94c89f" alt="" data-size="line">**More options** menu. Select **Delete observation** and confirm deletion in the pop-up window.

![](https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FQqA4VvxDrInCDc5m7DPW%2FMd_edit_observation_more_options.jpg?alt=media\&token=275d0e49-b904-4141-9163-eba777ecadf5)

{% hint style="warning" %}
**Deleting observations cannot be undone, so exercise caution when using delete.**

By deleting observations, you will permanently remove them from your device and all devices you synchronize data with in the future. For more on synchronization, see [peer-to-peer-and-mapeo-sync](https://docs.mapeo.app/overview/about-mapeo/peer-to-peer-and-mapeo-sync "mention")
{% endhint %}

## Export data

Data can be exported to multiple formats from **Observations** mode in Mapeo Desktop. Basic export instructions are included below.

* [Save as PDF Report](#save-as-pdf-report)
* [Export to GeoJSON, CSV, or SMART CSV](#export-to-geojson-csv-or-smart-csv)
* [Export as Web Map](https://docs.mapeo.app/complete-reference-guide/mapeo-desktop-use/using-mapeo-desktop-to-manage-mapeo-mobile-data/exporting-and-sharing-externally#export-as-web-map) (In Complete Reference Guide)

{% hint style="info" %}
For more details on Mapeo export formats and process, see [exporting-and-sharing-externally](https://docs.mapeo.app/complete-reference-guide/mapeo-desktop-use/using-mapeo-desktop-to-manage-mapeo-mobile-data/exporting-and-sharing-externally "mention") in the Complete Reference Guide.
{% endhint %}

### **Save as PDF Report**

To save a PDF report with the observations collected, go to **Report** view. Filter observations if desired using the **Filter** panel. Hide any fields you don't wish to appear by using the <img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FTFU7xpxxrWSOX6pc8t1K%2Fhide.png?alt=media&#x26;token=94f4dbcd-519c-4a1e-86d5-c83e0407a95d" alt="" data-size="line"> **Hide fields** option in the grey panel above the report.\
\
To save, click on <img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FEnBZRMMkOBfHkh5kqat1%2Ficon-load.png?alt=media&#x26;token=aed62001-c138-4fc0-83a5-c7136867d629" alt="" data-size="line">**Save PDF.**

![](https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FcgRlWueZZLmswDeGjevA%2FMd_report_save_pdf.jpg?alt=media\&token=eb4fa0f6-7c10-44cc-9ad2-94b20a0039ce)

### Export to GeoJSON, CSV, or SMART CSV

To export observations to GeoJSON, CSV or SMART CSV format, click on the <img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2Frhk0vOF46kcM3p1qectv%2Fico_export.png?alt=media&#x26;token=6f619a1f-6002-490b-bd6f-2118e3462c95" alt="" data-size="line">**Export options** menu at the top right corner of the Mapeo Desktop window.

Select **Export Observations...** then select the desired data format and options in the Export Observations pop-up window. Click **SAVE** to name the export file and choose the location on your computer where it will be saved.

![](https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2F137F2GiAENI0AWxcqQwO%2FMd_Export_observations_menu.jpg?alt=media\&token=356ed9c3-665a-4915-811c-9a48a7713139)

{% hint style="info" %}
For detailed instructions on all features and uses of Mapeo Desktop, see [mapeo-desktop-use](https://docs.mapeo.app/complete-reference-guide/mapeo-desktop-use "mention") in the Complete Reference Guide.
{% endhint %}
