Psylos Morphe Patches

SoundCloud-only patch collection maintained by Psylos for use with Morphe.

Add as a Morphe patch source

Repository: https://github.com/lootdev78/psylos-morphe-patches

Morphe source link: https://morphe.software/add-source?github=lootdev78/psylos-morphe-patches

The files patches-bundle.json, patches-list.json, CHANGELOG.md and the .mpp release asset are generated by the Semantic Release workflow. Do not hand-edit release metadata after the first successful release.

Supported app

App	Package	Tested version
SoundCloud	com.soundcloud.android	2026.08.26-release (versionCode 369070)

No patch in this repository declares compatibility with another Android package.

Included patches

Patch	Author / credit	Purpose
Download button hook	Psylos — private patch	Routes track and playlist download actions to the package configured in the Psylos settings dialog through Android ACTION_SEND, using only a public soundcloud.com URL.
Hide Cast icon	Psylos — private patch	Adds a setting that hides both SoundCloud Cast-button implementations.
Enable SoundCloud Go	Hoo-dles	Existing upstream SoundCloud patch; original source headers and credit are retained.
AMOLED dark theme	Hoo-dles	Existing upstream SoundCloud patch; original source headers and credit are retained.
Disable telemetry	Hoo-dles	Existing upstream SoundCloud patch; original source headers and credit are retained.

Private settings

Selecting either private patch adds one Psylos Morphe Patches row to SoundCloud settings. The dialog displays only controls for private patches actually included in the build:

• Download-Hook aktivieren and the external package-name field, when Download button hook is selected.
• Cast-Icon under Oberleiste - Icons ausblenden, when Hide Cast icon is selected.

No Home-section filters, upload/inbox/notification hiding, bottom-navigation hiding, Create-button hiding, or icon-only navigation settings are included.

The setting keys from the supplied Morphed APK are intentionally preserved so existing values can migrate:

• morphe_download_hook_enabled
• morphe_download_hook_package
• morphe_sc_hide_top_cast

Project layout

extensions/soundcloud/
  src/main/java/hoodles/...       # Existing credited Hoo-dles extension
  src/main/java/psylos/...        # Psylos private extension workflows
  stub/                            # Compile-only SoundCloud/Compose symbols

patches/src/main/kotlin/
  hoodles/.../soundcloud/          # Existing credited SoundCloud patches
  psylos/.../soundcloud/download/  # Download button hook patch
  psylos/.../soundcloud/cast/      # Hide Cast icon patch
  psylos/.../soundcloud/shared/    # Shared settings injection/status

Both private patches depend on the same SoundCloud extension injection, so selecting both does not duplicate extension classes or the settings row.

Build

Requirements:

• JDK 21 to run the included Gradle wrapper.
• Access to the repositories declared in settings.gradle.kts and patches/build.gradle.kts.
• GitHub Packages credentials when the Morphe registry requires authentication (GITHUB_ACTOR / GITHUB_TOKEN, or Gradle properties gpr.user / gpr.key).

Build the patch bundle with:

./gradlew :patches:build --no-daemon

The repository deliberately does not include the source APK, a patched APK, signing keys, or a downloader application.

Detailed local checks and the documented Gradle network limitation are in VALIDATION.md.

Attribution and license

This is a GPLv3 derivative of the supplied Hoo-dles patch repository and uses Morphe patch APIs. Existing Hoo-dles/Morphe copyright headers have not been replaced. Psylos ownership is asserted only for the two newly reconstructed private workflows and their supporting settings code.

See NOTICE and LICENSE.