Skip to content

na7q/aprsdroid

ย 
ย 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ“ก NA7Q APRSdroid

The Ultimate APRS Companion for Android - Enhanced by NA7Q

๐ŸŒŸ This is the NA7Q enhanced build of the original APRSdroid developed by NA7Q with extensive additional features and improvements specifically designed for advanced amateur radio operators. This is a work in progress with active development and regular updates.



โœจ What is NA7Q APRSdroid?

NA7Q APRSdroid is a powerful, extensively enhanced Android application developed by NA7Q based on the original APRSdroid. This version adds numerous professional-grade features while maintaining seamless integration with the APRS (Automatic Packet Reporting System) network. This build is a work in progress, and some features may be incomplete or broken at the time of download as development actively continues.

๐ŸŽฏ Core Features

  • ๐Ÿ“ Real-time Position Reporting - Share your location with the APRS network
  • ๐Ÿ—บ๏ธ Interactive Station Map - Visualize nearby amateur radio stations with offline mapping
  • ๐Ÿ’ฌ APRS Messaging - Send and receive messages through the network
  • ๐Ÿ”„ Network Integration - Full compatibility with APRS infrastructure
  • ๐ŸŽจ Modern Android UI - Clean, intuitive interface designed for mobile use

๐Ÿš€ NA7Q Enhanced Features (Not in Official APRSdroid)

Based on the official feature list from NA7Q:

๐Ÿ“ก RF & Networking

  • ๐Ÿ”„ Digipeater - Direct or full digipeating capabilities
  • ๐ŸŒ 2-Way IGating - Full Internet Gateway functionality
  • ๐Ÿ“ถ Flexible Packet Routing - Send packets via RF and APRS-IS, or RF only while IGating
  • ๐ŸŽš๏ธ Radio Control - Support for Vero, BTech, Radioddity, and other radios
  • ๐Ÿ“ป DigiRig Support - Seamless integration with DigiRig interfaces
  • ๐Ÿ”ต Bluetooth Low Energy - Stable BLE support (now stable and near completion!)

๐Ÿ—บ๏ธ Advanced Offline Mapping

  • ๐Ÿ—บ๏ธ Offline Maps with MBTiles - Complete offline operation capability
  • ๐Ÿ†• MapsForge V3 Support - NEW! Enhanced offline mapping with MapsForge
  • ๐ŸŒ OpenStreetMap Integration - Full OSM compatibility for mapping
  • โš ๏ธ Note: This version does not include the Google Maps API for enhanced privacy and reduced dependencies

๐Ÿ“Š Data & Compression

  • ๐Ÿ—œ๏ธ Mic-E Compression - Efficient position encoding
  • ๐Ÿšจ Mic-E Emergency Status - Including EMERGENCY status support
  • ๐Ÿ“ˆ Standard Compression - Multiple compression formats supported

โš™๏ธ User Experience Enhancements

  • ๐Ÿ“ Unit Options - Choose between Metric or Imperial units
  • ๐Ÿ”ง Hardware Control - Option to disable hardware acceleration
  • ๐Ÿ“Š Enhanced Station Viewer - Added speed and course information
  • ๐Ÿ’ฌ Advanced Messaging Tweaks - Features for power users
  • ๐Ÿ†” Message ID Control - Option to disable Message ID
  • ๐Ÿ“‹ Smart Hub Log - Sort by distance or newest stations
  • ๐Ÿ” Under-the-Hood Improvements - Numerous performance and stability enhancements

๐Ÿ”ฎ Development Roadmap

NA7Q is actively developing additional features, including:

  • ๐ŸŒค๏ธ Improved APRS Parser - Enhanced data parsing capabilities
  • โ˜๏ธ Weather Readability - Better weather data display
  • ๐Ÿ“ Altitude in Hub Log - Show altitude information
  • ๐Ÿ–ฅ๏ธ Full Screen Mode - Immersive display option
  • ๐Ÿ“ฑ Mobile HUD Integration - Enhanced heads-up display
  • ๐Ÿ†” Device Identifier in Hub - Better station identification
  • ๐Ÿ”ง BLE Bug Fixes - Crash fixes for BLE device selection
  • ๐Ÿ“Ÿ APRS Message Query Commands - Support for ?APRSM and similar
  • ๐Ÿญ MICE Code Cleanup - Improved Mic-E implementation
  • ๐Ÿ“‹ Enhanced Beacon Types - List menu for beacon selection
  • ๐Ÿšจ MICE Emergency Alerts - Alert system for emergency status
  • ๐Ÿ“ก Station Path Display - Show direct vs digipeated stations
  • โž• And Much More!

๐Ÿš€ Quick Start

๐Ÿ“ฒ Installation

โš ๏ธ Important: Uninstall any previous OFFICIAL version of APRSdroid before installing NA7Q's version

  1. Download the latest APK from release page
  2. Optional: Download the Mobile HUD APK from https://na7q.com/aprsdroid-osm/ (experimental, landscape mode recommended)
  3. Install both APKs on your Android device

๐Ÿ—บ๏ธ Setting Up Offline Maps

For Android 11+ devices, manual storage permissions are required for offline mapping files:

  1. In APRSdroid settings, go to OSM Maps category
  2. Tap "Grant Storage Permissions"
  3. Grant ALL file permissions for device storage access
  4. Set map viewer to OpenStreetMap.org to use offline maps
  5. Configure offline maps in the OSM Maps preferences section

๐Ÿ—บ๏ธ Getting Maps

NA7Q provides several tools for downloading offline maps:

Map Requirements:

  • Use MBTiles format (PNG or JPG, NOT Vector/PBF)
  • Specify precise locations like "Portland, Oregon" or "Texas USA"
  • Zoom levels 1-18 (recommend 13-14 for states)
  • Note: Large areas at high zoom can be 2-5GB+

๐Ÿ“š Documentation & Support


๐Ÿ’– Support NA7Q's Development

NA7Q APRSdroid has had over 1851 downloads and the Mobile HUD has had 400 downloads, making it a valuable resource for the amateur radio community. This project is developed and maintained by NA7Q as a labor of love for fellow amateur radio enthusiasts.

Support on Patreon

Your support helps fund continued development, new features, and keeps NA7Q APRSdroid free for the amateur radio community! ๐Ÿ™

If you like the work NA7Q has put into this enhanced APRSdroid, please consider supporting on Patreon!


๐Ÿ› ๏ธ Development & Compilation

๐Ÿ—๏ธ Build Environment

APRSdroid is crafted in Scala using the gradle-android-scala-plugin. While the compilation process is robust, please note:

  • โฑ๏ธ Full builds take approximately 3 minutes
  • ๐Ÿ”„ Incremental builds may occasionally produce non-functional APKs
  • ๐Ÿ—บ๏ธ Google Maps API key required for map functionality

๐Ÿ“‹ Prerequisites

  • โ˜• Java 8 JDK
  • ๐Ÿ™ Git for version control
  • ๐Ÿ—บ๏ธ Google Maps API Key (Get yours here) - Optional, only if you want Google Maps support

๐Ÿ—๏ธ Important Notice: Google Maps

โš ๏ธ This enhanced fork does NOT include the Google Maps API for improved privacy and reduced dependencies. The app uses offline mapping solutions (MBTiles and MapsForge) instead. If you require Google Maps functionality, you can build the app from source and add your own API key following the build instructions below.

๐Ÿš€ Complete Build Instructions

sudo apt-get install -y git openjdk-8-jdk vim-nox wget unzip

cmdline_tool_file="commandlinetools-linux-6609375_latest.zip"
export ANDROID_SDK_ROOT="$(pwd)/android"
mkdir -p "${ANDROID_SDK_ROOT}"
wget "https://dl.google.com/android/repository/${cmdline_tool_file}"
unzip "${cmdline_tool_file}" -d "${ANDROID_SDK_ROOT}/cmdline-tools"
rm -f "${cmdline_tool_file}"
export PATH="${ANDROID_SDK_ROOT}/cmdline-tools/tools/bin:${PATH}"
export PATH="${ANDROID_SDK_ROOT}/platform-tools:${PATH}"
export PATH="${ANDROID_SDK_ROOT}/emulator:${PATH}"
mkdir "${ANDROID_SDK_ROOT}/licenses"
echo 24333f8a63b6825ea9c5514f83c2829b004d1fee > "${ANDROID_SDK_ROOT}/licenses/android-sdk-license"
echo 84831b9409646a918e30573bab4c9c91346d8abd > "${ANDROID_SDK_ROOT}/licenses/android-sdk-preview-license"
sdkmanager --install emulator 'system-images;android-24;default;armeabi-v7a'

git clone https://github.com/na7q/aprsdroid/
cd aprsdroid
git submodule update --init --recursive
# replace AI... with your API key:
echo "mapsApiKey=AI..." > local.properties
# for a debug build:
./gradlew assembleDebug
# for a release build:
./gradlew assembleRelease

๐Ÿ“œ License

This project is licensed under the GNU General Public License v2.0 - see the LICENSE file for details.


๐Ÿค Contributing

We welcome contributions from the amateur radio community! Whether you're fixing bugs, adding features, or improving documentation, your help makes APRSdroid better for everyone.


Made with โค๏ธ by Amateur Radio operators, for Amateur Radio operators

73 and happy APRSing! ๐Ÿ“ก

About

APRSdroid - Geo-Location for Radio Amateurs

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Scala 96.3%
  • Java 3.0%
  • Shell 0.7%