Good Old Games (GOG) Support

app/build.gradle.kts

@@ -10,6 +10,7 @@ plugins {
     alias(libs.plugins.kotlinter)
     alias(libs.plugins.ksp)
     alias(libs.plugins.secrets.gradle)
+    id("com.chaquo.python") version "16.0.0"
 }
 
 val keystorePropertiesFile = rootProject.file("app/keystores/keystore.properties")
@@ -159,8 +160,6 @@ android {
             excludes += "/DebugProbesKt.bin"
             excludes += "/junit/runner/smalllogo.gif"
             excludes += "/junit/runner/logo.gif"
-
-            // Other excludes
             excludes += "/META-INF/versions/9/OSGI-INF/MANIFEST.MF"
         }
         jniLibs {
@@ -204,8 +203,27 @@ android {
     // }
 }
 
+chaquopy {
+    defaultConfig {
+        version = "3.11"  // Last Python version supporting armeabi-v7a (32-bit ARM)
+        pip {
+            // Install GOGDL dependencies
+            install("requests")
+        }
+    }
+    sourceSets {
+        getByName("main") {
+            srcDir("src/main/python")
+        }
+    }
+}
+
 dependencies {
     implementation(libs.material)
+
+    // Chrome Custom Tabs for GOG OAuth
+    implementation("androidx.browser:browser:1.8.0")
+
     // JavaSteam
     val localBuild = false // Change to 'true' needed when building JavaSteam manually
     if (localBuild) {

app/src/main/AndroidManifest.xml

@@ -55,12 +55,12 @@
                 <action android:name="app.gamenative.LAUNCH_GAME" />
                 <category android:name="android.intent.category.DEFAULT" />
             </intent-filter>
-            
+
             <!--Allows app window to be resized on Oculus Quest VR headsets-->
             <meta-data
                 android:name="com.oculus.vrshell.supports_free_resizing"
                 android:value="true" />
-            
+
         </activity>
         <!-- Launcher icon aliases to allow switching app icon at runtime -->
         <activity-alias
@@ -92,7 +92,13 @@
             android:enabled="true"
             android:exported="false"
             android:foregroundServiceType="dataSync" />
-
+
+        <service
+            android:name=".service.gog.GOGService"
+            android:enabled="true"
+            android:exported="false"
+            android:foregroundServiceType="dataSync" />
+
         <!-- FileProvider for secure file sharing (for APK installation) -->
         <provider
             android:name="androidx.core.content.FileProvider"

app/src/main/java/app/gamenative/MainActivity.kt

@@ -33,6 +33,7 @@ import coil.memory.MemoryCache
 import coil.request.CachePolicy
 import app.gamenative.events.AndroidEvent
 import app.gamenative.service.SteamService
+import app.gamenative.service.gog.GOGService
 import app.gamenative.ui.PluviaMain
 import app.gamenative.ui.enums.Orientation
 import app.gamenative.utils.AnimatedPngDecoder
@@ -250,6 +251,11 @@ class MainActivity : ComponentActivity() {
             Timber.i("Stopping Steam Service")
             SteamService.stop()
         }
+
+        if(GOGService.isRunning) {
+            Timber.i("Stopping GOG Service")
+            GOGService.stop()
+        }
     }
 
     override fun onResume() {
@@ -262,6 +268,13 @@ class MainActivity : ComponentActivity() {
             PluviaApp.xEnvironment?.onResume()
             Timber.d("Game resumed")
         }
+
+        // Restart GOG service if it went down
+        if (GOGService.hasStoredCredentials(this) && !GOGService.isRunning) {
+            Timber.i("GOG service was down on resume - restarting")
+            GOGService.start(this)
+        }
+
         PostHog.capture(event = "app_foregrounded")
     }
 

app/src/main/java/app/gamenative/PluviaApp.kt

@@ -64,6 +64,9 @@ class PluviaApp : SplitCompatApplication() {
         // Init our datastore preferences.
         PrefManager.init(this)
 
+        // Initialize GOGConstants
+        app.gamenative.service.gog.GOGConstants.init(this)
+
         DownloadService.populateDownloadService(this)
 
         appScope.launch {
@@ -100,6 +103,19 @@ class PluviaApp : SplitCompatApplication() {
             Timber.e(e, "Failed to initialize Supabase client: ${e.message}")
             e.printStackTrace()
         }
+
+        // Initialize GOG service
+        appScope.launch {
+            try {
+                if (app.gamenative.service.gog.GOGService.initialize(applicationContext)) {
+                    Timber.d("GOGService initialized successfully")
+                } else {
+                    Timber.w("GOGService initialization returned false")
+                }
+            } catch (e: Exception) {
+                Timber.e(e, "Failed to initialize GOGService: ${e.message}")
+            }
+        }
     }
 
     companion object {

app/src/main/java/app/gamenative/PrefManager.kt

@@ -705,6 +705,13 @@ object PrefManager {
             setPref(SHOW_CUSTOM_GAMES_IN_LIBRARY, value)
         }
 
+    private val SHOW_GOG_IN_LIBRARY = booleanPreferencesKey("show_gog_in_library")
+    var showGOGInLibrary: Boolean
+        get() = getPref(SHOW_GOG_IN_LIBRARY, true)
+        set(value) {
+            setPref(SHOW_GOG_IN_LIBRARY, value)
+        }
+
     // Game counts for skeleton loaders
     private val CUSTOM_GAMES_COUNT = intPreferencesKey("custom_games_count")
     var customGamesCount: Int
@@ -720,6 +727,20 @@ object PrefManager {
             setPref(STEAM_GAMES_COUNT, value)
         }
 
+    private val GOG_GAMES_COUNT = intPreferencesKey("gog_games_count")
+    var gogGamesCount: Int
+        get() = getPref(GOG_GAMES_COUNT, 0)
+        set(value) {
+            setPref(GOG_GAMES_COUNT, value)
+        }
+
+    private val GOG_INSTALLED_GAMES_COUNT = intPreferencesKey("gog_installed_games_count")
+    var gogInstalledGamesCount: Int
+        get() = getPref(GOG_INSTALLED_GAMES_COUNT, 0)
+        set(value) {
+            setPref(GOG_INSTALLED_GAMES_COUNT, value)
+        }
+
     // Show dialog when adding custom game folder
     private val SHOW_ADD_CUSTOM_GAME_DIALOG = booleanPreferencesKey("show_add_custom_game_dialog")
     var showAddCustomGameDialog: Boolean

app/src/main/java/app/gamenative/data/GOGCloudSavesLocation.kt

@@ -0,0 +1,26 @@
+package app.gamenative.data
+
+/**
+ * Save location template from GOG API (before path resolution)
+ * @param name The name/identifier of the location (e.g., "__default", "saves", "configs")
+ * @param location The path template with GOG variables (e.g., "<?INSTALL?>/saves")
+ */
+data class GOGCloudSavesLocationTemplate(
+    val name: String,
+    val location: String
+)
+
+/**
+ * Resolved GOG cloud save location (after path resolution)
+ * @param name The name/identifier of the save location
+ * @param location The absolute path to the save directory on the device
+ * @param clientId The game's GOG client ID used for cloud storage API
+ * @param clientSecret The game's GOG client secret for authentication
+ */
+data class GOGCloudSavesLocation(
+    val name: String,
+    val location: String,
+    val clientId: String,
+    val clientSecret: String = ""  // Default empty for backward compatibility
+)
+

app/src/main/java/app/gamenative/data/GOGGame.kt

@@ -0,0 +1,89 @@
+package app.gamenative.data
+
+import androidx.room.ColumnInfo
+import androidx.room.Entity
+import androidx.room.PrimaryKey
+import app.gamenative.enums.AppType
+
+/**
+ * GOG Game entity for Room database
+ * Represents a game from the GOG platform
+ */
+@Entity(tableName = "gog_games")
+data class GOGGame(
+    @PrimaryKey
+    @ColumnInfo("id")
+    val id: String,
+
+    @ColumnInfo("title")
+    val title: String = "",
+
+    @ColumnInfo("slug")
+    val slug: String = "",
+
+    @ColumnInfo("download_size")
+    val downloadSize: Long = 0,
+
+    @ColumnInfo("install_size")
+    val installSize: Long = 0,
+
+    @ColumnInfo("is_installed")
+    val isInstalled: Boolean = false,
+
+    @ColumnInfo("install_path")
+    val installPath: String = "",
+
+    @ColumnInfo("image_url")
+    val imageUrl: String = "",
+
+    @ColumnInfo("icon_url")
+    val iconUrl: String = "",
+
+    @ColumnInfo("description")
+    val description: String = "",
+
+    @ColumnInfo("release_date")
+    val releaseDate: String = "",
+
+    @ColumnInfo("developer")
+    val developer: String = "",
+
+    @ColumnInfo("publisher")
+    val publisher: String = "",
+
+    @ColumnInfo("genres")
+    val genres: List<String> = emptyList(),
+
+    @ColumnInfo("languages")
+    val languages: List<String> = emptyList(),
+
+    @ColumnInfo("last_played")
+    val lastPlayed: Long = 0,
+
+    @ColumnInfo("play_time")
+    val playTime: Long = 0,
+
+    @ColumnInfo("type")
+    val type: AppType = AppType.game,
+) {
+    companion object {
+        const val GOG_IMAGE_BASE_URL = "https://images.gog.com/images"
+    }
+}
+
+data class GOGCredentials(
+    val accessToken: String,
+    val refreshToken: String,
+    val userId: String,
+    val username: String,
+)
+
+data class GOGDownloadInfo(
+    val gameId: String,
+    val totalSize: Long,
+    val downloadedSize: Long = 0,
+    val progress: Float = 0f,
+    val isActive: Boolean = false,
+    val isPaused: Boolean = false,
+    val error: String? = null,
+)

app/src/main/java/app/gamenative/data/LibraryItem.kt

@@ -6,6 +6,7 @@ import app.gamenative.utils.CustomGameScanner
 enum class GameSource {
     STEAM,
     CUSTOM_GAME,
+    GOG,
     // Add other platforms here..
 }
 
@@ -44,12 +45,22 @@ data class LibraryItem(
                     ""
                 }
             }
+            GameSource.GOG -> {
+                // GoG Images are typically the full URL, but have fallback just in case.
+                if (iconHash.isEmpty()) {
+                    ""
+                } else if (iconHash.startsWith("http")) {
+                    iconHash
+                } else {
+                    "${GOGGame.GOG_IMAGE_BASE_URL}/$iconHash"
+                }
+            }
         }
 
     /**
      * Helper property to get the game ID as an integer
-     * Extracts the numeric part by removing the gameSource prefix
+     * For all game sources, extract the numeric part after the prefix
      */
     val gameId: Int
-        get() = appId.removePrefix("${gameSource.name}_").toInt()
+        get() = appId.removePrefix("${gameSource.name}_").toIntOrNull() ?: 0
 }

app/src/main/java/app/gamenative/db/PluviaDatabase.kt

@@ -10,19 +10,22 @@ import app.gamenative.data.SteamApp
 import app.gamenative.data.SteamLicense
 import app.gamenative.data.CachedLicense
 import app.gamenative.data.EncryptedAppTicket
+import app.gamenative.data.GOGGame
 import app.gamenative.db.converters.AppConverter
 import app.gamenative.db.converters.ByteArrayConverter
 import app.gamenative.db.converters.FriendConverter
 import app.gamenative.db.converters.LicenseConverter
 import app.gamenative.db.converters.PathTypeConverter
 import app.gamenative.db.converters.UserFileInfoListConverter
+import app.gamenative.db.converters.GOGConverter
 import app.gamenative.db.dao.ChangeNumbersDao
 import app.gamenative.db.dao.FileChangeListsDao
 import app.gamenative.db.dao.SteamAppDao
 import app.gamenative.db.dao.SteamLicenseDao
 import app.gamenative.db.dao.AppInfoDao
 import app.gamenative.db.dao.CachedLicenseDao
 import app.gamenative.db.dao.EncryptedAppTicketDao
+import app.gamenative.db.dao.GOGGameDao
 
 const val DATABASE_NAME = "pluvia.db"
 
@@ -35,8 +38,9 @@ const val DATABASE_NAME = "pluvia.db"
         FileChangeLists::class,
         SteamApp::class,
         SteamLicense::class,
+        GOGGame::class,
     ],
-    version = 8,
+    version = 9,
     exportSchema = false, // Should export once stable.
 )
 @TypeConverters(
@@ -46,6 +50,7 @@ const val DATABASE_NAME = "pluvia.db"
     LicenseConverter::class,
     PathTypeConverter::class,
     UserFileInfoListConverter::class,
+    GOGConverter::class,
 )
 abstract class PluviaDatabase : RoomDatabase() {
 
@@ -62,4 +67,6 @@ abstract class PluviaDatabase : RoomDatabase() {
     abstract fun cachedLicenseDao(): CachedLicenseDao
 
     abstract fun encryptedAppTicketDao(): EncryptedAppTicketDao
+
+    abstract fun gogGameDao(): GOGGameDao
 }

app/src/main/java/app/gamenative/db/converters/GOGConverter.kt

@@ -0,0 +1,25 @@
+package app.gamenative.db.converters
+
+import androidx.room.TypeConverter
+import kotlinx.serialization.encodeToString
+import kotlinx.serialization.json.Json
+
+/**
+ * Room TypeConverter for GOG-specific data types
+ */
+class GOGConverter {
+
+    @TypeConverter
+    fun fromStringList(value: List<String>): String {
+        return Json.encodeToString(value)
+    }
+
+    @TypeConverter
+    fun toStringList(value: String): List<String> {
+
+        if (value.isEmpty()) {
+            return emptyList()
+        }
+        return Json.decodeFromString<List<String>>(value)
+    }
+}