feat: add YouTube provider for lossy downloads via Cobalt API

- New YouTube download provider with Opus 256kbps and MP3 320kbps options - SongLink/Odesli integration for Spotify/Deezer ID to YouTube URL conversion - YouTube video ID detection for YT Music extension compatibility - Parallel cover art and lyrics fetching during download - Queue progress shows bytes (X.X MB) for streaming downloads - Full metadata embedding: cover, lyrics, title, artist, album, track#, disc#, year, ISRC - Removed Tidal HIGH (lossy AAC) option - use YouTube for lossy instead - Bumped version to 3.6.0
2026-08-20 18:07:44 +02:00 · 2026-02-09 18:15:43 +07:00
parent 23f5aa11b0
commit 7ec5d28caf
30 changed files with 1225 additions and 166 deletions
@@ -3502,6 +3502,12 @@ abstract class AppLocalizations {
  /// **'Actual quality depends on track availability from the service'**
  String get qualityNote;

+  /// Note for YouTube service explaining lossy-only quality
+  ///
+  /// In en, this message translates to:
+  /// **'YouTube provides lossy audio only. Not part of lossless fallback.'**
+  String get youtubeQualityNote;
+
  /// Setting - show quality picker
  ///
  /// In en, this message translates to:
@@ -1933,6 +1933,10 @@ class AppLocalizationsDe extends AppLocalizations {
  String get qualityNote =>
      'Actual quality depends on track availability from the service';

+  @override
+  String get youtubeQualityNote =>
+      'YouTube provides lossy audio only. Not part of lossless fallback.';
+
  @override
  String get downloadAskBeforeDownload => 'Ask Before Download';

@@ -1918,6 +1918,10 @@ class AppLocalizationsEn extends AppLocalizations {
  String get qualityNote =>
      'Actual quality depends on track availability from the service';

+  @override
+  String get youtubeQualityNote =>
+      'YouTube provides lossy audio only. Not part of lossless fallback.';
+
  @override
  String get downloadAskBeforeDownload => 'Ask Before Download';

@@ -1918,6 +1918,10 @@ class AppLocalizationsEs extends AppLocalizations {
  String get qualityNote =>
      'Actual quality depends on track availability from the service';

+  @override
+  String get youtubeQualityNote =>
+      'YouTube provides lossy audio only. Not part of lossless fallback.';
+
  @override
  String get downloadAskBeforeDownload => 'Ask Before Download';

@@ -1918,6 +1918,10 @@ class AppLocalizationsFr extends AppLocalizations {
  String get qualityNote =>
      'Actual quality depends on track availability from the service';

+  @override
+  String get youtubeQualityNote =>
+      'YouTube provides lossy audio only. Not part of lossless fallback.';
+
  @override
  String get downloadAskBeforeDownload => 'Ask Before Download';

@@ -1918,6 +1918,10 @@ class AppLocalizationsHi extends AppLocalizations {
  String get qualityNote =>
      'Actual quality depends on track availability from the service';

+  @override
+  String get youtubeQualityNote =>
+      'YouTube provides lossy audio only. Not part of lossless fallback.';
+
  @override
  String get downloadAskBeforeDownload => 'Ask Before Download';

@@ -1930,6 +1930,10 @@ class AppLocalizationsId extends AppLocalizations {
  String get qualityNote =>
      'Kualitas sebenarnya tergantung ketersediaan lagu dari layanan';

+  @override
+  String get youtubeQualityNote =>
+      'YouTube provides lossy audio only. Not part of lossless fallback.';
+
  @override
  String get downloadAskBeforeDownload => 'Tanya Sebelum Unduh';

@@ -1906,6 +1906,10 @@ class AppLocalizationsJa extends AppLocalizations {
  @override
  String get qualityNote => '実際の品質はサービスからのトラックの可用性に依存します';

+  @override
+  String get youtubeQualityNote =>
+      'YouTube provides lossy audio only. Not part of lossless fallback.';
+
  @override
  String get downloadAskBeforeDownload => 'ダウンロード前に確認する';

@@ -1918,6 +1918,10 @@ class AppLocalizationsKo extends AppLocalizations {
  String get qualityNote =>
      'Actual quality depends on track availability from the service';

+  @override
+  String get youtubeQualityNote =>
+      'YouTube provides lossy audio only. Not part of lossless fallback.';
+
  @override
  String get downloadAskBeforeDownload => 'Ask Before Download';

@@ -1918,6 +1918,10 @@ class AppLocalizationsNl extends AppLocalizations {
  String get qualityNote =>
      'Actual quality depends on track availability from the service';

+  @override
+  String get youtubeQualityNote =>
+      'YouTube provides lossy audio only. Not part of lossless fallback.';
+
  @override
  String get downloadAskBeforeDownload => 'Ask Before Download';

@@ -1918,6 +1918,10 @@ class AppLocalizationsPt extends AppLocalizations {
  String get qualityNote =>
      'Actual quality depends on track availability from the service';

+  @override
+  String get youtubeQualityNote =>
+      'YouTube provides lossy audio only. Not part of lossless fallback.';
+
  @override
  String get downloadAskBeforeDownload => 'Ask Before Download';

@@ -1956,6 +1956,10 @@ class AppLocalizationsRu extends AppLocalizations {
  String get qualityNote =>
      'Фактическое качество зависит от доступности треков в сервисе';

+  @override
+  String get youtubeQualityNote =>
+      'YouTube provides lossy audio only. Not part of lossless fallback.';
+
  @override
  String get downloadAskBeforeDownload => 'Спрашивать перед скачиванием';

@@ -1933,6 +1933,10 @@ class AppLocalizationsTr extends AppLocalizations {
  String get qualityNote =>
      'Actual quality depends on track availability from the service';

+  @override
+  String get youtubeQualityNote =>
+      'YouTube provides lossy audio only. Not part of lossless fallback.';
+
  @override
  String get downloadAskBeforeDownload => 'Ask Before Download';

@@ -1918,6 +1918,10 @@ class AppLocalizationsZh extends AppLocalizations {
  String get qualityNote =>
      'Actual quality depends on track availability from the service';

+  @override
+  String get youtubeQualityNote =>
+      'YouTube provides lossy audio only. Not part of lossless fallback.';
+
  @override
  String get downloadAskBeforeDownload => 'Ask Before Download';

@@ -1414,6 +1414,8 @@
  "@lossyFormatOpusSubtitle": {"description": "Opus format description"},
  "qualityNote": "Actual quality depends on track availability from the service",
  "@qualityNote": {"description": "Note about quality availability"},
+  "youtubeQualityNote": "YouTube provides lossy audio only. Not part of lossless fallback.",
+  "@youtubeQualityNote": {"description": "Note for YouTube service explaining lossy-only quality"},

  "downloadAskBeforeDownload": "Ask Before Download",
  "@downloadAskBeforeDownload": {"description": "Setting - show quality picker"},
@@ -28,6 +28,7 @@ class DownloadItem {
  final DownloadStatus status;
  final double progress;
  final double speedMBps;
+  final int bytesReceived; // Bytes downloaded so far (for unknown size downloads)
  final String? filePath;
  final String? error;
  final DownloadErrorType? errorType;
@@ -41,6 +42,7 @@ class DownloadItem {
    this.status = DownloadStatus.queued,
    this.progress = 0.0,
    this.speedMBps = 0.0,
+    this.bytesReceived = 0,
    this.filePath,
    this.error,
    this.errorType,
@@ -55,6 +57,7 @@ class DownloadItem {
    DownloadStatus? status,
    double? progress,
    double? speedMBps,
+    int? bytesReceived,
    String? filePath,
    String? error,
    DownloadErrorType? errorType,
@@ -68,6 +71,7 @@ class DownloadItem {
      status: status ?? this.status,
      progress: progress ?? this.progress,
      speedMBps: speedMBps ?? this.speedMBps,
+      bytesReceived: bytesReceived ?? this.bytesReceived,
      filePath: filePath ?? this.filePath,
      error: error ?? this.error,
      errorType: errorType ?? this.errorType,
@@ -15,6 +15,7 @@ DownloadItem _$DownloadItemFromJson(Map<String, dynamic> json) => DownloadItem(
      DownloadStatus.queued,
  progress: (json['progress'] as num?)?.toDouble() ?? 0.0,
  speedMBps: (json['speedMBps'] as num?)?.toDouble() ?? 0.0,
+  bytesReceived: (json['bytesReceived'] as num?)?.toInt() ?? 0,
  filePath: json['filePath'] as String?,
  error: json['error'] as String?,
  errorType: $enumDecodeNullable(_$DownloadErrorTypeEnumMap, json['errorType']),
@@ -30,6 +31,7 @@ Map<String, dynamic> _$DownloadItemToJson(DownloadItem instance) =>
      'status': _$DownloadStatusEnumMap[instance.status]!,
      'progress': instance.progress,
      'speedMBps': instance.speedMBps,
+      'bytesReceived': instance.bytesReceived,
      'filePath': instance.filePath,
      'error': instance.error,
      'errorType': _$DownloadErrorTypeEnumMap[instance.errorType],
@@ -600,11 +600,13 @@ class _ProgressUpdate {
  final DownloadStatus status;
  final double progress;
  final double? speedMBps;
+  final int? bytesReceived;

  const _ProgressUpdate({
    required this.status,
    required this.progress,
    this.speedMBps,
+    this.bytesReceived,
  });
 }

@@ -801,6 +803,7 @@ class DownloadQueueNotifier extends Notifier<DownloadQueueState> {
              status: DownloadStatus.downloading,
              progress: percentage,
              speedMBps: speedMBps,
+              bytesReceived: bytesReceived,
            );

            final mbReceived = bytesReceived / (1024 * 1024);
@@ -835,10 +838,12 @@ class DownloadQueueNotifier extends Notifier<DownloadQueueState> {
              status: update.status,
              progress: update.progress,
              speedMBps: update.speedMBps ?? current.speedMBps,
+              bytesReceived: update.bytesReceived ?? current.bytesReceived,
            );
            if (current.status != next.status ||
                current.progress != next.progress ||
-                current.speedMBps != next.speedMBps) {
+                current.speedMBps != next.speedMBps ||
+                current.bytesReceived != next.bytesReceived) {
              if (!changed) {
                updatedItems = List<DownloadItem>.from(updatedItems);
                changed = true;
@@ -1203,6 +1208,13 @@ class DownloadQueueNotifier extends Notifier<DownloadQueueState> {
  }

  String _determineOutputExt(String quality, String service) {
+    // YouTube provider - lossy only (Opus or MP3)
+    if (service.toLowerCase() == 'youtube') {
+      if (quality.toLowerCase().contains('mp3')) {
+        return '.mp3';
+      }
+      return '.opus';
+    }
    if (service.toLowerCase() == 'tidal' && quality == 'HIGH') {
      return '.m4a';
    }
@@ -2259,6 +2271,15 @@ class DownloadQueueNotifier extends Notifier<DownloadQueueState> {
          await musicDir.create(recursive: true);
        }
        state = state.copyWith(outputDir: musicDir.path);
+      } else if (!isValidIosWritablePath(state.outputDir)) {
+        // Check for other invalid paths (like container root without Documents/)
+        _log.w(
+          'iOS: Invalid output path detected (container root?), falling back to app Documents folder',
+        );
+        _log.w('Original path: ${state.outputDir}');
+        final correctedPath = await validateOrFixIosPath(state.outputDir);
+        _log.i('Corrected path: $correctedPath');
+        state = state.copyWith(outputDir: correctedPath);
      }
    }

@@ -2637,6 +2658,36 @@ class DownloadQueueNotifier extends Notifier<DownloadQueueState> {
        final fileName = useSaf ? (safFileName ?? '') : '';
        final outputExt = useSaf ? safOutputExt : '';

+        // YouTube provider - lossy only, bypasses fallback chain
+        if (item.service == 'youtube') {
+          _log.d('Using YouTube/Cobalt provider for download');
+          _log.d('Quality: $quality (lossy only)');
+          _log.d('Output dir: $outputDir');
+          return PlatformBridge.downloadFromYouTube(
+            trackName: trackToDownload.name,
+            artistName: trackToDownload.artistName,
+            albumName: trackToDownload.albumName,
+            albumArtist: normalizedAlbumArtist,
+            coverUrl: trackToDownload.coverUrl,
+            outputDir: outputDir,
+            filenameFormat: state.filenameFormat,
+            quality: quality,
+            trackNumber: trackToDownload.trackNumber ?? 1,
+            discNumber: trackToDownload.discNumber ?? 1,
+            releaseDate: trackToDownload.releaseDate,
+            itemId: item.id,
+            durationMs: trackToDownload.duration,
+            isrc: trackToDownload.isrc,
+            spotifyId: trackToDownload.id,
+            deezerId: deezerTrackId,
+            storageMode: storageMode,
+            safTreeUri: treeUri,
+            safRelativeDir: relativeDir,
+            safFileName: fileName,
+            safOutputExt: outputExt,
+          );
+        }
+
        if (useExtensions) {
          _log.d('Using extension providers for download');
          _log.d(
@@ -3236,6 +3287,96 @@ class DownloadQueueNotifier extends Notifier<DownloadQueueState> {
                await File(tempPath).delete();
              } catch (_) {}
            }
+        }
+        }
+
+        // YouTube downloads: embed metadata to raw Opus/MP3 files from Cobalt
+        if (!wasExisting &&
+            item.service == 'youtube' &&
+            filePath != null) {
+          final isOpusFile = filePath.endsWith('.opus');
+          final isMp3File = filePath.endsWith('.mp3');
+
+          if (isOpusFile || isMp3File) {
+            _log.i('YouTube download: embedding metadata to ${isOpusFile ? 'Opus' : 'MP3'} file');
+            updateItemStatus(
+              item.id,
+              DownloadStatus.downloading,
+              progress: 0.95,
+            );
+
+            final isContentUriPath = isContentUri(filePath);
+            if (isContentUriPath && effectiveSafMode) {
+              // SAF mode: copy to temp, embed, write back
+              final tempPath = await _copySafToTemp(filePath);
+              if (tempPath != null) {
+                try {
+                  if (isMp3File) {
+                    await _embedMetadataToMp3(
+                      tempPath,
+                      trackToDownload,
+                      genre: genre,
+                      label: label,
+                    );
+                  } else {
+                    await _embedMetadataToOpus(
+                      tempPath,
+                      trackToDownload,
+                      genre: genre,
+                      label: label,
+                    );
+                  }
+                  // Write back to SAF
+                  final ext = isMp3File ? '.mp3' : '.opus';
+                  final newFileName = '${safBaseName ?? 'track'}$ext';
+                  final newUri = await _writeTempToSaf(
+                    treeUri: settings.downloadTreeUri,
+                    relativeDir: effectiveOutputDir,
+                    fileName: newFileName,
+                    mimeType: _mimeTypeForExt(ext),
+                    srcPath: tempPath,
+                  );
+                  if (newUri != null) {
+                    if (newUri != filePath) {
+                      await _deleteSafFile(filePath);
+                    }
+                    filePath = newUri;
+                    finalSafFileName = newFileName;
+                    _log.d('YouTube SAF metadata embedding completed');
+                  } else {
+                    _log.w('Failed to write metadata-updated file back to SAF');
+                  }
+                } catch (e) {
+                  _log.w('YouTube SAF metadata embedding failed: $e');
+                } finally {
+                  try {
+                    await File(tempPath).delete();
+                  } catch (_) {}
+                }
+              }
+            } else {
+              // Non-SAF mode: embed directly
+              try {
+                if (isMp3File) {
+                  await _embedMetadataToMp3(
+                    filePath,
+                    trackToDownload,
+                    genre: genre,
+                    label: label,
+                  );
+                } else {
+                  await _embedMetadataToOpus(
+                    filePath,
+                    trackToDownload,
+                    genre: genre,
+                    label: label,
+                  );
+                }
+                _log.d('YouTube metadata embedding completed');
+              } catch (e) {
+                _log.w('YouTube metadata embedding failed: $e');
+              }
+            }
          }
        }

@@ -2942,9 +2942,17 @@ class _QueueTabState extends ConsumerState<QueueTab> {
                          ),
                          const SizedBox(width: 8),
                          Text(
-                            item.speedMBps > 0
-                                ? '${(item.progress * 100).toStringAsFixed(0)}% • ${item.speedMBps.toStringAsFixed(1)} MB/s'
-                                : '${(item.progress * 100).toStringAsFixed(0)}%',
+                            // When progress is 0 (unknown size, e.g. YouTube tunnel mode),
+                            // show bytes downloaded instead of percentage
+                            item.progress > 0
+                                ? (item.speedMBps > 0
+                                    ? '${(item.progress * 100).toStringAsFixed(0)}% • ${item.speedMBps.toStringAsFixed(1)} MB/s'
+                                    : '${(item.progress * 100).toStringAsFixed(0)}%')
+                                : (item.bytesReceived > 0
+                                    ? '${(item.bytesReceived / (1024 * 1024)).toStringAsFixed(1)} MB • ${item.speedMBps.toStringAsFixed(1)} MB/s'
+                                    : (item.speedMBps > 0
+                                        ? 'Downloading • ${item.speedMBps.toStringAsFixed(1)} MB/s'
+                                        : 'Starting...')),
                            style: Theme.of(context).textTheme.labelSmall
                                ?.copyWith(
                                  color: colorScheme.primary,
@@ -10,6 +10,7 @@ import 'package:spotiflac_android/providers/settings_provider.dart';
 import 'package:spotiflac_android/providers/extension_provider.dart';
 import 'package:spotiflac_android/services/platform_bridge.dart';
 import 'package:spotiflac_android/utils/app_bar_layout.dart';
+import 'package:spotiflac_android/utils/file_access.dart';
 import 'package:spotiflac_android/widgets/settings_group.dart';

 class DownloadSettingsPage extends ConsumerStatefulWidget {
@@ -917,17 +918,14 @@ class _DownloadSettingsPageState extends ConsumerState<DownloadSettingsPage> {
                // Note: iOS requires folder to have at least one file to be selectable
                final result = await FilePicker.platform.getDirectoryPath();
                if (result != null) {
-                  // iOS: Check if user selected iCloud Drive (not accessible by Go backend)
+                  // iOS: Validate the selected path is writable (not iCloud or container root)
                  if (Platform.isIOS) {
-                    final isICloudPath =
-                        result.contains('Mobile Documents') ||
-                        result.contains('CloudDocs') ||
-                        result.contains('com~apple~CloudDocs');
-                    if (isICloudPath) {
+                    final validation = validateIosPath(result);
+                    if (!validation.isValid) {
                      if (ctx.mounted) {
                        ScaffoldMessenger.of(ctx).showSnackBar(
                          SnackBar(
-                            content: Text(context.l10n.setupIcloudNotSupported),
+                            content: Text(validation.errorReason ?? context.l10n.setupIcloudNotSupported),
                            backgroundColor: Theme.of(ctx).colorScheme.error,
                            duration: const Duration(seconds: 4),
                          ),
@@ -9,6 +9,7 @@ import 'package:device_info_plus/device_info_plus.dart';
 import 'package:spotiflac_android/providers/settings_provider.dart';
 import 'package:spotiflac_android/l10n/l10n.dart';
 import 'package:spotiflac_android/services/platform_bridge.dart';
+import 'package:spotiflac_android/utils/file_access.dart';

 class SetupScreen extends ConsumerStatefulWidget {
  const SetupScreen({super.key});
@@ -322,6 +323,22 @@ class _SetupScreenState extends ConsumerState<SetupScreen> {
                Navigator.pop(ctx);
                final result = await FilePicker.platform.getDirectoryPath();
                if (result != null) {
+                  // iOS: Validate the selected path is writable
+                  if (Platform.isIOS) {
+                    final validation = validateIosPath(result);
+                    if (!validation.isValid) {
+                      if (mounted) {
+                        ScaffoldMessenger.of(context).showSnackBar(
+                          SnackBar(
+                            content: Text(validation.errorReason ?? 'Invalid folder selected'),
+                            backgroundColor: Theme.of(context).colorScheme.error,
+                            duration: const Duration(seconds: 4),
+                          ),
+                        );
+                      }
+                      return;
+                    }
+                  }
                  setState(() => _selectedDirectory = result);
                }
              },
@@ -1113,8 +1113,71 @@ static Future<Map<String, dynamic>> downloadWithExtensions({
    return result as String;
  }

-  static Future<void> clearStoreCache() async {
-    _log.d('clearStoreCache');
-    await _channel.invokeMethod('clearStoreCache');
-  }
-}
+  static Future<void> clearStoreCache() async {
+    _log.d('clearStoreCache');
+    await _channel.invokeMethod('clearStoreCache');
+  }
+
+  // ==================== YOUTUBE / COBALT ====================
+
+  /// Download a track from YouTube using the Cobalt API.
+  /// YouTube is a lossy-only provider (Opus 256kbps or MP3 320kbps).
+  /// It does NOT participate in the lossless fallback chain.
+  static Future<Map<String, dynamic>> downloadFromYouTube({
+    required String trackName,
+    required String artistName,
+    required String albumName,
+    String? albumArtist,
+    String? coverUrl,
+    required String outputDir,
+    required String filenameFormat,
+    String quality = 'opus_256',
+    int trackNumber = 1,
+    int discNumber = 1,
+    String? releaseDate,
+    String? itemId,
+    int durationMs = 0,
+    String? isrc,
+    String? spotifyId,
+    String? deezerId,
+    String storageMode = 'app',
+    String safTreeUri = '',
+    String safRelativeDir = '',
+    String safFileName = '',
+    String safOutputExt = '',
+  }) async {
+    _log.i('downloadFromYouTube: "$trackName" by $artistName (quality: $quality)');
+    final request = jsonEncode({
+      'track_name': trackName,
+      'artist_name': artistName,
+      'album_name': albumName,
+      'album_artist': albumArtist ?? artistName,
+      'cover_url': coverUrl,
+      'output_dir': outputDir,
+      'filename_format': filenameFormat,
+      'quality': quality,
+      'track_number': trackNumber,
+      'disc_number': discNumber,
+      'release_date': releaseDate ?? '',
+      'item_id': itemId ?? '',
+      'duration_ms': durationMs,
+      'isrc': isrc ?? '',
+      'spotify_id': spotifyId ?? '',
+      'deezer_id': deezerId ?? '',
+      'storage_mode': storageMode,
+      'saf_tree_uri': safTreeUri,
+      'saf_relative_dir': safRelativeDir,
+      'saf_file_name': safFileName,
+      'saf_output_ext': safOutputExt,
+    });
+
+    final result = await _channel.invokeMethod('downloadFromYouTube', request);
+    final response = jsonDecode(result as String) as Map<String, dynamic>;
+    if (response['success'] == true) {
+      _log.i('YouTube download success: ${response['file_path']}');
+    } else {
+      _log.w('YouTube download failed: ${response['error']}');
+    }
+    return response;
+  }
+}
@@ -1,9 +1,138 @@
 import 'dart:io';

 import 'package:open_filex/open_filex.dart';
+import 'package:path_provider/path_provider.dart';
 import 'package:spotiflac_android/services/platform_bridge.dart';
 import 'package:spotiflac_android/utils/mime_utils.dart';

+/// Regular expression to detect iOS app container paths.
+/// Matches paths like /var/mobile/Containers/Data/Application/{UUID}
+/// or /private/var/mobile/Containers/Data/Application/{UUID}
+final _iosContainerRootPattern = RegExp(
+  r'^(/private)?/var/mobile/Containers/Data/Application/[A-F0-9\-]+/?$',
+  caseSensitive: false,
+);
+
+/// Checks if a path is a valid writable directory on iOS.
+/// Returns false if:
+/// - The path is the app container root (not writable)
+/// - The path is an iCloud Drive path (not accessible by Go backend)
+/// - The path is outside the app sandbox
+bool isValidIosWritablePath(String path) {
+  if (!Platform.isIOS) return true;
+  if (path.isEmpty) return false;
+
+  // Check if it's the container root (without Documents/, tmp/, etc.)
+  if (_iosContainerRootPattern.hasMatch(path)) {
+    return false;
+  }
+
+  // Check for iCloud Drive paths
+  if (path.contains('Mobile Documents') ||
+      path.contains('CloudDocs') ||
+      path.contains('com~apple~CloudDocs')) {
+    return false;
+  }
+
+  // Ensure path contains a valid subdirectory (Documents, tmp, Library, etc.)
+  // This handles cases where FilePicker returns container root
+  final containerPattern = RegExp(
+    r'/var/mobile/Containers/Data/Application/[A-F0-9\-]+',
+    caseSensitive: false,
+  );
+  final match = containerPattern.firstMatch(path);
+  if (match != null) {
+    final remainingPath = path.substring(match.end);
+    // Valid paths should have something after the UUID
+    if (remainingPath.isEmpty || remainingPath == '/') {
+      return false;
+    }
+  }
+
+  return true;
+}
+
+/// Validates and potentially corrects an iOS path.
+/// Returns a valid Documents subdirectory path if the input is invalid.
+Future<String> validateOrFixIosPath(String path, {String subfolder = 'SpotiFLAC'}) async {
+  if (!Platform.isIOS) return path;
+
+  if (isValidIosWritablePath(path)) {
+    return path;
+  }
+
+  // Fall back to app Documents directory
+  final dir = await getApplicationDocumentsDirectory();
+  final musicDir = Directory('${dir.path}/$subfolder');
+  if (!await musicDir.exists()) {
+    await musicDir.create(recursive: true);
+  }
+  return musicDir.path;
+}
+
+/// Detailed result for iOS path validation
+class IosPathValidationResult {
+  final bool isValid;
+  final String? correctedPath;
+  final String? errorReason;
+
+  const IosPathValidationResult({
+    required this.isValid,
+    this.correctedPath,
+    this.errorReason,
+  });
+}
+
+/// Validates an iOS path and returns detailed information about the result.
+IosPathValidationResult validateIosPath(String path) {
+  if (!Platform.isIOS) {
+    return const IosPathValidationResult(isValid: true);
+  }
+
+  if (path.isEmpty) {
+    return const IosPathValidationResult(
+      isValid: false,
+      errorReason: 'Path is empty',
+    );
+  }
+
+  // Check if it's the container root
+  if (_iosContainerRootPattern.hasMatch(path)) {
+    return const IosPathValidationResult(
+      isValid: false,
+      errorReason: 'Cannot write to app container root. Please choose a subfolder like Documents.',
+    );
+  }
+
+  // Check for iCloud Drive paths
+  if (path.contains('Mobile Documents') ||
+      path.contains('CloudDocs') ||
+      path.contains('com~apple~CloudDocs')) {
+    return const IosPathValidationResult(
+      isValid: false,
+      errorReason: 'iCloud Drive is not supported. Please choose a local folder.',
+    );
+  }
+
+  // Check for container root without subdirectory
+  final containerPattern = RegExp(
+    r'/var/mobile/Containers/Data/Application/[A-F0-9\-]+',
+    caseSensitive: false,
+  );
+  final match = containerPattern.firstMatch(path);
+  if (match != null) {
+    final remainingPath = path.substring(match.end);
+    if (remainingPath.isEmpty || remainingPath == '/') {
+      return const IosPathValidationResult(
+        isValid: false,
+        errorReason: 'Cannot write to app container root. Please use the default folder or choose a different location.',
+      );
+    }
+  }
+
+  return const IosPathValidationResult(isValid: true);
+}
+
 class FileAccessStat {
  final int? size;
  final DateTime? modified;
@@ -22,7 +22,9 @@ class BuiltInService {
  });
 }

-/// Default quality options for built-in services (Tidal, Qobuz, Amazon)
+/// Default quality options for built-in services (Tidal, Qobuz, YouTube)
+/// Note: Amazon is fallback-only and not shown in picker
+/// Note: Tidal lossy (HIGH) removed - use YouTube for lossy downloads
 const _builtInServices = [
  BuiltInService(
    id: 'tidal',
@@ -31,7 +33,6 @@ const _builtInServices = [
      QualityOption(id: 'LOSSLESS', label: 'FLAC Lossless', description: '16-bit / 44.1kHz'),
      QualityOption(id: 'HI_RES', label: 'Hi-Res FLAC', description: '24-bit / up to 96kHz'),
      QualityOption(id: 'HI_RES_LOSSLESS', label: 'Hi-Res FLAC Max', description: '24-bit / up to 192kHz'),
-      QualityOption(id: 'HIGH', label: 'Lossy 320kbps', description: 'MP3 or Opus (smaller files)'),
    ],
  ),
  BuiltInService(
@@ -44,15 +45,14 @@ const _builtInServices = [
    ],
  ),
  BuiltInService(
-    id: 'amazon',
-    label: 'Amazon',
+    id: 'youtube',
+    label: 'YouTube',
    qualityOptions: [
-      QualityOption(id: 'LOSSLESS', label: 'FLAC Lossless', description: '16-bit / 44.1kHz'),
-      QualityOption(id: 'HI_RES', label: 'Hi-Res FLAC', description: '24-bit / up to 96kHz'),
-      QualityOption(id: 'HI_RES_LOSSLESS', label: 'Hi-Res FLAC Max', description: '24-bit / up to 192kHz'),
+      QualityOption(id: 'opus_256', label: 'Opus 256kbps', description: 'Best quality lossy (~8MB per track)'),
+      QualityOption(id: 'mp3_320', label: 'MP3 320kbps', description: 'Best compatibility (~10MB per track)'),
    ],
-    isDisabled: true,
-    disabledReason: 'Fallback only',
+    isDisabled: false,
+    disabledReason: null,
  ),
 ];

@@ -211,7 +211,7 @@ Padding(
              ),
            ),

-            if (_builtInServices.any((s) => s.id == _selectedService))
+            if (_builtInServices.any((s) => s.id == _selectedService && s.id != 'youtube'))
              Padding(
                padding: const EdgeInsets.fromLTRB(24, 0, 24, 12),
                child: Text(
@@ -223,19 +223,26 @@ Padding(
                ),
              ),

+            if (_selectedService == 'youtube')
+              Padding(
+                padding: const EdgeInsets.fromLTRB(24, 0, 24, 12),
+                child: Text(
+                  context.l10n.youtubeQualityNote,
+                  style: Theme.of(context).textTheme.bodySmall?.copyWith(
+                    color: colorScheme.onSurfaceVariant,
+                    fontStyle: FontStyle.italic,
+                  ),
+                ),
+              ),
+
            for (final quality in qualityOptions)
              _QualityOption(
                title: quality.label,
                subtitle: quality.description ?? '',
                icon: _getQualityIcon(quality.id),
                onTap: () {
-                  // For Tidal HIGH quality, show format picker first
-                  if (_selectedService == 'tidal' && quality.id == 'HIGH') {
-                    _showLossyFormatPicker(context);
-                  } else {
-                    Navigator.pop(context);
-                    widget.onSelect(quality.id, _selectedService);
-                  }
+                  Navigator.pop(context);
+                  widget.onSelect(quality.id, _selectedService);
                },
              ),

@@ -254,136 +261,17 @@ Padding(
        return Icons.high_quality;
      case 'LOSSLESS':
        return Icons.music_note;
-      case 'HIGH':
-        return Icons.aod;
      case 'MP3_320':
      case 'MP3':
        return Icons.audiotrack;
      case 'OPUS':
      case 'OPUS_128':
+      case 'OPUS_256':
        return Icons.graphic_eq;
      default:
        return Icons.music_note;
    }
  }
-
-  void _showLossyFormatPicker(BuildContext context) {
-    final colorScheme = Theme.of(context).colorScheme;
-    final settings = ref.read(settingsProvider);
-    final currentFormat = settings.tidalHighFormat;
-
-    showModalBottomSheet(
-      context: context,
-      backgroundColor: colorScheme.surfaceContainerHigh,
-      shape: const RoundedRectangleBorder(
-        borderRadius: BorderRadius.vertical(top: Radius.circular(28)),
-      ),
-      builder: (modalContext) => SafeArea(
-        child: Column(
-          mainAxisSize: MainAxisSize.min,
-          crossAxisAlignment: CrossAxisAlignment.start,
-          children: [
-            const SizedBox(height: 8),
-            Center(
-              child: Container(
-                width: 40,
-                height: 4,
-                decoration: BoxDecoration(
-                  color: colorScheme.onSurfaceVariant.withValues(alpha: 0.4),
-                  borderRadius: BorderRadius.circular(2),
-                ),
-              ),
-            ),
-            Padding(
-              padding: const EdgeInsets.fromLTRB(24, 16, 24, 8),
-              child: Text(
-                'Select Lossy Format',
-                style: Theme.of(context).textTheme.titleLarge?.copyWith(
-                  fontWeight: FontWeight.bold,
-                ),
-              ),
-            ),
-            Padding(
-              padding: const EdgeInsets.fromLTRB(24, 0, 24, 16),
-              child: Text(
-                'Choose output format for 320kbps lossy download',
-                style: Theme.of(context).textTheme.bodyMedium?.copyWith(
-                  color: colorScheme.onSurfaceVariant,
-                ),
-              ),
-            ),
-            ListTile(
-              contentPadding: const EdgeInsets.symmetric(horizontal: 24),
-              leading: Container(
-                padding: const EdgeInsets.all(10),
-                decoration: BoxDecoration(
-                  color: colorScheme.primaryContainer,
-                  borderRadius: BorderRadius.circular(12),
-                ),
-                child: Icon(Icons.audiotrack, color: colorScheme.onPrimaryContainer, size: 20),
-              ),
-              title: const Text('MP3 320kbps'),
-              subtitle: const Text('Best compatibility, ~10MB per track'),
-              trailing: currentFormat == 'mp3_320'
-                  ? Icon(Icons.check_circle, color: colorScheme.primary)
-                  : null,
-              onTap: () {
-                ref.read(settingsProvider.notifier).setTidalHighFormat('mp3_320');
-                Navigator.pop(modalContext); // Close format picker
-                Navigator.pop(context); // Close service picker
-                widget.onSelect('HIGH', _selectedService);
-              },
-            ),
-            ListTile(
-              contentPadding: const EdgeInsets.symmetric(horizontal: 24),
-              leading: Container(
-                padding: const EdgeInsets.all(10),
-                decoration: BoxDecoration(
-                  color: colorScheme.primaryContainer,
-                  borderRadius: BorderRadius.circular(12),
-                ),
-                child: Icon(Icons.graphic_eq, color: colorScheme.onPrimaryContainer, size: 20),
-              ),
-              title: const Text('Opus 256kbps'),
-              subtitle: const Text('Best quality Opus, ~8MB per track'),
-              trailing: currentFormat == 'opus_256'
-                  ? Icon(Icons.check_circle, color: colorScheme.primary)
-                  : null,
-              onTap: () {
-                ref.read(settingsProvider.notifier).setTidalHighFormat('opus_256');
-                Navigator.pop(modalContext); // Close format picker
-                Navigator.pop(context); // Close service picker
-                widget.onSelect('HIGH', _selectedService);
-              },
-            ),
-            ListTile(
-              contentPadding: const EdgeInsets.symmetric(horizontal: 24),
-              leading: Container(
-                padding: const EdgeInsets.all(10),
-                decoration: BoxDecoration(
-                  color: colorScheme.primaryContainer,
-                  borderRadius: BorderRadius.circular(12),
-                ),
-                child: Icon(Icons.graphic_eq, color: colorScheme.onPrimaryContainer, size: 20),
-              ),
-              title: const Text('Opus 128kbps'),
-              subtitle: const Text('Smallest size, ~4MB per track'),
-              trailing: currentFormat == 'opus_128'
-                  ? Icon(Icons.check_circle, color: colorScheme.primary)
-                  : null,
-              onTap: () {
-                ref.read(settingsProvider.notifier).setTidalHighFormat('opus_128');
-                Navigator.pop(modalContext); // Close format picker
-                Navigator.pop(context); // Close service picker
-                widget.onSelect('HIGH', _selectedService);
-              },
-            ),
-            const SizedBox(height: 16),
-          ],
-        ),
-      ),
-    );
-  }
 }