Skip to content

StreamVault is a TV-first free IPTV player for Android TV built with Kotlin, Jetpack Compose, Room, Hilt, and Media3.

Route backup export/import through a folder picker on Fire TV

afeddf5dd740d
diff --git a/app/src/main/java/com/streamvault/app/ui/screens/settings/SettingsScreen.kt b/app/src/main/java/com/streamvault/app/ui/screens/settings/SettingsScreen.kt
index 4a091390..14541b29 100644
--- a/app/src/main/java/com/streamvault/app/ui/screens/settings/SettingsScreen.kt
+++ b/app/src/main/java/com/streamvault/app/ui/screens/settings/SettingsScreen.kt
@@ -1,8 +1,12 @@
package com.streamvault.app.ui.screens.settings
+import android.content.ActivityNotFoundException
+import android.content.Context
import androidx.compose.foundation.background
import androidx.compose.foundation.layout.*
import androidx.compose.foundation.lazy.LazyColumn
+import androidx.compose.foundation.rememberScrollState
+import androidx.compose.foundation.verticalScroll
import androidx.lifecycle.compose.collectAsStateWithLifecycle
import androidx.compose.runtime.*
import androidx.compose.ui.Alignment
@@ -13,8 +17,10 @@ import androidx.compose.ui.platform.LocalUriHandler
import androidx.compose.ui.unit.dp
import androidx.hilt.lifecycle.viewmodel.compose.hiltViewModel
import androidx.tv.material3.*
+import androidx.compose.material3.AlertDialog
import androidx.compose.material3.SnackbarHost
import androidx.compose.material3.SnackbarHostState
+import androidx.compose.material3.TextButton
import androidx.compose.ui.graphics.Color
import androidx.activity.compose.rememberLauncherForActivityResult
import androidx.activity.result.contract.ActivityResultContracts
@@ -31,6 +37,20 @@ import androidx.compose.ui.res.stringResource
import com.streamvault.app.R
import com.streamvault.app.ui.design.requestFocusSafely
import kotlinx.coroutines.delay
+import java.time.LocalDateTime
+import java.time.format.DateTimeFormatter
+
+private val backupFileNameFormatter = DateTimeFormatter.ofPattern("yyyyMMdd_HHmmss")
+
+private fun buildBackupFileName(): String =
+ "streamvault_backup_${LocalDateTime.now().format(backupFileNameFormatter)}.json"
+
+// Fire OS strips the AOSP DocumentsUI, so ACTION_CREATE_DOCUMENT and
+// ACTION_OPEN_DOCUMENT have no handler and throw ActivityNotFoundException.
+// ACTION_OPEN_DOCUMENT_TREE is handled by Amazon's storage UI, so on Fire TV
+// we route backup export/import through a folder picker instead.
+private fun Context.isFireTv(): Boolean =
+ packageManager.hasSystemFeature("amazon.hardware.fire_tv")
@Composable
@@ -72,6 +92,59 @@ fun SettingsScreen(
uri?.let { viewModel.inspectBackup(it.toString()) }
}
+ var pendingImportCandidates by remember { mutableStateOf<List<Pair<String, String>>>(emptyList()) }
+
+ val exportTreeLauncher = rememberLauncherForActivityResult(
+ contract = ActivityResultContracts.OpenDocumentTree()
+ ) { treeUri ->
+ treeUri ?: return@rememberLauncherForActivityResult
+ runCatching {
+ context.contentResolver.takePersistableUriPermission(
+ treeUri,
+ android.content.Intent.FLAG_GRANT_READ_URI_PERMISSION or
+ android.content.Intent.FLAG_GRANT_WRITE_URI_PERMISSION
+ )
+ }
+ val folder = DocumentFile.fromTreeUri(context, treeUri)
+ if (folder == null || !folder.canWrite()) {
+ viewModel.showUserMessage(context.getString(R.string.settings_backup_folder_create_failed))
+ return@rememberLauncherForActivityResult
+ }
+ val newFile = folder.createFile(BackupFileBridge.MIME_TYPE_JSON, buildBackupFileName())
+ if (newFile == null) {
+ viewModel.showUserMessage(context.getString(R.string.settings_backup_folder_create_failed))
+ return@rememberLauncherForActivityResult
+ }
+ viewModel.exportConfig(newFile.uri.toString())
+ }
+
+ val importTreeLauncher = rememberLauncherForActivityResult(
+ contract = ActivityResultContracts.OpenDocumentTree()
+ ) { treeUri ->
+ treeUri ?: return@rememberLauncherForActivityResult
+ runCatching {
+ context.contentResolver.takePersistableUriPermission(
+ treeUri,
+ android.content.Intent.FLAG_GRANT_READ_URI_PERMISSION
+ )
+ }
+ val folder = DocumentFile.fromTreeUri(context, treeUri)
+ if (folder == null) {
+ viewModel.showUserMessage(context.getString(R.string.settings_backup_folder_read_failed))
+ return@rememberLauncherForActivityResult
+ }
+ val candidates = folder.listFiles()
+ .filter { it.isFile && it.name?.endsWith(".json", ignoreCase = true) == true }
+ .sortedByDescending { it.lastModified() }
+ .map { (it.name ?: "backup.json") to it.uri.toString() }
+ when {
+ candidates.isEmpty() ->
+ viewModel.showUserMessage(context.getString(R.string.settings_backup_no_files_in_folder))
+ candidates.size == 1 -> viewModel.inspectBackup(candidates.first().second)
+ else -> pendingImportCandidates = candidates
+ }
+ }
+
fun shareBackup() {
val file = runCatching { BackupFileBridge.createExportFile(context) }.getOrNull()
if (file == null) {
@@ -190,16 +263,74 @@ fun SettingsScreen(
onAddProvider = onAddProvider,
onEditProvider = onEditProvider,
onNavigateToParentalControl = onNavigateToParentalControl,
- onChooseRecordingFolder = { recordingFolderLauncher.launch(null) },
- onCreateBackup = { createDocumentLauncher.launch("streamvault_backup.json") },
+ onChooseRecordingFolder = {
+ try {
+ recordingFolderLauncher.launch(null)
+ } catch (e: ActivityNotFoundException) {
+ viewModel.showUserMessage(
+ context.getString(R.string.settings_backup_folder_picker_unavailable)
+ )
+ }
+ },
+ onCreateBackup = {
+ val onFireTv = context.isFireTv()
+ val primary: () -> Unit = if (onFireTv) {
+ { exportTreeLauncher.launch(null) }
+ } else {
+ { createDocumentLauncher.launch("streamvault_backup.json") }
+ }
+ val fallback: () -> Unit = if (onFireTv) {
+ { createDocumentLauncher.launch("streamvault_backup.json") }
+ } else {
+ { exportTreeLauncher.launch(null) }
+ }
+ try {
+ primary()
+ } catch (e: ActivityNotFoundException) {
+ try {
+ fallback()
+ } catch (e2: ActivityNotFoundException) {
+ viewModel.showUserMessage(
+ context.getString(R.string.settings_backup_folder_picker_unavailable)
+ )
+ }
+ }
+ },
onShareBackup = ::shareBackup,
onViewCrashReport = viewModel::viewCrashReport,
onShareCrashReport = ::shareCrashReport,
onDeleteCrashReport = viewModel::deleteCrashReport,
onRestoreBackup = {
- openDocumentLauncher.launch(
- arrayOf("application/json", "text/json", "application/x-json", "application/octet-stream", "*/*")
- )
+ val onFireTv = context.isFireTv()
+ val primary: () -> Unit = if (onFireTv) {
+ { importTreeLauncher.launch(null) }
+ } else {
+ {
+ openDocumentLauncher.launch(
+ arrayOf("application/json", "text/json", "application/x-json", "application/octet-stream", "*/*")
+ )
+ }
+ }
+ val fallback: () -> Unit = if (onFireTv) {
+ {
+ openDocumentLauncher.launch(
+ arrayOf("application/json", "text/json", "application/x-json", "application/octet-stream", "*/*")
+ )
+ }
+ } else {
+ { importTreeLauncher.launch(null) }
+ }
+ try {
+ primary()
+ } catch (e: ActivityNotFoundException) {
+ try {
+ fallback()
+ } catch (e2: ActivityNotFoundException) {
+ viewModel.showUserMessage(
+ context.getString(R.string.settings_backup_folder_picker_unavailable)
+ )
+ }
+ }
},
onDriveSignIn = { viewModel.beginDriveSignIn(driveSignInLauncher) },
onDriveSignOut = viewModel::signOutDrive,
@@ -222,6 +353,43 @@ fun SettingsScreen(
currentRoute = currentRoute,
modifier = Modifier
)
+
+ if (pendingImportCandidates.isNotEmpty()) {
+ AlertDialog(
+ onDismissRequest = { pendingImportCandidates = emptyList() },
+ title = {
+ androidx.compose.material3.Text(
+ text = stringResource(R.string.settings_backup_choose_file_title)
+ )
+ },
+ text = {
+ Column(modifier = Modifier.verticalScroll(rememberScrollState())) {
+ pendingImportCandidates.forEach { (name, uri) ->
+ TextButton(
+ onClick = {
+ pendingImportCandidates = emptyList()
+ viewModel.inspectBackup(uri)
+ },
+ modifier = Modifier.fillMaxWidth()
+ ) {
+ androidx.compose.material3.Text(text = name, color = OnSurface)
+ }
+ }
+ }
+ },
+ confirmButton = {
+ TextButton(onClick = { pendingImportCandidates = emptyList() }) {
+ androidx.compose.material3.Text(
+ text = stringResource(R.string.settings_cancel),
+ color = OnSurface
+ )
+ }
+ },
+ containerColor = SurfaceElevated,
+ titleContentColor = OnSurface,
+ textContentColor = TextSecondary
+ )
+ }
}
}
diff --git a/app/src/main/res/values/strings.xml b/app/src/main/res/values/strings.xml
index c2ae428c..845737f7 100644
--- a/app/src/main/res/values/strings.xml
+++ b/app/src/main/res/values/strings.xml
@@ -658,6 +658,11 @@
<string name="settings_backup_share_subtitle">Send a backup file to a TV file manager or another app.</string>
<string name="settings_backup_share_prepare_failed">Could not prepare the backup file.</string>
<string name="settings_backup_share_failed">No app could receive the backup file.</string>
+ <string name="settings_backup_choose_file_title">Choose a backup file</string>
+ <string name="settings_backup_no_files_in_folder">No backup files (.json) found in that folder.</string>
+ <string name="settings_backup_folder_picker_unavailable">No folder picker is available on this device.</string>
+ <string name="settings_backup_folder_create_failed">Could not create the backup file in that folder.</string>
+ <string name="settings_backup_folder_read_failed">Could not read that folder.</string>
<string name="settings_crash_reports_title">Crash Reports</string>
<string name="settings_crash_reports_subtitle">Fatal crashes are saved locally only when the app is already crashing. You can review or share the latest report.</string>
<string name="settings_crash_report_latest">Latest crash</string>