| docs | ||
| drizzle | ||
| public | ||
| src | ||
| views | ||
| .editorconfig | ||
| .env.example | ||
| .gitignore | ||
| config.example.toml | ||
| drizzle.config.ts | ||
| eslint.config.mjs | ||
| flake.lock | ||
| flake.nix | ||
| LICENSE | ||
| package-lock.json | ||
| package.json | ||
| README.md | ||
| tsconfig.json | ||
amdl
a self-hostable web-ui apple music downloader widevine decryptor with questionable legality
thank you to gamdl for inspiring this project. i don't like python and i wanted a web front end
setup
.env
MEDIA_USER_TOKEN and ITUA are both from your apple music cookies
WIDEVINE_CLIENT_ID is uhm owie. this thing kind of Sucks to obtain and i would totally recommend finding a not-so-legal spot you can obtain this from (in fact, i found one on github LOL), rather than extracting it yourself. if you want to do through the pain like i did, check this guide out!! once you have your client_id.bin file, convert it to base64 and slap it in the env var (cat client_id.bin | base64 -w 0)
WIDEVINE_PRIVATE_KEY is essentially the same process of obtainment, you'll get it from the same guide!! i'm not sure how to easily find one of these on the web, but i'm sure you end users (user count: 0 (
)) can pull through. this is also in base64 (cat private_key.pem | base64 -w 0)
MIGRATIONS_DIR, PUBLIC_DIR, and VIEWS_DIR should typically not need to be set by the user if using this repository as the working directory. blank values will result in simply drizzle, views, and public being grabbed from the cwd, which also so happens to be the default in .env.example. set this manually to your own value if you get full runtime errors when accessing pages relating to templates being missing, assets having unexpected 404 issues, etc. this value is also recommended for packagers, to prevent the users having to copy over views and public--see how the nix build works!
config
most of the config is talked on in config.example.toml, just copy it over to config.toml and go wild! if you don't it will automatically be copied over on your first run. (at least if you're in the same directory as the repository) i tried to make the error reporting for invalid configurations pretty good and digestable
running
regular
after configuring, it's just as easy as running npm run build and running the dist/index.js file with your javascript engine of choice
nix
a system module is provided for your convenience, and the main output is nixosModules.default
after importing this module, the option services.amdl will show up, which is documented in flake.nix somewhat well. everything under the config tree follows the config.toml well, along with everything under the env tree. defaults are provided for everything that isn't the ITUA inside of the env section. make sure to set those!!
nginx information
a decent amount of nginx setups (and ones on nixos using recommendedProxySettings) have proxy buffering on, i recommend turning that off (if the whole file isnt downloaded before the read timeout, then it will just drop the file)
proxy_buffering off;
limitations / the formats
currently you can only get basic widevine ones, everything related to playready and fairplay encryption methods are not supported, sorry!! someday i will get this working, at least for playready. it's just that no one has written a library yet but has for python (yuck!!) lossless audio is unfortunately out of the question currently. it will be a while till someone breaks fairplay drm
guaranteed formats to work include:
aac_legacyaac_he_legacy
screenshots
