{"id":43495608,"url":"https://github.com/patrikcze/meshtatic_data","last_synced_at":"2026-02-03T10:36:12.936Z","repository":{"id":334390723,"uuid":"1141146574","full_name":"patrikcze/meshtatic_data","owner":"patrikcze","description":"Meshtastic Data Transfer - Trying some stupid thing, like transferring files over LORA network. ","archived":false,"fork":false,"pushed_at":"2026-01-24T12:42:05.000Z","size":1379,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-25T00:33:30.641Z","etag":null,"topics":["data","meshtastic","meshtastic-python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/patrikcze.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-01-24T10:36:56.000Z","updated_at":"2026-01-24T12:42:08.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/patrikcze/meshtatic_data","commit_stats":null,"previous_names":["patrikcze/meshtatic_data"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/patrikcze/meshtatic_data","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patrikcze%2Fmeshtatic_data","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patrikcze%2Fmeshtatic_data/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patrikcze%2Fmeshtatic_data/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patrikcze%2Fmeshtatic_data/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/patrikcze","download_url":"https://codeload.github.com/patrikcze/meshtatic_data/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patrikcze%2Fmeshtatic_data/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29041695,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-03T10:09:22.136Z","status":"ssl_error","status_checked_at":"2026-02-03T10:09:16.814Z","response_time":96,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["data","meshtastic","meshtastic-python"],"created_at":"2026-02-03T10:36:12.200Z","updated_at":"2026-02-03T10:36:12.930Z","avatar_url":"https://github.com/patrikcze.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Meshtatic Data Transfer\n\nA Python project scaffolding for \"Meshtatic Data Transfer\". Follows a src/ layout, per-project venv, pinned deps, and one-command workflow.\n\n## Quick start\n\n1. Create venv: `python3 -m venv .venv`\n2. Activate: `source .venv/bin/activate`\n3. Install dev tools: `python -m pip install -r requirements-dev.txt`\n4. Run checks: `make test`\n\n## Usage\n\n- Help:\n  - `make run`\n\n### Quick start: send a file over Meshtastic (serial)\n1) Install the runtime library (once):\n   - `make install-meshtastic`\n2) Identify your serial port (macOS example):\n   - `ls /dev/cu.* | grep -i modem`\n3) Send a file (defaults: broadcast, active channel on the device):\n   - `make run-send TRANSPORT=meshtastic PORT=/dev/cu.usbmodemXXXX INPUT=path/to/file.bin MAX_CHUNK=180`\n   - By default, the sender embeds the file name, size, and CRC in a small metadata header; the listener uses it to restore the filename. Use `--raw` to disable metadata, or `--name` to override.\n\n#### Addressed send and reliable delivery\n- Send to a specific node (quote the `!` in zsh to avoid history expansion):\n  - macOS/Linux (zsh/bash):\n    - `. .venv/bin/activate \u0026\u0026 PYTHONPATH=src python -m meshtatic_data_transfer send --transport meshtastic --port /dev/cu.usbmodemXXXX --input ./file.bin --max-chunk 180 --dest '!abcdef12' --reliable`\n  - Windows PowerShell:\n    - `python -m meshtatic_data_transfer send --transport meshtastic --port COM7 --input .\\file.bin --max-chunk 180 --dest '!abcdef12' --reliable`\n  - Alternative escaping: `--dest \\!abcdef12`\n\n### Receiver options on the other node\n- One-shot receive to stdout (exits after first complete message or timeout):\n  - `make run-recv TRANSPORT=meshtastic PORT=/dev/cu.usbmodemXXXX TIMEOUT=15 \u003e out.bin`\n  - Verify roundtrip: `cmp -l path/to/file.bin out.bin` (no output means identical)\n\n- Continuous listener (saves each message to files):\n  - `make run-listen TRANSPORT=meshtastic PORT=/dev/cu.usbmodemXXXX OUT_DIR=received MAX_MESSAGES=0`\n  - Output example: `saved 2048 bytes -\u003e received/7f353d62_1769248713.bin`\n\n### Fake transport (local, no radios)\n- Note: the fake transport is in-process for tests/dev. To demo a roundtrip without radios in a single command, use:\n  - `make run-fake-roundtrip INPUT=path/to/file.bin`\n- If you run sender/receiver as separate processes with TRANSPORT=fake, they won’t see each other (by design).\n\n### Notes\n- Visibility: binary payloads use Meshtastic PRIVATE_APP. They do not appear in the chat UI. Use the app’s debug view or the `listen` command to observe arrivals.\n- Listener behavior: `listen` reassembles messages, deduplicates by message_id, restores filenames from metadata, and avoids overwriting by appending a timestamp if necessary.\n- Encryption: payloads inherit the device’s channel encryption (default channel uses the well-known key; private channels use your private key).\n- Size: payloads larger than the radio MTU are automatically chunked (e.g., 2 KiB works with `MAX_CHUNK=180`).\n- Troubleshooting: if serial send fails, confirm the correct `PORT` and that the venv has `meshtastic` installed.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpatrikcze%2Fmeshtatic_data","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpatrikcze%2Fmeshtatic_data","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpatrikcze%2Fmeshtatic_data/lists"}