How jvde-github/ais-catcher-for-android works
AIS-catcher for Android turns an Android device and supported SDR into an AIS receiver: the user selects a source and starts the foreground service, which initializes and runs the native receiver; decoded traffic can be viewed in the app or forwarded over UDP. The README also documents TCP-based reception and a configurable web viewer. The principal Java/native and UI relationships are supported by excerpts or the source index; native internals and several optional integrations are not sampled, so those links are shown as documented or unverified rather than inferred as direct calls.
Main entry points: AisCatcherJava.java JNI bridge · MainActivity.java Main activity · AIScatcherNDK.cpp AIS-catcher engine · Settings.java Settings
Components 18
App control and UI
- Main activity
app/src/main/java/com/jvdegithub/aiscatcher/MainActivity.java - Receiver service
app/src/main/java/com/jvdegithub/aiscatcher/AisService.java - Log book
app/src/main/java/com/jvdegithub/aiscatcher/tools/LogBook.java
Receiver and native engine
- Device manager
app/src/main/java/com/jvdegithub/aiscatcher/DeviceManager.java - JNI bridge
app/src/main/java/com/jvdegithub/aiscatcher/AisCatcherJava.java - AIS-catcher engine
app/src/main/jni/JNI/AIScatcherNDK.cpp
AIS presentation and outputs
- Statistics view
app/src/main/java/com/jvdegithub/aiscatcher/ui/main/StatisticsFragment.java - Map viewer
app/src/main/java/com/jvdegithub/aiscatcher/ui/main/WebViewMapFragment.java - Local web viewer
- UDP output
Configuration and location
- Settings
app/src/main/java/com/jvdegithub/aiscatcher/Settings.java - Location helper
app/src/main/java/com/jvdegithub/aiscatcher/LocationHelper.java - IP input filter
app/src/main/java/com/jvdegithub/aiscatcher/tools/InputFilterIP.java - Numeric input filter
app/src/main/java/com/jvdegithub/aiscatcher/tools/InputFilterMinMax.java
Other components
- User
- USB SDR
- TCP receiver
- Plotting apps
Connections 20
- User → Main activity: operates
README.md - Main activity → Receiver service: starts
app/src/main/java/com/jvdegithub/aiscatcher/AisService.java - Receiver service → Device manager: reads device
app/src/main/java/com/jvdegithub/aiscatcher/AisService.java - Receiver service → JNI bridge: creates and runs
app/src/main/java/com/jvdegithub/aiscatcher/AisService.java - Device manager → JNI bridge: sets device
app/src/main/java/com/jvdegithub/aiscatcher/DeviceManager.java - JNI bridge → AIS-catcher engine: native calls
- USB SDR → AIS-catcher engine: supplies signals
README.md - TCP receiver → AIS-catcher engine: supplies stream
README.md - Settings → JNI bridge: configures outputs
app/src/main/java/com/jvdegithub/aiscatcher/Settings.java - Settings → IP input filter: validates address
app/src/main/java/com/jvdegithub/aiscatcher/Settings.java - Settings → Numeric input filter: validates numbers
app/src/main/java/com/jvdegithub/aiscatcher/Settings.java - Location helper → JNI bridge: sets coordinates
app/src/main/java/com/jvdegithub/aiscatcher/LocationHelper.java - Main activity → Statistics view: shows
app/src/main/java/com/jvdegithub/aiscatcher/MainActivity.java - Main activity → Map viewer: shows
app/src/main/java/com/jvdegithub/aiscatcher/MainActivity.java - JNI bridge → Statistics view: provides counters
app/src/main/java/com/jvdegithub/aiscatcher/ui/main/StatisticsFragment.java - Map viewer → Local web viewer: loads local page
app/src/main/java/com/jvdegithub/aiscatcher/ui/main/WebViewMapFragment.java - AIS-catcher engine → UDP output: forwards messages
README.md - UDP output → Plotting apps: sends NMEA
README.md - Main activity → Log book: records events
app/src/main/java/com/jvdegithub/aiscatcher/MainActivity.java - Map viewer → Log book: records viewer logs
app/src/main/java/com/jvdegithub/aiscatcher/ui/main/WebViewMapFragment.java