Important
This page aims at providing compilation steps for Alchemy. By compiling and using this app, you have read and understood the legal section of the Alchemy project. You take full responsibility for using the app according to the aforementioned disclaimer.
Tip
While individual commits should compile and produce working APKs, it is highly recommended to use releases. To download the latest release, visit latest
Before you begin, ensure you have the following installed:
- Flutter: v3.32.2 (Flutter SDK)
- Dart: v3.8.1 (Dart SDK)
Alchemy relies on several custom Git submodules. Clone these repositories and their dependencies:
You will need to obtain the specified Git modules:
- @DJDoubleD's custom_navigator
- @DJDoubleD's external_path
- @DJDoubleD's marquee
- @DJDoubleD's move_to_background
- @DJDoubleD's scrobblenaut
- @SedlarDavid's figma_squircle
- @mufassalhussain's open_filex
- My liquid_progress_indicator_v2
For each submodule, navigate to its directory and run:
flutter pub get
flutter pub upgrade
dart run build_runner clean
dart run build_runner build --delete-conflicting-outputs
flutter cleanTip
All of this can be achieved by using the provided script:
powershell -ep bypass -c .\run_build_runner.ps1
Warning
Scrobblenaut has a known compatibility issue (as of 08/2025).
Refer to my pull request for a potential fix.
Warning
sqflite also seems to have a compatibility issue with the latest AGP, Kotlin and Flutter version.
Compilation may fail with errors such as:
error: cannot find symbol variable BAKLAVAerror: cannot find symbol method of(String,String,String)error: cannot find symbol method threadId()
I was able to bypass this issue by editing the affected lines in the sqflite package at:
...\pub.dev\sqflite_android-2.4.2+2\android\src\main\java\com\tekartik\sqflite\Utils.java
To use Alchemy, you'll need API keys from Deezer, Last.fm and ACRCloud:
- Deezer: You will need both the full gateway API key and the Mobile Key (Required for authentication)
- LastFm: https://www.last.fm/fr/api (Required for optional scrobbling)
- ACR Cloud https://console.acrcloud.com/ (Required for optional song or humming recognition)
Create a .env file in the /lib directory with your API credentials:
# Deezer Mobile GateWay API
deezerGatewayAPI = '<Required_Deezer_Gateway_Key>';
deezerMobileKey = '<Required_Deezer_Mobile_Key>';
# LastFM API credentials
lastFmApiKey = '<LastFM_API_Key_Can_Be_Left_Empty>';
lastFmApiSecret = '<LastFM_API_Secret_Can_Be_Left_Empty>';
# ACRCloud's API Key
acrcloudHost = '<ACRCloud_host_address>'; # eg. "identify-eu-west-1.acrcloud.com"
acrcloudSongApiKey = '<ACRCloud_Song_Recognition_API_Key_Can_Be_Left_Empty>';
acrcloudSongApiSecret = '<ACRCloud_Song_Recognition_API_Secret_Can_Be_Left_Empty>';
acrcloudHumsApiKey = '<ACRCloud_Humming_Recognition_API_Key_Can_Be_Left_Empty>';
acrcloudHumsApiSecret = '<ACRCloud_Humming_Recognition_API_Secret_Can_Be_Left_Empty>';
Generate signing keys for your release build using Java's keytool:
keytool -genkey -v -keystore ./keys.jks -keyalg RSA -keysize 2048 -validity 10000 -alias <YourKeyAlias>Move keys.jks to android/app and create android/key.properties:
storePassword=<storePassword>
keyPassword=<keyPassword>
keyAlias=<keyAlias>
storeFile=keys.jksFinally, build the release APK:
flutter build apk --split-per-abi --releaseThe generated APKs will be found under build/app/outputs/flutter-apk.
⭐ If this project helps you, don’t forget to star the repo!