Add audio service for sound notifications

- Implemented AudioService class to manage audio playback for transmit and receive notifications.
- Integrated just_audio package for audio playback functionality.
- Added methods to initialize audio service, load/save user preferences, and play sounds.
- Included functionality to enable/disable sound notifications and toggle settings.
- Pre-loaded audio assets for instant playback during notifications.

Author: MrAlders0n

.claude/settings.local.json

@@ -13,7 +13,8 @@
       "Bash(flutter doctor:*)",
       "Bash(flutter create:*)",
       "Bash(find:*)",
-      "Bash(grep:*)"
+      "Bash(grep:*)",
+      "Bash(flutter clean:*)"
     ]
   }
 }

android/app/src/main/java/io/flutter/plugins/GeneratedPluginRegistrant.java

@@ -15,6 +15,11 @@
 public final class GeneratedPluginRegistrant {
   private static final String TAG = "GeneratedPluginRegistrant";
   public static void registerWith(@NonNull FlutterEngine flutterEngine) {
+    try {
+      flutterEngine.getPlugins().add(new com.ryanheise.audio_session.AudioSessionPlugin());
+    } catch (Exception e) {
+      Log.e(TAG, "Error registering plugin audio_session, com.ryanheise.audio_session.AudioSessionPlugin", e);
+    }
     try {
       flutterEngine.getPlugins().add(new com.mr.flutter.plugin.filepicker.FilePickerPlugin());
     } catch (Exception e) {
@@ -45,6 +50,11 @@ public static void registerWith(@NonNull FlutterEngine flutterEngine) {
     } catch (Exception e) {
       Log.e(TAG, "Error registering plugin geolocator_android, com.baseflow.geolocator.GeolocatorPlugin", e);
     }
+    try {
+      flutterEngine.getPlugins().add(new com.ryanheise.just_audio.JustAudioPlugin());
+    } catch (Exception e) {
+      Log.e(TAG, "Error registering plugin just_audio, com.ryanheise.just_audio.JustAudioPlugin", e);
+    }
     try {
       flutterEngine.getPlugins().add(new dev.fluttercommunity.plus.packageinfo.PackageInfoPlugin());
     } catch (Exception e) {

android/local.properties

@@ -2,4 +2,4 @@ sdk.dir=/opt/homebrew/share/android-commandlinetools
 flutter.sdk=/opt/homebrew/share/flutter
 flutter.buildMode=release
 flutter.versionName=1.0.0
-flutter.versionCode=1769259963
+flutter.versionCode=1769283486

assets/received_packet.mp3

@@ -1,4 +1,6 @@
 PODS:
+  - audio_session (0.0.1):
+    - Flutter
   - DKImagePickerController/Core (4.3.9):
     - DKImagePickerController/ImageDataManager
     - DKImagePickerController/Resource
@@ -44,6 +46,9 @@ PODS:
   - geolocator_apple (1.2.0):
     - Flutter
     - FlutterMacOS
+  - just_audio (0.0.1):
+    - Flutter
+    - FlutterMacOS
   - package_info_plus (0.4.5):
     - Flutter
   - permission_handler_apple (9.3.0):
@@ -63,12 +68,14 @@ PODS:
     - Flutter
 
 DEPENDENCIES:
+  - audio_session (from `.symlinks/plugins/audio_session/ios`)
   - file_picker (from `.symlinks/plugins/file_picker/ios`)
   - Flutter (from `Flutter`)
   - flutter_background_service_ios (from `.symlinks/plugins/flutter_background_service_ios/ios`)
   - flutter_blue_plus_darwin (from `.symlinks/plugins/flutter_blue_plus_darwin/darwin`)
   - flutter_local_notifications (from `.symlinks/plugins/flutter_local_notifications/ios`)
   - geolocator_apple (from `.symlinks/plugins/geolocator_apple/darwin`)
+  - just_audio (from `.symlinks/plugins/just_audio/darwin`)
   - package_info_plus (from `.symlinks/plugins/package_info_plus/ios`)
   - permission_handler_apple (from `.symlinks/plugins/permission_handler_apple/ios`)
   - share_plus (from `.symlinks/plugins/share_plus/ios`)
@@ -84,6 +91,8 @@ SPEC REPOS:
     - SwiftyGif
 
 EXTERNAL SOURCES:
+  audio_session:
+    :path: ".symlinks/plugins/audio_session/ios"
   file_picker:
     :path: ".symlinks/plugins/file_picker/ios"
   Flutter:
@@ -96,6 +105,8 @@ EXTERNAL SOURCES:
     :path: ".symlinks/plugins/flutter_local_notifications/ios"
   geolocator_apple:
     :path: ".symlinks/plugins/geolocator_apple/darwin"
+  just_audio:
+    :path: ".symlinks/plugins/just_audio/darwin"
   package_info_plus:
     :path: ".symlinks/plugins/package_info_plus/ios"
   permission_handler_apple:
@@ -110,6 +121,7 @@ EXTERNAL SOURCES:
     :path: ".symlinks/plugins/wakelock_plus/ios"
 
 SPEC CHECKSUMS:
+  audio_session: 9bb7f6c970f21241b19f5a3658097ae459681ba0
   DKImagePickerController: 946cec48c7873164274ecc4624d19e3da4c1ef3c
   DKPhotoGallery: b3834fecb755ee09a593d7c9e389d8b5d6deed60
   file_picker: a0560bc09d61de87f12d246fc47d2119e6ef37be
@@ -118,6 +130,7 @@ SPEC CHECKSUMS:
   flutter_blue_plus_darwin: 20a08bfeaa0f7804d524858d3d8744bcc1b6dbc3
   flutter_local_notifications: ad39620c743ea4c15127860f4b5641649a988100
   geolocator_apple: ab36aa0e8b7d7a2d7639b3b4e48308394e8cef5e
+  just_audio: 4e391f57b79cad2b0674030a00453ca5ce817eed
   package_info_plus: af8e2ca6888548050f16fa2f1938db7b5a5df499
   permission_handler_apple: 4ed2196e43d0651e8ff7ca3483a069d469701f2d
   SDWebImage: e9c98383c7572d713c1a0d7dd2783b10599b9838

assets/transmitted_packet.mp3

@@ -40,6 +40,8 @@
 	<string>This app needs background GPS for continuous wardriving</string>
 	<key>NSLocationWhenInUseUsageDescription</key>
 	<string>This app needs GPS for wardriving location tracking</string>
+	<key>NSMicrophoneUsageDescription</key>
+	<string>This app uses audio for notification sounds</string>
 	<key>NSPhotoLibraryUsageDescription</key>
 	<string>This app may need access to photos when importing or exporting data files</string>
 	<key>ITSAppUsesNonExemptEncryption</key>

ios/Podfile.lock

@@ -16,6 +16,7 @@ import '../models/repeater.dart';
 import '../models/user_preferences.dart';
 import '../services/api_queue_service.dart';
 import '../services/api_service.dart';
+import '../services/audio_service.dart';
 import '../services/background_service.dart';
 import '../services/debug_file_logger.dart';
 import '../services/offline_session_service.dart';
@@ -66,6 +67,7 @@ class AppStateProvider extends ChangeNotifier {
   late final ApiQueueService _apiQueueService;
   late final OfflineSessionService _offlineSessionService;
   late final DeviceModelService _deviceModelService;
+  final AudioService _audioService = AudioService();
   late final CooldownTimer _cooldownTimer; // Shared cooldown for TX Ping and Active Mode
   late final AutoPingTimer _autoPingTimer;
   late final RxWindowTimer _rxWindowTimer;
@@ -230,6 +232,10 @@ class AppStateProvider extends ChangeNotifier {
   // Regional channels getter (for UI)
   List<String> get regionalChannels => List.unmodifiable(_regionalChannels);
 
+  // Audio service getters
+  bool get isSoundEnabled => _audioService.isEnabled;
+  AudioService get audioService => _audioService;
+
   bool get isConnected => _connectionStep == ConnectionStep.connected;
   bool get hasGpsLock => _gpsStatus == GpsStatus.locked;
   bool get canPing => isConnected && hasGpsLock;
@@ -390,6 +396,9 @@ class AppStateProvider extends ChangeNotifier {
     // Start GPS (may skip if permissions not yet granted - disclosure flow handles that)
     await _gpsService.startWatching();
 
+    // Initialize audio service for sound notifications
+    await _audioService.initialize();
+
     notifyListeners();
   }
 
@@ -625,6 +634,7 @@ class AppStateProvider extends ChangeNotifier {
         discoveryWindowTimer: _discoveryWindowTimer,
         deviceId: _deviceId,
         txTracker: _txTracker,
+        audioService: _audioService,
       );
 
       // Set validation callbacks
@@ -719,6 +729,8 @@ class AppStateProvider extends ChangeNotifier {
             if (isNew) {
               // Add new event
               existingEvents.add(newEvent);
+              // Play receive sound for new repeater echo
+              _audioService.playReceiveSound();
             } else {
               // Update existing event's SNR
               final idx = existingEvents.indexWhere((e) => e.repeaterId == repeater.repeaterId);
@@ -901,6 +913,8 @@ class AppStateProvider extends ChangeNotifier {
             debugLog('[APP] Created IMMEDIATE RX pin for repeater: ${observation.repeaterId} '
                 'at ${observation.lat.toStringAsFixed(5)},${observation.lon.toStringAsFixed(5)} '
                 '(batch tracking: ${_currentBatchRepeaters.length} repeaters, rxCount: ${_pingStats.rxCount})');
+            // Play receive sound for new RX observation
+            _audioService.playReceiveSound();
             notifyListeners();
           } else {
             debugLog('[APP] Repeater ${observation.repeaterId} already has pin in current batch, SNR will update on flush if better');
@@ -1599,6 +1613,18 @@ class AppStateProvider extends ChangeNotifier {
     _savePreferences();
   }
 
+  /// Toggle sound notifications on/off
+  Future<void> toggleSoundEnabled() async {
+    await _audioService.toggle();
+    notifyListeners();
+  }
+
+  /// Set sound notifications enabled state
+  Future<void> setSoundEnabled(bool enabled) async {
+    await _audioService.setEnabled(enabled);
+    notifyListeners();
+  }
+
   /// Navigate to coordinates on map (triggered from log entries)
   void navigateToMapCoordinates(double latitude, double longitude) {
     _mapNavigationTarget = (lat: latitude, lon: longitude);
@@ -2253,6 +2279,7 @@ class AppStateProvider extends ChangeNotifier {
     _offlineSessionService.dispose();
     _apiService.dispose();
     _bluetoothService.dispose();
+    _audioService.dispose();
     _cooldownTimer.dispose();
     _autoPingTimer.dispose();
     _rxWindowTimer.dispose();

ios/Runner/Info.plist

@@ -148,17 +148,15 @@ class _HomeScreenState extends State<HomeScreen> {
 
           // Compact connection info
           const Padding(
-            padding: EdgeInsets.all(12),
+            padding: EdgeInsets.fromLTRB(12, 12, 12, 4),
             child: ConnectionPanel(compact: true),
           ),
 
           // Ping controls
           const Padding(
-            padding: EdgeInsets.all(12),
+            padding: EdgeInsets.fromLTRB(12, 4, 12, 12),
             child: PingControls(),
           ),
-
-          const SizedBox(height: 8),
         ],
       ),
     );
@@ -225,7 +223,7 @@ class _HomeScreenState extends State<HomeScreen> {
         borderRadius: BorderRadius.vertical(top: Radius.circular(16)),
       ),
       builder: (context) => DraggableScrollableSheet(
-        initialChildSize: 0.6,
+        initialChildSize: 0.85,
         minChildSize: 0.3,
         maxChildSize: 0.9,
         expand: false,
@@ -304,6 +302,14 @@ class _HomeScreenState extends State<HomeScreen> {
                 description: 'Save pings locally instead of uploading immediately. Useful when you have poor connectivity. Upload saved sessions later from the Settings tab.',
               ),
 
+              // Sound toggle
+              _buildHelpItem(
+                icon: Icons.volume_up,
+                color: Colors.blue,
+                title: 'Sound',
+                description: 'Sonar tone when sending TX/Discovery pings. Message tone when receiving valid RX packets, heard repeaters, or discovery responses.',
+              ),
+
               const SizedBox(height: 8),
             ],
           ),

lib/providers/app_state_provider.dart

@@ -0,0 +1,135 @@
+import 'package:just_audio/just_audio.dart';
+import 'package:hive_flutter/hive_flutter.dart';
+
+import '../utils/debug_logger_io.dart';
+
+/// Audio service for playing sound notifications
+/// Plays sounds when TX pings are sent and RX packets are received
+class AudioService {
+  static const String _prefsBoxName = 'audio_preferences';
+  static const String _enabledKey = 'sound_enabled';
+
+  AudioPlayer? _txPlayer;
+  AudioPlayer? _rxPlayer;
+  bool _initialized = false;
+  bool _enabled = false; // Disabled by default, remembered once user changes it
+
+  /// Whether the audio service is initialized
+  bool get isInitialized => _initialized;
+
+  /// Whether sound notifications are enabled
+  bool get isEnabled => _enabled;
+
+  /// Initialize the audio service and pre-load sounds
+  Future<void> initialize() async {
+    if (_initialized) return;
+
+    try {
+      debugLog('[AUDIO] Initializing audio service');
+
+      // Load enabled state from preferences
+      await _loadEnabledState();
+
+      // Create audio players
+      _txPlayer = AudioPlayer();
+      _rxPlayer = AudioPlayer();
+
+      // Pre-load the audio assets for instant playback
+      // Using asset:// prefix for just_audio
+      await _txPlayer!.setAsset('assets/transmitted_packet.mp3');
+      await _rxPlayer!.setAsset('assets/received_packet.mp3');
+
+      _initialized = true;
+      debugLog('[AUDIO] Audio service initialized, enabled=$_enabled');
+    } catch (e) {
+      debugError('[AUDIO] Failed to initialize audio service: $e');
+      // Don't throw - audio is not critical functionality
+      _initialized = false;
+    }
+  }
+
+  /// Load enabled state from Hive storage
+  Future<void> _loadEnabledState() async {
+    try {
+      final box = await Hive.openBox(_prefsBoxName);
+      final enabled = box.get(_enabledKey);
+      if (enabled != null) {
+        _enabled = enabled as bool;
+        debugLog('[AUDIO] Loaded enabled state: $_enabled');
+      } else {
+        debugLog('[AUDIO] No saved preference, using default: $_enabled');
+      }
+    } catch (e) {
+      debugError('[AUDIO] Failed to load enabled state: $e');
+      // Keep default (disabled)
+    }
+  }
+
+  /// Save enabled state to Hive storage
+  Future<void> _saveEnabledState() async {
+    try {
+      final box = await Hive.openBox(_prefsBoxName);
+      await box.put(_enabledKey, _enabled);
+      debugLog('[AUDIO] Saved enabled state: $_enabled');
+    } catch (e) {
+      debugError('[AUDIO] Failed to save enabled state: $e');
+    }
+  }
+
+  /// Play the transmit sound (when TX ping or Discovery request is sent)
+  Future<void> playTransmitSound() async {
+    debugLog('[AUDIO] playTransmitSound called - initialized=$_initialized, enabled=$_enabled');
+    if (!_initialized || !_enabled) {
+      debugLog('[AUDIO] playTransmitSound skipped - not initialized or disabled');
+      return;
+    }
+
+    try {
+      debugLog('[AUDIO] Playing transmit sound...');
+      // Seek to start and play
+      await _txPlayer?.seek(Duration.zero);
+      await _txPlayer?.play();
+      debugLog('[AUDIO] Transmit sound played successfully');
+    } catch (e) {
+      debugError('[AUDIO] Failed to play transmit sound: $e');
+    }
+  }
+
+  /// Play the receive sound (when repeater echo or RX observation is detected)
+  Future<void> playReceiveSound() async {
+    if (!_initialized || !_enabled) return;
+
+    try {
+      // Seek to start and play
+      await _rxPlayer?.seek(Duration.zero);
+      await _rxPlayer?.play();
+      debugLog('[AUDIO] Played receive sound');
+    } catch (e) {
+      debugError('[AUDIO] Failed to play receive sound: $e');
+    }
+  }
+
+  /// Enable or disable sound notifications
+  Future<void> setEnabled(bool enabled) async {
+    if (_enabled == enabled) return;
+
+    _enabled = enabled;
+    debugLog('[AUDIO] Sound notifications ${enabled ? 'enabled' : 'disabled'}');
+    await _saveEnabledState();
+  }
+
+  /// Toggle sound notifications
+  Future<void> toggle() async {
+    await setEnabled(!_enabled);
+  }
+
+  /// Dispose of audio resources
+  void dispose() {
+    debugLog('[AUDIO] Disposing audio service');
+    _txPlayer?.dispose();
+    _rxPlayer?.dispose();
+    _txPlayer = null;
+    _rxPlayer = null;
+    _initialized = false;
+  }
+}