Skip to content

Unofficial YouTube Music / Spotify Premium client for Android, built in Liquid Glass. Audio effects, Spotify Connect, listening history, 8 languages. Rust core on librespot.

Prepare F-Droid listing and packaging request

Lelonio4fe785dfb341
diff --git a/docs/FDROID-RFP.md b/docs/FDROID-RFP.md
new file mode 100644
index 0000000..7d7d2f5
--- /dev/null
+++ b/docs/FDROID-RFP.md
@@ -0,0 +1,49 @@
+# Square — request for packaging
+
+- Application ID: `dev.lelonio.square`
+- Source: https://github.com/Lelonio/Square
+- Releases: https://github.com/Lelonio/Square/releases
+- Issue tracker: https://github.com/Lelonio/Square/issues
+- License: GPL-3.0-or-later, with the lyrics view under AGPL-3.0 as documented
+ in the upstream README. Please review the combined-work licensing.
+- Donation: https://ko-fi.com/lelonio
+- Current release: 2.4.5 (versionCode 46)
+
+I am the upstream author and would like Square included in F-Droid.
+Square is an Android music client for Spotify Premium and YouTube Music with
+Liquid Glass UI, synced lyrics, Spotify Connect, local files, audio effects
+and a sleep timer. It does not require the official Spotify application for
+native playback. Android 8.0 or later is required.
+
+The app uses proprietary network services; I expect `NonFreeNet` to apply.
+There are no bundled advertising/analytics SDKs in the direct Gradle dependency
+list. A complete transitive dependency scan has not yet been performed.
+
+## Question about optional Web Playback
+
+The APK does not bundle Spotify's official Web Playback SDK. An optional,
+user-selected mode runs an upstream HTML wrapper in Android WebView and loads
+`https://sdk.scdn.co/spotify-player.js` at runtime. Native Spotify playback uses
+the Rust librespot core. Is this remote SDK mode acceptable under your policy,
+or should an F-Droid variant exclude it? I am disclosing it before claiming
+the current release meets the inclusion criteria.
+
+## Packaging details
+
+The project uses Gradle, Kotlin/Compose, Rust via cargo-ndk, and CMake for
+Bungee. Two Android ABIs are built; a universal APK is available. Native
+libraries are built from source, not committed binaries. The repository's
+release CI and `docs/DEVELOPMENT.md` describe the existing build.
+
+The F-Droid buildserver recipe is not yet validated. Bungee must be prefetched
+as pinned source with its submodules before an offline build. The Rust
+toolchain must be pinned and the Maven/JitPack dependency tree audited.
+The project also has a GitHub updater whose behavior and signing compatibility
+need review for an F-Droid build.
+
+Fastlane English listing metadata has been prepared upstream. Existing app
+screenshots contain third-party album artwork; they should be omitted from
+the listing unless redistribution rights are confirmed or replaced with
+cleared demonstration artwork.
+
+Please advise on the optional remote SDK and any required packaging changes.
diff --git a/docs/FDROID.md b/docs/FDROID.md
new file mode 100644
index 0000000..2568970
--- /dev/null
+++ b/docs/FDROID.md
@@ -0,0 +1,53 @@
+# F-Droid submission preparation
+
+Status: upstream listing metadata prepared; inclusion and build recipe are not
+yet validated. No submission has been sent and no playback feature removed.
+
+## Listing
+
+English listing assets are in `fastlane/metadata/android/en-US`. The current
+release is 2.4.5, versionCode 46. Screenshots and icon are copied from the
+existing documentation. Donation URL: https://ko-fi.com/lelonio.
+
+## Review questions
+
+- Spotify and YouTube Music are proprietary network services. Propose
+ `NonFreeNet`; let reviewers determine additional labels.
+- `app/src/main/assets/websdk/player.html` dynamically loads
+ `https://sdk.scdn.co/spotify-player.js` in an optional WebView playback mode.
+ The SDK is not bundled. The official policy does not explicitly resolve
+ this specific case: ask reviewers whether it is acceptable or requires a
+ build variant excluding that mode. A network-service label alone does not
+ establish acceptance of proprietary executable code.
+- Screenshots show third-party album artwork. Verify redistribution rights or
+ replace them with screenshots using cleared/demo artwork before submission.
+- Review the GitHub updater's consent and signing behavior for F-Droid builds;
+ APKs signed by F-Droid cannot update using the upstream signing key.
+
+## Build recipe still to validate
+
+- JDK 21; compile SDK 37 (`platforms;android-37.0` in current CI), build tools
+ 36.0.0, NDK 28.2.13676358, CMake 3.22.1. Confirm availability and toolchain
+ acceptance in F-Droid's buildserver.
+- Pin a Rust toolchain compatible with the full Cargo.lock dependency tree;
+ current CI uses moving `stable`. cargo-ndk is pinned to 4.1.2.
+- Prefetch Bungee and its submodules as pinned source before the offline build;
+ the current Gradle fetch task clones from GitHub when sources are absent.
+- Resolve and audit Maven/JitPack dependencies, including the Jellyfin FFmpeg
+ decoder AAR and MetrolistExtractor; verify licenses and source availability.
+- Compile both Rust ABIs and Bungee from source. Do not reuse local jniLibs.
+- Start with the universal release APK. ABI-specific APKs currently share the
+ same versionCode, so a split listing needs a deliberate version-code scheme.
+- Run fdroid scanner/lint and a clean build of the selected tagged revision.
+ Do not claim a working recipe or reproducibility until these checks pass.
+
+## References
+
+- https://f-droid.org/docs/Submitting_to_F-Droid_Quick_Start_Guide/
+- https://f-droid.org/docs/Inclusion_Policy/
+- https://f-droid.org/docs/Anti-Features/
+
+After the review questions and build checks are resolved, submit a merge
+request to fdroid/fdroiddata with `metadata/dev.lelonio.square.yml` and the
+verified build instructions. Upstream metadata must be present in the chosen
+release tag; the existing v2.4.5 tag predates these listing files.
diff --git a/fastlane/metadata/android/en-US/changelogs/46.txt b/fastlane/metadata/android/en-US/changelogs/46.txt
new file mode 100644
index 0000000..5174a02
--- /dev/null
+++ b/fastlane/metadata/android/en-US/changelogs/46.txt
@@ -0,0 +1 @@
+New releases from artists you follow, per-playlist sorting and a connected-device display setting. Improved Spotify Connect queue and playback handoff, recovery after network changes, local-file matching and bottom-bar glass rendering.
diff --git a/fastlane/metadata/android/en-US/full_description.txt b/fastlane/metadata/android/en-US/full_description.txt
new file mode 100644
index 0000000..0ee11f2
--- /dev/null
+++ b/fastlane/metadata/android/en-US/full_description.txt
@@ -0,0 +1,16 @@
+Square is a free, open-source Android music client for Spotify Premium and YouTube Music, with a Liquid Glass interface.
+
+• Synced lyrics and Canvas
+• Spotify Connect
+• Independent speed and pitch controls, reverb and effect presets
+• Local music files and playlist support
+• New releases from artists you follow
+• Per-playlist sorting
+• Sleep timer
+
+Spotify playback requires a Spotify Premium account. Setup instructions are included in the app. Some playback modes have different capabilities; audio effects are not available through Spotify Web Playback.
+
+Square uses proprietary Spotify and YouTube Music services. Optional Spotify Web Playback loads Spotify's official JavaScript SDK remotely in a WebView; it is not bundled in the APK. Square is not affiliated with Spotify or Google.
+
+Source, setup and feedback: https://github.com/Lelonio/Square
+Community: https://t.me/+-XDmbFwz7uBkMjc0
diff --git a/fastlane/metadata/android/en-US/images/icon.png b/fastlane/metadata/android/en-US/images/icon.png
new file mode 100644
index 0000000..09a2bc9
Binary files /dev/null and b/fastlane/metadata/android/en-US/images/icon.png differ
diff --git a/fastlane/metadata/android/en-US/images/phoneScreenshots/1.png b/fastlane/metadata/android/en-US/images/phoneScreenshots/1.png
new file mode 100644
index 0000000..f512ab0
Binary files /dev/null and b/fastlane/metadata/android/en-US/images/phoneScreenshots/1.png differ
diff --git a/fastlane/metadata/android/en-US/images/phoneScreenshots/2.png b/fastlane/metadata/android/en-US/images/phoneScreenshots/2.png
new file mode 100644
index 0000000..b9b4220
Binary files /dev/null and b/fastlane/metadata/android/en-US/images/phoneScreenshots/2.png differ
diff --git a/fastlane/metadata/android/en-US/images/phoneScreenshots/3.png b/fastlane/metadata/android/en-US/images/phoneScreenshots/3.png
new file mode 100644
index 0000000..9f97714
Binary files /dev/null and b/fastlane/metadata/android/en-US/images/phoneScreenshots/3.png differ
diff --git a/fastlane/metadata/android/en-US/images/phoneScreenshots/4.png b/fastlane/metadata/android/en-US/images/phoneScreenshots/4.png
new file mode 100644
index 0000000..b334939
Binary files /dev/null and b/fastlane/metadata/android/en-US/images/phoneScreenshots/4.png differ
diff --git a/fastlane/metadata/android/en-US/images/phoneScreenshots/5.png b/fastlane/metadata/android/en-US/images/phoneScreenshots/5.png
new file mode 100644
index 0000000..3bb2e80
Binary files /dev/null and b/fastlane/metadata/android/en-US/images/phoneScreenshots/5.png differ
diff --git a/fastlane/metadata/android/en-US/images/phoneScreenshots/6.png b/fastlane/metadata/android/en-US/images/phoneScreenshots/6.png
new file mode 100644
index 0000000..a45ed2e
Binary files /dev/null and b/fastlane/metadata/android/en-US/images/phoneScreenshots/6.png differ
diff --git a/fastlane/metadata/android/en-US/short_description.txt b/fastlane/metadata/android/en-US/short_description.txt
new file mode 100644
index 0000000..1e847d7
--- /dev/null
+++ b/fastlane/metadata/android/en-US/short_description.txt
@@ -0,0 +1 @@
+Spotify and YouTube Music in Liquid Glass
diff --git a/fastlane/metadata/android/en-US/title.txt b/fastlane/metadata/android/en-US/title.txt
new file mode 100644
index 0000000..e7be239
--- /dev/null
+++ b/fastlane/metadata/android/en-US/title.txt
@@ -0,0 +1 @@
+Square