Unshackle - Modular Movie, TV, and Music Archival Software

[Tom Saurus]

I can get CRAV to successful load a list of titles and also to show quality available for a title but beyond that is is failing for me.

AttributeError: 'CRAV' object has no attribute 'license_url'

That was actually an error on my part and has been fixed in the latest update. Widevine L3 will only work up to 720p, though, so keep that in mind.

Edit: Actually, it looks like some titles can license 1080p L3. Either way, I'd recommend using playready for anything higher quality.

Thank you for this fix. I am testing it right now and it seems to be working. I will have to learn about Playready though and work at adding that as an option in my Unshackle set up. I am happy with these lower resolutions as my DSL is not all that fast and with the price of hard drives going up it is what is best for me to be content with that.

[davebee]

So after using devine for the past year, i'm finally making the move to unshackle.
All working well except for downloads that use n_m3u8dl_re.

I keep getting this error:

     1 Video     └── [H.264, SDR] | en-US | 960x540 @ 1782 kb/s, 23.976 FPS
         ⠏ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ • --:-- • Parsing streams...
     1 Audio
     └── [AAC] | en-US | 2.0 | 130 kb/s | United States
         ⠏ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ • --:-- • Parsing streams...


     Widevine(AAAAVnBzc2gAAAAA7e+LqXnWSs6jyCfc1R0h7QAAADYIARIQB1oxzyEKT...)
     └── 075a31cf210a4e0fac141dfe26668cce:f0c5249ab18ae2e12c4affe509e218f7*
         from drmlab HTTPAPI




     ❌ Download Failed...
        Output directory does not exist: Temp\Video_1710c6ed.mp4_segments
        An unexpected error occurred in one of the download workers.
        See the error trace above for more information.

The Temp directory is there.
The other download workers work fine.
So scratching my head trying to resolve this.

Any suggestions?

[Tom Saurus]

So after using devine for the past year, i'm finally making the move to unshackle.
All working well except for downloads that use n_m3u8dl_re.

I keep getting this error:

     1 Video     └── [H.264, SDR] | en-US | 960x540 @ 1782 kb/s, 23.976 FPS
         ⠏ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ • --:-- • Parsing streams...
     1 Audio
     └── [AAC] | en-US | 2.0 | 130 kb/s | United States
         ⠏ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ • --:-- • Parsing streams...


     Widevine(AAAAVnBzc2gAAAAA7e+LqXnWSs6jyCfc1R0h7QAAADYIARIQB1oxzyEKT...)
     └── 075a31cf210a4e0fac141dfe26668cce:f0c5249ab18ae2e12c4affe509e218f7*
         from drmlab HTTPAPI




     ❌ Download Failed...
        Output directory does not exist: Temp\Video_1710c6ed.mp4_segments
        An unexpected error occurred in one of the download workers.
        See the error trace above for more information.

The Temp directory is there.
The other download workers work fine.
So scratching my head trying to resolve this.

Any suggestions?

Back a page or two iamghost posted a link to the binaries needed for Unshackle. Maybe you have not got the correct version of N_m3u8DL-RE installed. It is good you have everything else working in Unshackle. Don't give up you will probably get some help figuring this out.

[video166]

Is anyone able to help? Im getting an error when trying to run unshackle I have my own wvd keys locally so not sure why its trying to use remotecdm can provide any info if anyone has any ideas thanks:

Traceback (most recent call last):
File "<frozen runpy>", line 198, in _run_module_as_main
File "<frozen runpy>", line 88, in _run_code
File "C:\unshackle\.venv\Scripts\unshackle.exe\__main__ .py", line 4, in <module>
main()
^^^^^^^^^^^
File "C:\unshackle\unshackle\core\__main__.py", line 14, in <module>
from unshackle.core.commands import Commands
File "C:\unshackle\unshackle\core\commands.py", line 12, in <module>
_MODULES = {path.stem: getattr(import_module_by_path(path), path.stem) for path in _COMMANDS}
^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "C:\unshackle\unshackle\core\utilities.py", line 113, in import_module_by_path
spec.loader.exec_module(module)
File "C:\unshackle\unshackle\commands\dl.py", line 47, in <module>
from unshackle.core.cdm import CustomRemoteCDM, DecryptLabsRemoteCDM
ImportError: cannot import name 'CustomRemoteCDM' from 'unshackle.core.cdm' (C:\unshackle\unshackle\core\cdm\__init__.py)

[iamghost]

uv run unshackle env info
it can show you where WVDs folder location,
or add in yaml WVDs copy paste wvds folder path and save

[bbbbbb1717]

Hi guys Im having a problem with downloading dsnp

License request failed: 400 Client Error: Bad Request for url:             
     https://disney.playback.edge.bamgrid.com/playready/v1/obtain-license.asmx

Im not sure if it's because im using a revoked sl3000.prd and have no idea how to fill the config.yaml

still using the default config.yaml

certificate: |
  CAUSugUKtAIIAxIQbj3s4jO5oUyWjDWqjfr9WRjA2afZBSKOAjCCAQoCggEBALhKWfnyA+FGn5P3tl6ffDjoGq2Oq86hKGl6aZIaGaF7XHPO5mIk7Q35ml
  ZIgg1A458Udb4eXRws1n+kJFqtZXCY5S1yElLP0Om1WQsoEY2stpl+PZTGnVv/CsOJGKQ8K4KMr7rKjZem9lA9BrBoxgfXY3tbwlnSf3wTEohyANb5Qfpa
  xsU4v8tQDA8PcjzzV9ICodl6crcFZhAy4QMNXfbWOv/ZrGFx5blSXrzP1sMQ64IY8bjUYw4coZM34NDhu8aCA692g8k2mTz2494x7u3Is8v7RKC9ZNiETE
  K5/4oeVclXPpelNQokR4uvggnCD1L2EULG/pp6wnk1yWNNLxcCAwEAAToHYmFtdGVjaBKAA2FqHlqkE7EUmdOLiCi0hy5jRgBDJrU1CWNHfH6r2i6s5T5k
  6LK7ZfD65Tv6uyqq1k82PsDz4++kxbpfJDZaypFbae4XPc6lZxRCc5X0toX/x9TftOQQ4N82l5Hxoha569EPRkrnNy7rO7xrRILa3ZVj1alttEnEEjxEuw
  SV8usdlUg8/LvLA2C59T/HA2I77k7yVbTrVdy0f81r2l+E2SslivCy1JD3xKlgoaKl4xBnRxItWt8+DCw1Xm2lemYl2LGoh1Wk9gvlXQvr2Jv2+dFX3RNs
  i5sd00KS9sePszfjoTkQ6fmpRd7ZgFCGFWYB9JZ92aGUFQRE14OTST2uwSf32YCfsoATDNs4V6dB8YDoTGKFGrcoc4gtHPKySGNt7z/fOW4/01ZGzKqoVY
  Fp3jPq7R0qyt5P6fU5NshbLh5VKcnQvwg62BuKsdwV9u4NV36b2a546hGRl/GBneQ+QDA7NRrgITR33Sz02Oq8yJr3sy24GfZRTbtLJ4qiWkjtw==

## config ( {configVersion}/{clientId}/{deviceFamily}/{sdkVersion}/{applicationRuntime}/{deviceProfile}/{environment} ) ##
# Browser (windows, chrome) : /browser/v34.2/windows/chrome/prod.json
# Android Phone : /android/v15.0.0/google/handset/prod.json
# Android TV : /android/v15.0.0/google/tv/prod.json
# Amazon Fire TV : /android/v15.0.0/amazon/tv/prod.json

endpoints:
  config: "https://client-sdk-configs.bamgrid.com/bam-sdk/v7.0/disney-svod-3d9324fc/android/v15.0.0/google/tv/prod.json"

## user_agent (okhttp/5.0.0-alpha.14) ##
# android-phone : BAMSDK/v15.0.1 (disney-svod-3d9324fc 4.21.1+rc3-2026.01.06.0; v7.0/v15.0.0; android; phone)
# android-tv : BAMSDK/v15.0.1 (disney-svod-3d9324fc 4.21.1+rc3-2026.01.06.0; v7.0/v15.0.0; android; tv)

## api_key ##
# browser : ZGlzbmV5JmJyb3dzZXImMS4wLjA.Cu56AgSfBTDag5NiRA81oLHkDZfu5L3CKadnefEAY84
# android : ZGlzbmV5JmFuZHJvaWQmMS4wLjA.bkeb0m230uUhv8qrAXuNu39tbE_mD5EEhM_NAcohjyA

## yp_service_id ##
# browser : 63626081279ebe65eb50fb54
# android : 624b805dafc5c73635b1a216

bamsdk:
  sdk_version: "15.0.1"
  application_version: "4.21.1+rc3-2026.01.06.0"
  explore_version: "v1.13"
  client: "disney-svod-3d9324fc"
  user_agent: "BAMSDK/v15.0.1 (disney-svod-3d9324fc 4.21.1+rc3-2026.01.06.0; v7.0/v15.0.0; android; tv)"
  api_key: "ZGlzbmV5JmFuZHJvaWQmMS4wLjA.bkeb0m230uUhv8qrAXuNu39tbE_mD5EEhM_NAcohjyA"
  yp_service_id: "624b805dafc5c73635b1a216"

device:
  family: "android"
  profile: "tv"
  platform: "android/google/tv" # {deviceFamily}/{applicationRuntime}/{deviceProfile}
  platform_id: "android-tv"
  applicationRuntime: "android"
  operatingSystem: "Android"
  operatingSystemVersion: "16"
  deviceLanguage: "ko" # Device language data independent of account language data

# Specifies the index of the profile to use. (0 = first profile, 1 = second profile, etc.)
# Automatically select a profile when commenting.
profile:
   index: 2

[iamghost]

D+ is paid site so we cant talk on this forum

[kev043]

Hi Stabby, thanks for your continued support on the services, is there any chance you can add HMAX to your collection as I've been using your instructions to edit the DSCP to make it work for HMAX.

Cheers for the help Stabby.

[Tom Saurus]

How does on configure the command line to get a certain audio to download when you have multiple ones to chose from and multiple language? Also specify to just get English subtitles and avoid getting other language subtitles? Thank you in advance.

I looked at the usage arguments for Devine and this works for me:

uv run unshackle dl --acodec DD --lang en -sl en -q 540 -w S01E01 SERVICE URL

[davebee]

So after using devine for the past year, i'm finally making the move to unshackle.
All working well except for downloads that use n_m3u8dl_re.

I keep getting this error:

     1 Video     └── [H.264, SDR] | en-US | 960x540 @ 1782 kb/s, 23.976 FPS
         ⠏ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ • --:-- • Parsing streams...
     1 Audio
     └── [AAC] | en-US | 2.0 | 130 kb/s | United States
         ⠏ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ • --:-- • Parsing streams...


     Widevine(AAAAVnBzc2gAAAAA7e+LqXnWSs6jyCfc1R0h7QAAADYIARIQB1oxzyEKT...)
     └── 075a31cf210a4e0fac141dfe26668cce:f0c5249ab18ae2e12c4affe509e218f7*
         from drmlab HTTPAPI




     ❌ Download Failed...
        Output directory does not exist: Temp\Video_1710c6ed.mp4_segments
        An unexpected error occurred in one of the download workers.
        See the error trace above for more information.

The Temp directory is there.
The other download workers work fine.
So scratching my head trying to resolve this.

Any suggestions?

Back a page or two iamghost posted a link to the binaries needed for Unshackle. Maybe you have not got the correct version of N_m3u8DL-RE installed. It is good you have everything else working in Unshackle. Don't give up you will probably get some help figuring this out.

I already had the right version (Ran Angela's tools downloader when setting up.)
Turns out it was a PATH issue as I also had an older version elsewhere that was interferring.
So found and replaced that and now all working.
Your suggestion made me look. So thanks for the advice.

[Tom Saurus]

So after using devine for the past year, i'm finally making the move to unshackle.
All working well except for downloads that use n_m3u8dl_re.

I keep getting this error:

     1 Video     └── [H.264, SDR] | en-US | 960x540 @ 1782 kb/s, 23.976 FPS
         ⠏ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ • --:-- • Parsing streams...
     1 Audio
     └── [AAC] | en-US | 2.0 | 130 kb/s | United States
         ⠏ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ • --:-- • Parsing streams...


     Widevine(AAAAVnBzc2gAAAAA7e+LqXnWSs6jyCfc1R0h7QAAADYIARIQB1oxzyEKT...)
     └── 075a31cf210a4e0fac141dfe26668cce:f0c5249ab18ae2e12c4affe509e218f7*
         from drmlab HTTPAPI




     ❌ Download Failed...
        Output directory does not exist: Temp\Video_1710c6ed.mp4_segments
        An unexpected error occurred in one of the download workers.
        See the error trace above for more information.

The Temp directory is there.
The other download workers work fine.
So scratching my head trying to resolve this.

Any suggestions?

Back a page or two iamghost posted a link to the binaries needed for Unshackle. Maybe you have not got the correct version of N_m3u8DL-RE installed. It is good you have everything else working in Unshackle. Don't give up you will probably get some help figuring this out.

I already had the right version (Ran Angela's tools downloader when setting up.)
Turns out it was a PATH issue as I also had an older version elsewhere that was interferring.
So found and replaced that and now all working.
Your suggestion made me look. So thanks for the advice.

It is nice to help as often I am the one asking for help; so it feels good to be of use to others when one can.

[JaxMedia]

Hey guys,

I am currently struggling with the whole local_storage situation with TVNZ. Any one able to give me a hand? Thanks in advance.

HTTPError: 401 Client Error: Unauthorized for url:
https://watch-cdn.edge-api.tvnz.co.nz/media/content/authorize

[PSXman_uk]

[Attachment 92203 - Click to enlarge]

Use this extension works in chrome or edge to export local storage

[JaxMedia]

Yeah, I have been using that extension.

[billybanana]

Yeah, I have been using that extension.

I exported my local storage file with a couple of different extensions and neither of them would work.

In the finish I did the manual thing and it worked fine. In your browser press F12 to go to Dev Tools, go to the Console tab, paste in the below and hit enter

Object.assign(document.createElement('a'), {
  href: URL.createObjectURL(new Blob([JSON.stringify({
    accessToken: localStorage.accessToken,
    refreshToken: localStorage.refreshToken,
    deviceref: localStorage.deviceref
  }, null, 2)])),
  download: 'local_storage.json'
}).click();

Also pays before you export:

Go to TVNZ site, log out, then log back in again. Then do the export.

And make sure you have a separate account for the script. Login to the website once with your new account - do your export, log out and never use that account again in the browser.

[JaxMedia]

Now I receive this error:

ConnectionError: Failed to get contact: {'GetContactResponseMessage':
{'failureMessage': [{'errorCode': 'eV2124', 'errorMessage': 'Invalid Session
Token'}], 'responseCode': '0'}}

Just to clarify:
1. VPN set to New Zealand
2. Log out of current account
3. Login and select profile
4. F12 > paste code into console
5. Log out of account, log in to different account
5. Put local_storage.json file into unshackle/Cache/TVNZ
6. Run command

[Tom Saurus]

I did a git pull to update to the new 5.0 version of Unshackle. It seemed to go fine and then I did the uv sync and that seemed to be fine. However when I do something with Unshackle it says it is version 4.0.0. I did another git pull and it says Unshackle is already up to date. The program seems to working fine. I was kind of concerned about updating as there was a line about ignore binaries and the binaries folder is my preferred way of running the programs that Unshackle uses. I also have to redo my TVNZ local storage cache as that is not working now but that probably has nothing to do with the update.

[mkjustuk]

Looks like version 5 got took back out for now:
https://github.com/unshackle-dl/unshackle/releases

[Tom Saurus]

Looks like version 5 got took back out for now:
https://github.com/unshackle-dl/unshackle/releases

Yes you are correct.

[phased]

I did a git pull to update to the new 5.0 version of Unshackle. It seemed to go fine and then I did the uv sync and that seemed to be fine. However when I do something with Unshackle it says it is version 4.0.0. I did another git pull and it says Unshackle is already up to date. The program seems to working fine. I was kind of concerned about updating as there was a line about ignore binaries and the binaries folder is my preferred way of running the programs that Unshackle uses. I also have to redo my TVNZ local storage cache as that is not working now but that probably has nothing to do with the update.

If you specifically 'need' v5 you can pull the dev branch from github. Currently git pull will fetch the main branch, so just tell git to change from main to dev with this:-

git branch -u origin/dev main

Then issue a 'git pull' and run 'uv sync' to fix the changes.

[Tom Saurus]

Thank you for this information. Maybe I better wait and see as he may be working out some kinks in Unshackle 5.0

[stabbedbybrick]

Some breaking changes have been made to the TVNZ service:

Instead of the previous way of exporting the local_storage to file and using that to auth, the script now uses the OTP flow to login. You set your credentials in the config like normal, enter the OTP code when prompted, and you're done. No need for browser interference at all, and you should be able to use a single account for everything without messing up any sessions.

After pulling the update, clear your cache and run the script. You should be good to go.

As always, read the notes for more info:

unshackle dl TVNZ --help

[iamghost]

..nevermind

[Shaorin]

Where can I download services files?

[Tom Saurus]

Where can I download services files?

A post on this page from stabbedbybrick has a link to the services at the bottom of the post called "smaller services for Unshackle". Click on that link. In the services folder in Unshackle you can right click and select open in terminal. You scroll down stabbedbybrick's webpage and notice there is a line there about git clone. You select that line of code and paste that into your terminal and it will download a folder of services.