feat: Add file picker support and implement radio station functionality

- Updated GeneratedPluginRegistrant.swift to include file_picker plugin.
- Modified pubspec.lock to add dependencies for file_picker and cross_file.
- Updated pubspec.yaml to specify file_picker version.
- Created RadioStation model to represent internet radio stations.
- Implemented LibrarySearchDelegate for searching through playlists.
- Developed RadioScreen to display and manage internet radio stations.
- Added PlayerUiSettingsService for managing player UI settings.
- Implemented ReplayGainService for volume normalization based on ReplayGain metadata.
- Created NavigationHelper for nested navigation support in the app.

Author: dddevid

lib/models/models.dart

@@ -4,3 +4,4 @@ export 'song.dart';
 export 'playlist.dart';
 export 'server_config.dart';
 export 'music_folder.dart';
+export 'radio_station.dart';

lib/models/radio_station.dart

@@ -0,0 +1,42 @@
+/// Represents an internet radio station from the Subsonic/Navidrome server.
+class RadioStation {
+  final String id;
+  final String name;
+  final String streamUrl;
+  final String? homePageUrl;
+
+  RadioStation({
+    required this.id,
+    required this.name,
+    required this.streamUrl,
+    this.homePageUrl,
+  });
+
+  factory RadioStation.fromJson(Map<String, dynamic> json) {
+    return RadioStation(
+      id: json['id']?.toString() ?? '',
+      name: json['name'] ?? 'Unknown Station',
+      streamUrl: json['streamUrl'] ?? '',
+      homePageUrl: json['homePageUrl']?.toString(),
+    );
+  }
+
+  Map<String, dynamic> toJson() {
+    return {
+      'id': id,
+      'name': name,
+      'streamUrl': streamUrl,
+      'homePageUrl': homePageUrl,
+    };
+  }
+
+  @override
+  bool operator ==(Object other) =>
+      identical(this, other) ||
+      other is RadioStation &&
+          runtimeType == other.runtimeType &&
+          id == other.id;
+
+  @override
+  int get hashCode => id.hashCode;
+}

lib/models/server_config.dart

@@ -3,18 +3,22 @@ class ServerConfig {
   final String username;
   final String password;
   final bool useLegacyAuth;
+  final bool allowSelfSignedCertificates;
   final List<String> selectedMusicFolderIds;
   final String? serverType;
   final String? serverVersion;
+  final String? customCertificatePath; // Path to custom certificate file
 
   ServerConfig({
     required this.serverUrl,
     required this.username,
     required this.password,
     this.useLegacyAuth = false,
+    this.allowSelfSignedCertificates = false,
     this.selectedMusicFolderIds = const [],
     this.serverType,
     this.serverVersion,
+    this.customCertificatePath,
   });
 
   factory ServerConfig.fromJson(Map<String, dynamic> json) {
@@ -23,13 +27,15 @@ class ServerConfig {
       username: json['username'] ?? '',
       password: json['password'] ?? '',
       useLegacyAuth: json['useLegacyAuth'] ?? false,
+      allowSelfSignedCertificates: json['allowSelfSignedCertificates'] ?? false,
       selectedMusicFolderIds:
           (json['selectedMusicFolderIds'] as List<dynamic>?)
               ?.map((e) => e.toString())
               .toList() ??
           [],
       serverType: json['serverType'],
       serverVersion: json['serverVersion'],
+      customCertificatePath: json['customCertificatePath'],
     );
   }
 
@@ -39,9 +45,11 @@ class ServerConfig {
       'username': username,
       'password': password,
       'useLegacyAuth': useLegacyAuth,
+      'allowSelfSignedCertificates': allowSelfSignedCertificates,
       'selectedMusicFolderIds': selectedMusicFolderIds,
       'serverType': serverType,
       'serverVersion': serverVersion,
+      'customCertificatePath': customCertificatePath,
     };
   }
 
@@ -50,19 +58,25 @@ class ServerConfig {
     String? username,
     String? password,
     bool? useLegacyAuth,
+    bool? allowSelfSignedCertificates,
     List<String>? selectedMusicFolderIds,
     String? serverType,
     String? serverVersion,
+    String? customCertificatePath,
   }) {
     return ServerConfig(
       serverUrl: serverUrl ?? this.serverUrl,
       username: username ?? this.username,
       password: password ?? this.password,
       useLegacyAuth: useLegacyAuth ?? this.useLegacyAuth,
+      allowSelfSignedCertificates:
+          allowSelfSignedCertificates ?? this.allowSelfSignedCertificates,
       selectedMusicFolderIds:
           selectedMusicFolderIds ?? this.selectedMusicFolderIds,
       serverType: serverType ?? this.serverType,
       serverVersion: serverVersion ?? this.serverVersion,
+      customCertificatePath:
+          customCertificatePath ?? this.customCertificatePath,
     );
   }
 

lib/models/song.dart

@@ -16,6 +16,10 @@ class Song {
   final int? size;
   final String? path;
   final bool? starred;
+  final double? replayGainTrackGain;
+  final double? replayGainAlbumGain;
+  final double? replayGainTrackPeak;
+  final double? replayGainAlbumPeak;
 
   Song({
     required this.id,
@@ -35,9 +39,16 @@ class Song {
     this.size,
     this.path,
     this.starred,
+    this.replayGainTrackGain,
+    this.replayGainAlbumGain,
+    this.replayGainTrackPeak,
+    this.replayGainAlbumPeak,
   });
 
   factory Song.fromJson(Map<String, dynamic> json) {
+    // Parse ReplayGain data - Subsonic API provides it in a nested 'replayGain' object
+    final replayGain = json['replayGain'] as Map<String, dynamic>?;
+
     return Song(
       id: json['id']?.toString() ?? '',
       title: json['title'] ?? 'Unknown Title',
@@ -56,6 +67,10 @@ class Song {
       size: json['size'] as int?,
       path: json['path']?.toString(),
       starred: json['starred'] != null ? true : false,
+      replayGainTrackGain: (replayGain?['trackGain'] as num?)?.toDouble(),
+      replayGainAlbumGain: (replayGain?['albumGain'] as num?)?.toDouble(),
+      replayGainTrackPeak: (replayGain?['trackPeak'] as num?)?.toDouble(),
+      replayGainAlbumPeak: (replayGain?['albumPeak'] as num?)?.toDouble(),
     );
   }
 
@@ -77,6 +92,12 @@ class Song {
       'contentType': contentType,
       'size': size,
       'path': path,
+      'replayGain': {
+        if (replayGainTrackGain != null) 'trackGain': replayGainTrackGain,
+        if (replayGainAlbumGain != null) 'albumGain': replayGainAlbumGain,
+        if (replayGainTrackPeak != null) 'trackPeak': replayGainTrackPeak,
+        if (replayGainAlbumPeak != null) 'albumPeak': replayGainAlbumPeak,
+      },
     };
   }
 
@@ -105,6 +126,10 @@ class Song {
     int? size,
     String? path,
     bool? starred,
+    double? replayGainTrackGain,
+    double? replayGainAlbumGain,
+    double? replayGainTrackPeak,
+    double? replayGainAlbumPeak,
   }) {
     return Song(
       id: id ?? this.id,
@@ -124,6 +149,10 @@ class Song {
       size: size ?? this.size,
       path: path ?? this.path,
       starred: starred ?? this.starred,
+      replayGainTrackGain: replayGainTrackGain ?? this.replayGainTrackGain,
+      replayGainAlbumGain: replayGainAlbumGain ?? this.replayGainAlbumGain,
+      replayGainTrackPeak: replayGainTrackPeak ?? this.replayGainTrackPeak,
+      replayGainAlbumPeak: replayGainAlbumPeak ?? this.replayGainAlbumPeak,
     );
   }
-}
+}

lib/providers/auth_provider.dart

@@ -69,6 +69,8 @@ class AuthProvider extends ChangeNotifier {
     required String username,
     required String password,
     bool useLegacyAuth = false,
+    bool allowSelfSignedCertificates = false,
+    String? customCertificatePath,
   }) async {
     _state = AuthState.authenticating;
     _error = null;
@@ -79,6 +81,8 @@ class AuthProvider extends ChangeNotifier {
       username: username,
       password: password,
       useLegacyAuth: useLegacyAuth,
+      allowSelfSignedCertificates: allowSelfSignedCertificates,
+      customCertificatePath: customCertificatePath,
     );
 
     _subsonicService.configure(config);
@@ -116,7 +120,7 @@ class AuthProvider extends ChangeNotifier {
       return 'Cannot connect to server. Check the URL and your internet connection.';
     } else if (errorStr.contains('HandshakeException') ||
         errorStr.contains('CERTIFICATE_VERIFY_FAILED')) {
-      return 'SSL certificate error. Try using http:// instead of https://';
+      return 'SSL certificate error. Enable "Allow Self-Signed Certificates" for custom CA servers.';
     } else if (errorStr.contains('TimeoutException')) {
       return 'Connection timed out. Check your server URL.';
     } else if (errorStr.contains('FormatException')) {