- C 54.8%
- Kotlin 40.8%
- C++ 2.2%
- Java 1.9%
- CMake 0.3%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
|
||
| .github | ||
| .idea | ||
| app | ||
| buildSrc | ||
| codeview | ||
| fastlane | ||
| gradle/wrapper | ||
| hidden-api-impl | ||
| hidden-api-refined | ||
| hidden-api-stubs | ||
| img | ||
| .gitignore | ||
| .gitmodules | ||
| build.gradle.kts | ||
| BUILD_ROOT.md | ||
| crowdin.yml | ||
| Gemfile | ||
| Gemfile.lock | ||
| gradle.properties | ||
| gradlew | ||
| gradlew.bat | ||
| LICENSE | ||
| README.md | ||
| settings.gradle | ||
RootlessJamesDSP
System-wide JamesDSP implementation for non-rooted Android devices
Limitations • Spotify patch • Downloads • Credits
This app uses libjamesdsp which is written by James Fung (@james34602).
This app has several limitations that may be deal-breaking to some people; please read this whole document before using the app.
Limitations
- Apps blocking internal audio capture remain unprocessed (e.g., Spotify, Google Chrome)
- Cannot coexist with (some) other audio effect apps (e.g., Wavelet and other apps that make use of the
DynamicsProcessingAndroid API) - Increased audio latency
Apps confirmed working:
- YouTube
- YouTube Music
- Amazon Music
- Deezer
- Poweramp
- Substreamer
- Twitch
- Spotify ReVanced (Patch required)
- Apple Music
- Vinyl Music Player
- ...
Unsupported apps include:
- Spotify (patch for Spotify exists)
- Google Chrome
- SoundCloud
- ...
Tested on:
- Samsung Galaxy S20+ (Android 12; OneUI 4.0)
- Stock AOSP emulator (Android 10-13)
- Google Pixel 6 Pro (Android 13)
- Google Pixel 6a
Spotify support patch
Note
This patch is universal and may also work with other apps than Spotify.
You can only use Spotify with this application if you patch the Spotify app. The setup is very easy:
- Download and install the ReVanced manager APK
- Install the unpatched Spotify app
- Open ReVanced Manager, select Spotify and enable the
Remove screen capture restrictionpatch. - Start the patching process and install the patched APK once it is done.
- You can now use Spotify with RootlessJamesDSP.
Patching other unsupported apps
The Remove screen capture restriction patch is universal and can also be used with custom APKs other than Spotify.
The patch cannot remove capture restrictions for apps that use the native AAudio C++ API for playback.
- Download and install the ReVanced manager APK
- Open Revanced Manager, go to the settings screen and enable 'Show universal patches'
- Go to the patches tab and tap on 'Select an app' and press the 'Storage' action button in the bottom-right corner.
- Select your APK using the file picker.
- Enable the
Remove screen capture restrictionpatch. - Start the patching process and install the patched APK once it is done. Make sure to uninstall the unpatched app if it is installed, otherwise you will run into a signature conflict during installtion.
Warning
If the patched app crashes on startup (or refuses to work properly), it is likely that the app uses signature checks or other protections against tampering. In that case, additional patches that disable these anti-tampering checks would need to be created by hand.
Differences to other rootless FX apps
Regular rootless audio effect apps on the Play Store all essentially work the same way: Android has several default audio effects built into its operating system that these apps can use without any special permissions. Here's a list of those: https://developer.android.com/reference/android/media/audiofx/AudioEffect.
Being restricted to these default built-in audio effects is problematic if you want to implement any advanced custom effects such as Viper or JDSP, because Android does not allow apps to access & modify the audio stream directly.
To work around this problem, RootlessJamesDSP uses a bunch of tricks to gain full access to the audio stream of other apps. This is done via Android's internal audio capture. This allows RootlessJamesDSP to apply its custom audio effects directly without relying on Android's built-in effects.
Unfortunately, these tricks are not 100% reliable and introduce some limitations. Apps such as Spotify block internal audio capture (they don't want people to record their songs), and because of that, RootlessJamesDSP cannot directly access the audio stream of that app. This is the reason why a special patch is required to disable this DRM restriction inside Spotify's app. Patches for other apps with these DRM restrictions do not exist, but are possible to do.
Translations
This application can be translated via Crowdin: https://crowdin.com/project/rootlessjamesdsp
Not all languages are enabled at the moment in Crowdin. To request a new language, please open an issue here on GitHub.
Downloads
This app is available for free on Google Play: https://play.google.com/store/apps/details?id=me.timschneeberger.rootlessjamesdsp
Also available on F-Droid: https://f-droid.org/packages/me.timschneeberger.rootlessjamesdsp/
Using Root
This app focuses on a rootless implementation, but it can be made to work with the magisk module too. See here for details.
All the limitations mentioned above are not relevant for the magisk/root version.
Credits
- JamesDSP - James Fung (@james34602)
- Theming system & backup system based on Tachiyomi
