This is a simplified version of TRIfA (the Tox Message Application for Android) that focuses on stable location sharing.
ToLoShare is a specialized Android application for secure, peer-to-peer location sharing using the Tox protocol.
It enables real-time GPS coordinate broadcasting between friends through a decentralized network,
displaying locations on an integrated OpenStreetMap view without relying on central servers.
It includes live map visualization, robust background operation,
multi-layer security including PIN protection, screenshot prevention and Tor proxy support.
This is a work in progress, feel free to help out.
Looking for ToLoShare Desktop version? follow me
The three toggle switches are located in the toolbar at the top of the screen.
Toggles between the friend list and the live map.
| Position | Effect |
|---|---|
| ON | Shows the friend list (main view). The map is paused to save resources. |
| OFF | Shows the interactive map with live GPS overlays for you and your friends. |
When switched to map mode, the screen-keep-on flag is set (if configured), location overlays are re-added, and all friend positions are refreshed on the map.
Toggles position smoothing for your own GPS track.
| Position | Effect |
|---|---|
| ON | Your location marker moves smoothly between GPS fixes by interpolating intermediate steps. |
| OFF | Your location marker jumps directly to each raw GPS fix. |
This preference is saved and restored across sessions.
Toggles position smoothing for your friends' GPS tracks.
| Position | Effect |
|---|---|
| ON | Friends' location markers move smoothly on the map between location updates. |
| OFF | Friends' location markers jump directly to each newly received position. |
These buttons appear in the upper panel of the map view and control which position the map follows. The currently active button is highlighted in dark red at full opacity; inactive buttons are dimmed.
Tapping this button centres the map on your own current location and keeps it locked there as you move.
Tapping this button centres the map on the first friend's position (sorted by public-key index) and keeps it locked as that friend moves.
A companion route button next to it calculates and draws a route from your position to Friend #1 using the currently selected travel mode (car or walking).
Tapping this button centres the map on the second friend's position and keeps it locked as that friend moves.
A companion route button calculates and draws a route to Friend #2.
Taps toggle the routing mode used for the route buttons:
| Icon | Mode |
|---|---|
| 🚗 Car icon | Route calculated for driving |
| 🚶 Walking icon | Route calculated for walking |
Tapping this button unpins the map from any position and clears all drawn routes. The map can then be scrolled and zoomed freely.
A compass widget is rendered in the top-left corner of the map.
- Tap the compass to toggle between two orientations:
| State | Compass Appearance | Map Behaviour |
|---|---|---|
| North-up ON | Shows the letter "N" | Map is locked with North pointing up |
| North-up OFF | Shows a red/black needle that rotates with the map | Map can rotate |
Tapping anywhere within the compass circle area (approximately the top-left corner of the map) triggers the toggle.
Join a growing community of security-conscious people. Check out these featured applications:
- TRIfA: The Tox flagship secure messenger for Android.
- TRIfA for Desktop: The feature rich Tox Desktop Messaging Client.
- Tox Push Msgs: The Companion App for TRIfA and TRIfA for Desktop to enable Push Messages.
- ToxProxy: Offline message relay functionality for TRIfA and TRIfA for Desktop.
- ToLoShare: A specialized Android application for secure, peer-to-peer real-time location sharing.
- ToLoShare for Desktop: A cross-platform desktop application for secure peer-to-peer real-time location sharing.
- ToFShare: Secure decentralized file sharing for Android using the Tox protocol.
- tox_videoplayer: A command-line application that streams video and audio content over the Tox network.
Any use of this project's code by GitHub Copilot, past or present, is done without our permission. We do not consent to GitHub's use of this project's code in Copilot.
No part of this work may be used or reproduced in any manner for the purpose of training artificial intelligence technologies or systems.