Skip to main content

Meshtastic Firmware and APK Downloader

Project description

Fetchtastic

A simple, cross-platform utility for downloading and managing Meshtastic firmware and Android app releases.

Fetchtastic automatically downloads the latest Meshtastic firmware and Android APK releases from GitHub, with support for notifications, scheduling, and repository browsing.

โœจ Features

  • ๐Ÿ”„ Automatic Downloads: Latest firmware and Android APK releases
  • ๐Ÿ“ฑ Cross-Platform: Linux, macOS, Windows, and Android (Termux)
  • ๐Ÿ—‚๏ธ Repository Browser: Browse and download files from meshtastic.github.io
  • ๐Ÿ”” Notifications: Push notifications via NTFY
  • โฐ Scheduling: Automatic downloads via cron/startup scripts
  • ๐ŸŽฏ Smart Selection: Choose specific devices and APK variants
  • ๐Ÿ“ฆ Auto-extraction: Extract firmware files from zip archives
  • ๐Ÿ”ง Easy Setup: One-command installation with guided setup

๐Ÿš€ Quick Start

One-Line Installation

Linux/MacOS/Android (Termux):

curl -sSL https://raw.githubusercontent.com/jeremiah-k/fetchtastic/main/src/fetchtastic/tools/setup_fetchtastic.sh | bash

Security Note: For security-conscious users, you can inspect the script before running it.

Windows (PowerShell):

irm https://raw.githubusercontent.com/jeremiah-k/fetchtastic/main/src/fetchtastic/tools/setup_fetchtastic.ps1 | iex

Security Note: For security-conscious users, you can inspect the script before running it.

Basic Usage

# Run setup (first time)
fetchtastic setup

# Download latest releases
fetchtastic download

# Browse repository files
fetchtastic repo browse

๐Ÿ“– Documentation

Installation Guides

Usage

๐Ÿ”ง Commands

fetchtastic setup      # Run the setup process
fetchtastic download   # Download firmware and APKs
fetchtastic repo browse # Browse repository files
fetchtastic repo clean  # Clean repository downloads
fetchtastic topic      # Show NTFY topic
fetchtastic version    # Show version
fetchtastic clean      # Remove all configuration

๐Ÿ“ File Organization

Downloads are organized in a clean structure:

~/Downloads/Meshtastic/
โ”œโ”€โ”€ apks/
โ”‚   โ”œโ”€โ”€ v2.3.2/
โ”‚   โ””โ”€โ”€ v2.3.1/
โ”œโ”€โ”€ firmware/
โ”‚   โ”œโ”€โ”€ v2.3.2/
โ”‚   โ”œโ”€โ”€ v2.3.1/
โ”‚   โ”œโ”€โ”€ repo-dls/      # Repository browser downloads
โ”‚   โ””โ”€โ”€ prerelease/    # Pre-release firmware (optional)

๐Ÿ”” Notifications

Get notified when new releases are downloaded:

  1. Enable NTFY during setup
  2. Install the ntfy app or use the web interface
  3. Subscribe to your unique topic
  4. Receive push notifications for new downloads

โฐ Scheduling

Set up automatic downloads:

  • Linux/macOS: Cron jobs (daily at 3 AM)
  • Windows: Startup folder shortcuts
  • Termux: Boot scripts and cron jobs

๐Ÿ†™ Upgrading

Automatic (recommended):

  • Windows: Use Start Menu โ†’ Fetchtastic โ†’ "Check for Updates"
  • Linux/macOS/Termux: Re-run the installation script

Manual:

pipx upgrade fetchtastic

๐Ÿค Contributing

Contributions are welcome! Please feel free to:

  • Report bugs and issues
  • Suggest new features
  • Submit pull requests
  • Improve documentation

Visit the GitHub repository to get started.

๐Ÿ“„ License

MIT License - see LICENSE for details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fetchtastic-0.8.3.tar.gz (207.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

fetchtastic-0.8.3-py3-none-any.whl (124.6 kB view details)

Uploaded Python 3

File details

Details for the file fetchtastic-0.8.3.tar.gz.

File metadata

  • Download URL: fetchtastic-0.8.3.tar.gz
  • Upload date:
  • Size: 207.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for fetchtastic-0.8.3.tar.gz
Algorithm Hash digest
SHA256 f01a4e2fcb143e3729b980b2685e9d525c0f7f0c3ff3775347c8b06032354d14
MD5 7a8e1a488f7d79aaf9983a5cde7f4c01
BLAKE2b-256 537c792ef55731e4fabce462528b6b496ce33bd27631bd05a50760c42f4eda5b

See more details on using hashes here.

Provenance

The following attestation bundles were made for fetchtastic-0.8.3.tar.gz:

Publisher: pypi-publish.yml on jeremiah-k/fetchtastic

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file fetchtastic-0.8.3-py3-none-any.whl.

File metadata

  • Download URL: fetchtastic-0.8.3-py3-none-any.whl
  • Upload date:
  • Size: 124.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for fetchtastic-0.8.3-py3-none-any.whl
Algorithm Hash digest
SHA256 cf212ce052982e2461c50a11343aa09518c161c4a02b83c7cef1d8165909e935
MD5 485200d3ed3442b710b3897dbf4663ff
BLAKE2b-256 d877fd06f4be6da215f1f08e46e3a9a94dc022daa6232b2a210ba2daf2171457

See more details on using hashes here.

Provenance

The following attestation bundles were made for fetchtastic-0.8.3-py3-none-any.whl:

Publisher: pypi-publish.yml on jeremiah-k/fetchtastic

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page