Unofficial YouTube Music / Spotify Premium client for Android, built in Liquid Glass. Audio effects, Spotify Connect, listening history, 8 languages. Rust core on librespot.
Kotlin alternativeandroidandroid-applicationclientglassmorphisminnertubelibrespotliquid-glassspotifyspotify-connectspotifyapiyoutube-musicyoutube-playerytdlnis
Prepare F-Droid listing and packaging request
Lelonio4fe785dfb341
diff --git a/docs/FDROID-RFP.md b/docs/FDROID-RFP.mdnew file mode 100644index 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.mdnew file mode 100644index 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.txtnew file mode 100644index 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.txtnew file mode 100644index 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/+-XDmbFwz7uBkMjc0diff --git a/fastlane/metadata/android/en-US/images/icon.png b/fastlane/metadata/android/en-US/images/icon.pngnew file mode 100644index 0000000..09a2bc9Binary files /dev/null and b/fastlane/metadata/android/en-US/images/icon.png differdiff --git a/fastlane/metadata/android/en-US/images/phoneScreenshots/1.png b/fastlane/metadata/android/en-US/images/phoneScreenshots/1.pngnew file mode 100644index 0000000..f512ab0Binary files /dev/null and b/fastlane/metadata/android/en-US/images/phoneScreenshots/1.png differdiff --git a/fastlane/metadata/android/en-US/images/phoneScreenshots/2.png b/fastlane/metadata/android/en-US/images/phoneScreenshots/2.pngnew file mode 100644index 0000000..b9b4220Binary files /dev/null and b/fastlane/metadata/android/en-US/images/phoneScreenshots/2.png differdiff --git a/fastlane/metadata/android/en-US/images/phoneScreenshots/3.png b/fastlane/metadata/android/en-US/images/phoneScreenshots/3.pngnew file mode 100644index 0000000..9f97714Binary files /dev/null and b/fastlane/metadata/android/en-US/images/phoneScreenshots/3.png differdiff --git a/fastlane/metadata/android/en-US/images/phoneScreenshots/4.png b/fastlane/metadata/android/en-US/images/phoneScreenshots/4.pngnew file mode 100644index 0000000..b334939Binary files /dev/null and b/fastlane/metadata/android/en-US/images/phoneScreenshots/4.png differdiff --git a/fastlane/metadata/android/en-US/images/phoneScreenshots/5.png b/fastlane/metadata/android/en-US/images/phoneScreenshots/5.pngnew file mode 100644index 0000000..3bb2e80Binary files /dev/null and b/fastlane/metadata/android/en-US/images/phoneScreenshots/5.png differdiff --git a/fastlane/metadata/android/en-US/images/phoneScreenshots/6.png b/fastlane/metadata/android/en-US/images/phoneScreenshots/6.pngnew file mode 100644index 0000000..a45ed2eBinary files /dev/null and b/fastlane/metadata/android/en-US/images/phoneScreenshots/6.png differdiff --git a/fastlane/metadata/android/en-US/short_description.txt b/fastlane/metadata/android/en-US/short_description.txtnew file mode 100644index 0000000..1e847d7--- /dev/null+++ b/fastlane/metadata/android/en-US/short_description.txt@@ -0,0 +1 @@+Spotify and YouTube Music in Liquid Glassdiff --git a/fastlane/metadata/android/en-US/title.txt b/fastlane/metadata/android/en-US/title.txtnew file mode 100644index 0000000..e7be239--- /dev/null+++ b/fastlane/metadata/android/en-US/title.txt@@ -0,0 +1 @@+Square