chore: initial hard fork to Solstice

Rebranded from ArchiveTune to Solstice. Modified package name to urstark.solstice. Updated icons to Solar Icons. Maintained copyright notices for original author Rukamori as per GPLv3.

Author: urstark

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -15,7 +15,7 @@ body:
       label: Required pre-submission checklist
       description: Reports that skip these checks are difficult to triage and may be closed.
       options:
-        - label: I have tested this bug on the [latest nightly version](https://github.com/ArchiveTuneApp/ArchiveTune/actions).
+        - label: I have tested this bug on the [latest nightly version](https://github.com/SolsticeIO/ArchiveTune/actions).
           required: true
         - label: This report describes one specific bug, not multiple unrelated problems.
           required: true

.github/workflows/header.yml

@@ -9,115 +9,79 @@ jobs:
     steps:
       - uses: actions/checkout@v6
 
-      - uses: actions/setup-go@v6
-        with:
-          go-version: '1.26'
-
-      - name: Install addlicense
-        run: go install github.com/google/addlicense@latest
-
-      - name: Write Kotlin header banner
-        run: |
-          YEAR=$(date +%Y)
-          cat > banner.txt <<EOF
-          ArchiveTune ($YEAR)
-          © Rukamori — github.com/rukamori
-          GPL-3.0 License | Contributors: see git history
-          Do not remove or alter this notice. - Per GPL-3.0 Section 4 & Section 5
-          EOF
-
-      - name: Find duplicate Kotlin headers
+      - name: Add or Update Kotlin headers
         run: |
           python3 <<'PY'
           from pathlib import Path
 
-          marker = "GPL-3.0 License | Contributors: see git history"
-          duplicates = []
+          SOLSTICE_HEADER = """/*
+           * Solstice (2026)
+           * © Stark — github.com/urstark
+           * 
+           * Based on ArchiveTune (2026)
+           * © Rukamori — github.com/rukamori
+           * 
+           * GPL-3.0 License | Contributors: see git history
+           * Do not remove or alter this notice. - Per GPL-3.0 Section 4 & Section 5
+           */
+          """
+
+          SOLSTICE_ONLY_HEADER = """/*
+           * Solstice (2026)
+           * © Stark — github.com/urstark
+           * 
+           * GPL-3.0 License | Contributors: see git history
+           * Do not remove or alter this notice. - Per GPL-3.0 Section 4 & Section 5
+           */
+          """
+
+          total_updated = 0
 
           for path in Path(".").rglob("*.kt"):
               if ".git" in path.parts or "build" in path.parts:
                   continue
 
-              count = path.read_text(encoding="utf-8").count(marker)
-              if count > 1:
-                  duplicates.append((path, count))
-
-          if duplicates:
-              print("Duplicate Kotlin headers found:")
-              for path, count in duplicates:
-                  print(f"{path}: {count}")
-          else:
-              print("No duplicate Kotlin headers found.")
-          PY
-
-      - name: Remove existing Kotlin headers
-        run: |
-          python3 <<'PY'
-          from pathlib import Path
-
-          archive_marker = "ArchiveTune ("
-          license_marker = "GPL-3.0 License | Contributors: see git history"
-          total_removed = 0
-
-          for path in Path(".").rglob("*.kt"):
-              if ".git" in path.parts or "build" in path.parts:
+              try:
+                  content = path.read_text(encoding="utf-8")
+              except UnicodeDecodeError:
                   continue
 
-              text = path.read_text(encoding="utf-8")
-              removed = 0
-
-              while text.startswith("/*"):
-                  end = text.find("*/")
+              has_rukamori = False
+              has_stark = False
+              text_without_header = content
+              
+              while text_without_header.startswith("/*"):
+                  end = text_without_header.find("*/")
                   if end == -1:
                       break
-
-                  header = text[:end + 2]
-                  if archive_marker not in header or license_marker not in header:
+                  header = text_without_header[:end + 2]
+                  if "GPL-3.0 License" in header:
+                      if "© Rukamori" in header:
+                          has_rukamori = True
+                      if "© Stark" in header:
+                          has_stark = True
+                      text_without_header = text_without_header[end + 2:].lstrip("\r\n")
+                  else:
                       break
-
-                  text = text[end + 2:].lstrip("\r\n")
-                  removed += 1
-
-              if removed:
-                  path.write_text(text, encoding="utf-8")
-                  total_removed += removed
-                  print(f"{path}: removed {removed} existing header(s)")
-
-          print(f"Removed {total_removed} existing Kotlin header(s).")
-          PY
-
-      - name: Add current Kotlin header
-        run: |
-          find . -path "./.git" -prune -o -path "*/build" -prune -o -type f -name "*.kt" -print0 | xargs -0 -r "$(go env GOPATH)/bin/addlicense" -v -f banner.txt
-          rm banner.txt
-
-      - name: Verify Kotlin headers are unique
-        run: |
-          python3 <<'PY'
-          from pathlib import Path
-          import sys
-
-          marker = "GPL-3.0 License | Contributors: see git history"
-          duplicates = []
-
-          for path in Path(".").rglob("*.kt"):
-              if ".git" in path.parts or "build" in path.parts:
-                  continue
-
-              count = path.read_text(encoding="utf-8").count(marker)
-              if count > 1:
-                  duplicates.append((path, count))
-
-          if duplicates:
-              print("Duplicate Kotlin headers remain:")
-              for path, count in duplicates:
-                  print(f"{path}: {count}")
-              sys.exit(1)
-
-          print("Every Kotlin file has at most one ArchiveTune header.")
+                      
+              # Now prepend the new header
+              new_content = content
+              if has_rukamori or has_stark:
+                  if has_rukamori:
+                      new_content = SOLSTICE_HEADER + text_without_header
+                  else:
+                      new_content = SOLSTICE_ONLY_HEADER + text_without_header
+              else:
+                  new_content = SOLSTICE_ONLY_HEADER + text_without_header
+
+              if content != new_content:
+                  path.write_text(new_content, encoding="utf-8")
+                  total_updated += 1
+                  print(f"{path}: updated header")
+
+          print(f"Updated {total_updated} Kotlin header(s).")
           PY
 
       - uses: stefanzweifel/git-auto-commit-action@v7
         with:
-          commit_message: Kotlin Header
-          
+          commit_message: Update Kotlin Headers

ArchiveTuneKoiverseServer.txt

@@ -1 +1 @@
-https://archivetune-api.koiiverse.cloud
+https://solstice-api.koiiverse.cloud

CONTRIBUTING.md

@@ -1,6 +1,6 @@
 # 🛠️ Engineering & Build Guide
 
-This document defines the protocols for setting up the development environment, understanding the underlying technology stack, and compiling **ArchiveTune** from the source.
+This document defines the protocols for setting up the development environment, understanding the underlying technology stack, and compiling **Solstice** from the source.
 
 ---
 
@@ -17,7 +17,7 @@ To ensure build stability and environment parity, the following hardware and sof
 
 ### **Technical DNA (Skill Requirements)**
 
-The ArchiveTune codebase is built on a modern, reactive architecture. Contributors are expected to have a high level of familiarity with:
+The Solstice codebase is built on a modern, reactive architecture. Contributors are expected to have a high level of familiarity with:
 
 * **Kotlin (Advanced):** Proficiency in Coroutines, Flow API, and functional paradigms.
 * **Jetpack Compose:** Understanding of State Hoisting, Recomposition optimization, and Material 3 design systems.
@@ -28,7 +28,7 @@ The ArchiveTune codebase is built on a modern, reactive architecture. Contributo
 
 ## 📐 Architectural Manifesto
 
-ArchiveTune follows a strict **Clean Architecture** approach. This separation of concerns ensures that the audio engine remains independent of the UI layer.
+Solstice follows a strict **Clean Architecture** approach. This separation of concerns ensures that the audio engine remains independent of the UI layer.
 
 1. **UI Layer (Compose):** Handles user interactions and renders state emitted by ViewModels.
 2. **Domain Layer:** Contains business logic, Use Cases, and high-level audio processing interfaces.
@@ -41,14 +41,14 @@ ArchiveTune follows a strict **Clean Architecture** approach. This separation of
 
 1. **Clone the Source:**
 ```bash
-git clone https://github.com/ArchiveTuneApp/ArchiveTune.git
-cd ArchiveTune
+git clone https://github.com/SolsticeIO/Solstice.git
+cd Solstice
 
 ```
 
 
 2. **Secret Management:**
-ArchiveTune uses a modular properties system. If your build requires specific API keys (e.g., Discord Client IDs), define them in your `local.properties`:
+Solstice uses a modular properties system. If your build requires specific API keys (e.g., Discord Client IDs), define them in your `local.properties`:
 ```properties
 # Path to your Android SDK
 sdk.dir=/Users/yourname/Library/Android/sdk
@@ -96,5 +96,5 @@ Before initiating a Pull Request, every contributor must run the following quali
 ---
 
 <div align="center">
-<sub>ArchiveTune: Engineering audio freedom. Part of the <strong>Koiverse</strong> ecosystem.</sub>
+<sub>Solstice: Engineering audio freedom. Part of the <strong>Koiverse</strong> ecosystem.</sub>
 </div>

PRIVACY.md

@@ -1,18 +1,18 @@
-# ArchiveTune Privacy Notice
+# Solstice Privacy Notice
 
 Last updated: 2026-04-20
 
 ## Scope
 
-This notice covers the Android ArchiveTune app in this repository. It explains what the app stores on your device, what it can send to external services when you use specific features, and what Android permissions it requests.
+This notice covers the Android Solstice app in this repository. It explains what the app stores on your device, what it can send to external services when you use specific features, and what Android permissions it requests.
 
-This notice is based on the current source code and build configuration. It does not replace the privacy terms of YouTube or YouTube Music, Last.fm, ListenBrainz, Discord, GitHub, lyrics providers, the ArchiveTune canvas service, or any Together server you choose to use.
+This notice is based on the current source code and build configuration. It does not replace the privacy terms of YouTube or YouTube Music, Last.fm, ListenBrainz, Discord, GitHub, lyrics providers, the Solstice canvas service, or any Together server you choose to use.
 
 ## Privacy Summary
 
 - Most core app data is stored locally on your device.
-- ArchiveTune does not secretly harvest, sell, or broker your personal data.
-- ArchiveTune does not silently send your data to unrelated third-party services.
+- Solstice does not secretly harvest, sell, or broker your personal data.
+- Solstice does not silently send your data to unrelated third-party services.
 - Optional network features send only the data needed to provide those features.
 - If data leaves your device, it is because you used a specific online feature or integration that requires that transfer.
 - Android backup and device-transfer features may copy part of the app's local data unless excluded by the app's backup rules.
@@ -36,13 +36,13 @@ The app stores data locally to provide playback, library, search, lyrics, sync,
 
 ## Data the App May Send Off Your Device
 
-ArchiveTune does not silently forward your data to unrelated services. It only contacts external services when you use online features, and the exact payload depends on the feature you use and how you configure it.
+Solstice does not silently forward your data to unrelated services. It only contacts external services when you use online features, and the exact payload depends on the feature you use and how you configure it.
 
 | Service or feature | Data that may be sent | When it happens |
 | --- | --- | --- |
 | YouTube or YouTube Music | Search terms, media playback requests, library or playlist requests, and signed-in session values such as visitor data, sync identifiers, cookies, or token values | When you browse, stream, sync, or sign in |
 | Lyrics providers | Song title, artist name, album identifiers, or similar lookup data needed to fetch lyrics | When lyrics features are enabled or lyrics are requested |
-| ArchiveTune canvas service | Song and artist names, album ID, or album URL, plus a bearer token if configured in the app build | When canvas or artwork lookup features are used |
+| Solstice canvas service | Song and artist names, album ID, or album URL, plus a bearer token if configured in the app build | When canvas or artwork lookup features are used |
 | Last.fm | Now playing and scrobble metadata, plus your Last.fm session information | When Last.fm scrobbling is enabled |
 | ListenBrainz | Playback history or scrobble metadata and your ListenBrainz token | When ListenBrainz sync is enabled |
 | Discord Rich Presence | Current track, artist, album, images, configured URLs or labels for presence cards, and Discord OAuth tokens required by the official Social SDK | When Discord Rich Presence is enabled |
@@ -70,7 +70,7 @@ If you deny a permission, the related feature may stop working or provide reduce
 
 ## Backups, Device Transfer, and Local Retention
 
-ArchiveTune currently enables Android backup support. The backup and data-transfer rules exclude some cache and download paths, including the ExoPlayer cache, the download directory, and `exoplayer_internal.db`. Other app data, including local database content and app preferences, may still be included in Android cloud backup or device transfer depending on your Android settings and device behavior.
+Solstice currently enables Android backup support. The backup and data-transfer rules exclude some cache and download paths, including the ExoPlayer cache, the download directory, and `exoplayer_internal.db`. Other app data, including local database content and app preferences, may still be included in Android cloud backup or device transfer depending on your Android settings and device behavior.
 
 The app also provides a manual backup feature that creates a ZIP archive containing app settings and database files. This is a user-triggered export action.
 
@@ -107,14 +107,14 @@ You can control a significant amount of privacy-related behavior from the app an
 
 ## Changes to This Notice
 
-This file should be reviewed whenever ArchiveTune changes its permissions, storage model, external integrations, backup behavior, or network architecture.
+This file should be reviewed whenever Solstice changes its permissions, storage model, external integrations, backup behavior, or network architecture.
 
 ## Project Contact
 
 For questions or corrections, use the project repository and issue tracker.
 
-- Repository: [https://github.com/ArchiveTuneApp/ArchiveTune](https://github.com/ArchiveTuneApp/ArchiveTune)
-- Issues: [https://github.com/ArchiveTuneApp/ArchiveTune/issues](https://github.com/ArchiveTuneApp/ArchiveTune/issues)
+- Repository: [https://github.com/SolsticeIO/Solstice](https://github.com/SolsticeIO/Solstice)
+- Issues: [https://github.com/SolsticeIO/Solstice/issues](https://github.com/SolsticeIO/Solstice/issues)
 
 ## Technical Appendix
 
@@ -123,12 +123,12 @@ This appendix maps the main statements above to concrete implementation surfaces
 | Topic | What the code shows | Main files |
 | --- | --- | --- |
 | Permissions and backup behavior | The manifest declares network, media, microphone, Bluetooth, notification, boot, wake-lock, and foreground-service permissions. It also enables backup, cleartext traffic, and audio playback capture. Separate XML files exclude selected caches and internal playback database files from Android backup and device transfer. | `app/src/main/AndroidManifest.xml`, `app/src/main/res/xml/data_extraction_rules.xml`, `app/src/main/res/xml/backup_rules.xml` |
-| Local database contents | The Room schema includes songs, artists, albums, playlists, search history, lyrics, audio format metadata, and playback event records. | `app/schemas/moe.rukamori.archivetune.db.InternalDatabase/9.json` |
-| Settings and tokens stored locally | DataStore preference keys include UI settings, proxy settings, history toggles, Together values, YouTube session values, account name or email fields, Last.fm session values, ListenBrainz token values, Discord values, and update-cache keys. | `app/src/main/kotlin/moe/archivetuneapp/archivetune/constants/PreferenceKeys.kt` |
-| YouTube signed-in state | The Innertube layer exposes visitor data, data sync ID, cookie, PO token values, proxy state, and login-for-browse behavior as part of the current playback auth state. | `innertube/src/main/kotlin/moe/archivetuneapp/archivetune/innertube/YouTube.kt` |
-| Manual backup export | The backup view model writes app settings plus database files into a ZIP archive chosen by the user. | `app/src/main/kotlin/moe/archivetuneapp/archivetune/viewmodels/BackupRestoreViewModel.kt` |
-| External network integrations | Build configuration defines keys for Last.fm, Together, and canvas services. The updater fetches release information and caches related metadata in app preferences. | `app/build.gradle.kts`, `app/src/main/kotlin/moe/archivetuneapp/archivetune/utils/Updater.kt` |
-| Canvas service requests | The canvas module sends song and artist names, album IDs, or album URLs to `https://artwork-archivetune.koiiverse.cloud/` and can attach a bearer token. | `canvas/src/main/kotlin/moe/archivetuneapp/archivetune/canvas/ArchiveTuneCanvas.kt` |
+| Local database contents | The Room schema includes songs, artists, albums, playlists, search history, lyrics, audio format metadata, and playback event records. | `app/schemas/urstark.solstice.db.InternalDatabase/9.json` |
+| Settings and tokens stored locally | DataStore preference keys include UI settings, proxy settings, history toggles, Together values, YouTube session values, account name or email fields, Last.fm session values, ListenBrainz token values, Discord values, and update-cache keys. | `app/src/main/kotlin/moe/solsticeapp/solstice/constants/PreferenceKeys.kt` |
+| YouTube signed-in state | The Innertube layer exposes visitor data, data sync ID, cookie, PO token values, proxy state, and login-for-browse behavior as part of the current playback auth state. | `innertube/src/main/kotlin/moe/solsticeapp/solstice/innertube/YouTube.kt` |
+| Manual backup export | The backup view model writes app settings plus database files into a ZIP archive chosen by the user. | `app/src/main/kotlin/moe/solsticeapp/solstice/viewmodels/BackupRestoreViewModel.kt` |
+| External network integrations | Build configuration defines keys for Last.fm, Together, and canvas services. The updater fetches release information and caches related metadata in app preferences. | `app/build.gradle.kts`, `app/src/main/kotlin/moe/solsticeapp/solstice/utils/Updater.kt` |
+| Canvas service requests | The canvas module sends song and artist names, album IDs, or album URLs to `https://artwork-solstice.koiiverse.cloud/` and can attach a bearer token. | `canvas/src/main/kotlin/moe/solsticeapp/solstice/canvas/SolsticeCanvas.kt` |
 | Public feature claims | The repository README and store metadata describe privacy, YouTube integration, lyrics, music recognition, Last.fm, ListenBrainz, Discord Rich Presence, and other network-backed features that must stay aligned with this notice. | `README.md`, `fastlane/metadata/android/en-US/full_description.txt` |
 | Current dependency posture | The current Android dependency declarations show Compose, Room, Hilt, Ktor, Media3, Coil, Timber, and related libraries. They do not currently show Firebase, Crashlytics, Sentry, mobile ad SDKs, or mobile analytics SDKs in the Android app dependency definitions reviewed for this notice. | `app/build.gradle.kts`, `gradle/libs.versions.toml` |