ChatMap

Field mapping has never been easier!

Export a chat (WhatsApp, Telegram or Signal) and open it to visualize locations, messages and media.

Try it here! chatmap.hotosm.org

Check this quick video-tutorial (2:47) for more info about how to use it.

---

Install and run

cd chatmap-ui
yarn install
yarn start

Test with yarn test.

How to use it?

Create a group and ask people to post locations and messages. Each location will be paired with the closest message from the same user.

1. Export a WhatsApp, Telegram or Signal chat with shared locations, to a zip file
2. Open the .zip file with ChatMap
3. It will extract all the locations and display them on a map, together with the paired message (text or media)
4. You can also download the locations + messages as a .zip file from there, and open it again if needed!

Check docs for each instant messaging app here.

Advanced mode

The advanced mode provides features for user authentication, saving and publishing maps, and live updates with linked devices.

docker compose -f compose.dev.yml up

Then open http://localhost:5173 and create an account using any e-mail.

Check authentication docs and Live feature docs.

Roadmap 2026

✅ Done ⚙️ In progress

Status	Feature
✅	Serve data from ChatMap
✅	Website re-design
✅	Map options
✅	User profile
✅	Save data directly in ChatMap - Thanks Abraham!
✅	Update a saved map with new data - Thanks Abraham!
✅	Attach both image and text to a location
⚙️	ChatBot for creating automated surveys
⚙️	Mapper app
⚙️	Upload content to Panoramax
⚙️	User content licensing options
	Content timeline
	Content filtering options
	Tagger view

Licensing

This is free software! you may use this project under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.