Unshackle - Modular Movie, TV, and Music Archival Software

[Tom Saurus]

[Attachment 91213 - Click to enlarge]

Update to match upstream

git pull
uv sync

Thank you for your terrific program and for updating it.

[Tom Saurus]

Thank you to the person who updated Unshackle for maintaining this program and updating it.

I have Windscribe but it is part of my Eset Anti Virus Package and thus I don't think I can configure Unshackle or Envied to use it as a Proxy. I keep looking for Nord VPN to come on sale at a really low price at Best Buy Canada and I am kicking myself I didn't snatch it up when it was down to about thirty bucks per year on Boxing Day or Black Friday. It would be nice to get the BBC to work with Unshackle and or Envied but thankfully YT-DLP interface as long as I get the m3u8 I can set it up to batch download so there is that. So all and all it takes more work but you get there eventually.

[kev043]

[Attachment 91217 - Click to enlarge]

Seems to work fine using prd arcelik_smart_tv_optomax_nt_sl3000_2c98b555

check
shaka-packager.exe --version shaka-packager.exe version v2.6.1-634af65-release
N_m3u8DL-RE.exe --version 0.5.1+c1f6db5639397dde362c31b31eebd88c796c90da

Also git pull


[Attachment 91218 - Click to enlarge]

Thanks for the info PSXman, this is weird, I'm using the same versions of shaka-packager.exe --version shaka-packager.exe version v2.6.1-634af65-release
N_m3u8DL-RE.exe --version 0.5.1+c1f6db5639397dde362c31b31eebd88c796c90da as you are The only difference is my prd which has always worked fine, are you using the latest version of unshackle and services? also what version of python are you using? thanks for the help.

Update.... ah I've just figured it out I was using this version of N_m3u8DL-RE N_m3u8DL-RE_v0.5.1-beta_win-NT6.0-x86_20251029.zip that version was giving the error, this one works fine - N_m3u8DL-RE_v0.5.1-beta_win-x64_20251029 this one works okay

the strange thing is I'm sure they're the same version, I'll look into it more.

I just noticed I downloaded the wrong version by mistake, I needed this one - N_m3u8DL-RE_v0.5.1-beta_win-x64_20251029.zip

[A_n_g_e_l_a]

Envied to close:

A few months ago when unshackle emerged, a fork - called envied - which added a --select-titles option for downloading, was created.

At the time the unshackle boys felt there was no need for such an option in their release although it was offered.

Envied also added the logical step of providing ready-installed services and with minimal intervention to get everything running - and later binaries and-all were included as efficient install scripts for ease of use.

Envied tried to make life easier for people - especially the older folks here who sometimes get a little muddled with install instructions - by automating as much as possible.

Yesterday github-unshackle accepted and merged a Pull Request, from another author, that adds --select-titles to unshackle.

My main reason for maintaining the fork has now gone.

Envied - the stand-alone-version, that is - will remain up in the short term but will not be updated in the future. It will remain version 3.0.0 of unshackle

Envied will, however, continue to have a life within TwinVine for a while yet. TwinVine is a 3 minute install and has all the features of envied - services and binary-install scripts.

Think of this change as part of the plan. First came Vinefeeder providing a list of videos for devine to download; then envied became 'unshackle-with-extras'.

Finally each of those, vinefeeder and envied, were combined to become TwinVine.

Now the parts no longer need to be separate entities but the two still will exist.

In TwinVine either 'uv run vinefeeder or 'uv run envied' can start individual programs

All this will make my life much easier, without the need to duplicate my efforts in several github repositories. I can now concentrate my energy solely on TwinVine.

Happy Days!

[stuarta]

Just a quick response to this and apologies if it's not the place. I've just downloaded Twinvine and works excellent but is it possible to edit the envied.yml file to limit bitrates to 720p?

[A_n_g_e_l_a]

Just a quick response to this and apologies if it's not the place. I've just downloaded Twinvine and works excellent but is it possible to edit the envied.yml file to limit bitrates to 720p?

If its a vinefeeder service navigate to, for example, packages/vinefeeder/src/vinefeeder/services/BBC/config.yaml and edit the options line by adding -q 720 and save. Note other options can be chained here just like on the envied/unshackle command line.
Do that for each of the vinefeeder services. Do it once and everytime you use that service it will get 720p.

[Attachment 91258 - Click to enlarge]

When using envied directly uv run envied dl -q 720 itv https://www.itv.com/watch/the-fortune-hotel/10a5106 for example. Do it each time you use envied directly.

More generally, use the help available in the software uv run envied dl -?

[stuarta]

When using envied directly uv run envied dl -q 720 itv https://www.itv.com/watch/the-fortune-hotel/10a5106 for example. Do it each time you use envied directly.

Ah brilliant thank you that worked and thanks for the quick reply. I was trying to edit the yaml file to default it but couldn't get anything to work, is there a way to change the envied default?

[A_n_g_e_l_a]

When using envied directly uv run envied dl -q 720 itv https://www.itv.com/watch/the-fortune-hotel/10a5106 for example. Do it each time you use envied directly.

Ah brilliant thank you that worked and thanks for the quick reply. I was trying to edit the yaml file to default it but couldn't get anything to work, is there a way to change the envied default?

Probably.


[Attachment 91261 - Click to enlarge]
following that patten it would look to be

dl
  quality: 720

[stuarta]

didn't like that unfortunately

[A_n_g_e_l_a]

didn't like that unfortunately

Tried anything else?

Under dl, best:true is set. I expect you saw it and changed it as I did.

The command uv run envied dl -? shows

  -q, --quality QUALITY_LIST      Download Resolution(s), defaults to the best
                                  available resolution.

.. again, as I expect you already saw.

That means it is expecting a list - seems to be a bit crazy but it is what it is. A single integer for quality: fails for not being a list.
It seems presently you can only enter at least two items. But that will give you a download result you do not want.


[Attachment 91267 - Click to enlarge]

Setting quality in each service config.yaml for vinefeeder works well: is that not enough for you?

[stuarta]

That's really weird, I've tried the same as you but as soon as I add quality to that block it errors the same

dl:
best: false
sub_format: srt
downloads: 4
workers: 16
quality: 720

[A_n_g_e_l_a]

That's really weird, I've tried the same as you but as soon as I add quality to that block it errors the same

dl:
best: false
sub_format: srt
downloads: 4
workers: 16
quality: 720

That is an upstream error with unshackle. As I said, it is looking for a list - i.e two or more integers and errors out on a single int. I'll leave you to report it to unshackle. There have been lots of rapid changes to dl.py at unshackle recently, this was probably introduced.

[stuarta]

ok thanks, just thought it was odd that it's working for you but I can always manually edit the batch file

[iamghost]

if you need 720p
add unshackle.yaml

quality:
- 720p

     Service Config loaded
     Loaded 2/2 Vaults
     Loaded Widevine CDM: 4464 (L3)

  ────────────────────────────── Service: ALL4 ───────────────────────────────

     Service is not Geoblocked in your region
      + Using cached Tokens...
     Authenticated with Service

  ──────────────────── Series: Michael Jackson: The Trial ────────────────────

     1 seasons, S1(4)

  ───────── Michael Jackson: The Trial S01E01 Saving the King of Pop ─────────

     Request for WEB endpoint returned <Response [403]>

     1 Video
     └── [H.264, SDR] | en | 1280x720 @ 2302 kb/s, 25.000 FPS
          ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ • 00:00 • SKIPPED
     1 Audio
     └── [AAC] | en | 2.0 | 135 kb/s
          ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ • 00:00 • SKIPPED
     1 Subtitle
     └── [VTT] | en
          ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ • 00:00 • SKIPPED

[A_n_g_e_l_a]

if you need 720p
add unshackle.yaml

quality:
- 720p

OC! I'm going senile! p is confusing. It gets stripped; I wonder why it gets asked for?

[MASUMCHAUDHURY]

Can someone guide on how to install it on macOS particularly on M1 Mac with macOS 26.3?

[6UFBxcS]

Does anyone have a service for disneynow (free eps) or can help me create one? Not the same as DSNP.

Also, when downloading an entire season, if an episode does not have subs, it just errors out. Is there a way to tell it to ignore this and keep downloading the season?
This is the only thing I have set for subs:

dl:
best: true
sub_format: srt
downloads: 4
workers: 16
lang:
- en

[PSXman_uk]

if you want to ignore subs just do -ns

[A_n_g_e_l_a]

If in doubt read the feckin' manual - isn't that what they say?


[Attachment 91295 - Click to enlarge]

[6UFBxcS]

if you want to ignore subs just do -ns

I do want subs...that's not what I asked.

If in doubt read the feckin' manual - isn't that what they say?


[Attachment 91295 - Click to enlarge]

...I did "read the feckin' manual."

It says nothing about when downloading an entire season, and certain episodes don't have subtitles, it just errors out and halts the entire process.

[A_n_g_e_l_a]

It says nothing about when downloading an entire season, and certain episodes don't have subtitles, it just errors out and halts the entire process.

No software developer is going to plan for those errors of omission on the part of the provider - where would one stop?

Your only way is to download one episode at a time, and if it errors-out, add -ns to the command. That's not too onerous is it?
If you used TwinVine's vinefeeder (if its a UK service that is) - if it errored-out at least it would continue to the next download - not sure if unshackle does.

[Tom Saurus]

The CTV streaming app is being phased out and the TV shows and movies are going to Crave. So it may be wise to take a look at what is there now and archive while you can by getting whole series and seasons before they are gone. I have put it off as I thought there was lots of time but time marches on. There may be some what is classified as free shows and such going to Crave but how to detangle from paid if a service was to be made as stabbedbybrick services are not for premium content. I don't know if anything will be left for the ctv.ca website or not.

Update: There will be a free tiere on Crave for Throwback TV and CTV movies and you can sign up for a Bell Media Account.

[kriata]

None of the options that come up from --help are for disabling attachment downloading, so how can I do that?

[phased]

None of the options that come up from --help are for disabling attachment downloading, so how can I do that?

I am using envied but unshackle works the same way.

Help is stacked in sub menus. --help gives the top menu

uv run envied --help
Usage: envied [OPTIONS] COMMAND [ARGS]...

  unshackle—Modular Movie, TV, and Music Archival Software.

Options:
  -v, --version   Print version information.
  -d, --debug     Enable DEBUG level logs and JSON debug logging.
  -?, -h, --help  Show this message and exit.

Commands:
  cfg     Manage configuration values for the program and its services.
  dl      Download, Decrypt, and Mux tracks for titles from a Service.
  env     Manage and configure the project environment.
  kv      Manage and configure Key Vaults.
  prd     Manage creation of PRD (Playready Device) files.
  search  Search for titles from a Service.
  serve   Serve your Local Widevine/PlayReady Devices and REST API for Remote
          Access.
  util    Various helper scripts and programs.
  wvd     Manage configuration and creation of WVD (Widevine Device) files.

Select any one of those menu items, such as dl, and run

uv run envied dl --help
OR
uv run envied dl -?

Usage: envied dl [OPTIONS] COMMAND [ARGS]...

Options:
  -p, --profile TEXT              Profile to use for Credentials and Cookies
                                  (if available).
  -q, --quality QUALITY_LIST      Download Resolution(s), defaults to the best
                                  available resolution.
  -v, --vcodec [avc|h.264|hevc|h.265|vc1|vc-1|vp8|vp8|vp9|vp9|av1|av1]
                                  Video Codec to download, defaults to any
                                  codec.
  -a, --acodec AUDIO_CODEC_LIST   Audio Codec(s) to download (comma-
                                  separated), e.g., 'AAC,EC3'. Defaults to
                                  any.
  -vb, --vbitrate INTEGER         Video Bitrate to download (in kbps),
                                  defaults to highest available.
  -ab, --abitrate INTEGER         Audio Bitrate to download (in kbps),
                                  defaults to highest available.
  -r, --range [sdr|hlg|hdr10|hdr10p|dv|hybrid]
                                  Video Color Range(s) to download, defaults
                                  to SDR.
  -c, --channels FLOAT            Audio Channel(s) to download. Matches sub-
                                  channel layouts like 5.1 with 6.0
                                  implicitly.
  -naa, --noatmos                 Exclude Dolby Atmos audio tracks when
                                  selecting audio.
  --split-audio                   Create separate output files per audio codec
                                  instead of merging all audio.
  --select-titles                 Interactively select downloads from a list.
                                  Only use with Series to select Episodes
  -w, --wanted EP_RANGE           Wanted episodes, e.g. `S01-S05,S07`,
                                  `S01E01-S02E03`, `S02-S02E03`, e.t.c,
                                  defaults to all.
  -l, --lang LANG_RANGE           Language wanted for Video and Audio. Use
                                  'orig' to select the original language, e.g.
                                  'orig,en' for both original and English.
  --latest-episode                Download only the single most recent episode
                                  available.
  -vl, --v-lang LANG_RANGE        Language wanted for Video, you would use
                                  this if the video language doesn't match the
                                  audio.
  -al, --a-lang LANG_RANGE        Language wanted for Audio, overrides
                                  -l/--lang for audio tracks.
  -sl, --s-lang LANG_RANGE        Language wanted for Subtitles.
  --require-subs LANG_RANGE       Required subtitle languages. Downloads all
                                  subtitles only if these languages exist.
                                  Cannot be used with --s-lang.
  -fs, --forced-subs              Include forced subtitle tracks.
  --exact-lang                    Use exact language matching (no variants).
                                  With this flag, -l es-419 matches ONLY
                                  es-419, not es-ES or other variants.
  --proxy TEXT                    Proxy URI to use. If a 2-letter country is
                                  provided, it will try get a proxy from the
                                  config.
  --tag TEXT                      Set the Group Tag to be used, overriding the
                                  one in config if any.
  --tmdb INTEGER                  Use this TMDB ID for tagging instead of
                                  automatic lookup.
  --tmdb-name                     Rename titles using the name returned from
                                  TMDB lookup.
  --tmdb-year                     Use the release year from TMDB for naming
                                  and tagging.
  --sub-format [subrip|srt|substationalpha|ssa|substationalphav4|ass|timedtextmarkuplang|ttml|webvtt|vtt|sami|smi|microdvd|sub|mpl2|tmp|fttml|stpp|fvtt|wvtt]
                                  Set Output Subtitle Format, only converting
                                  if necessary.
  -V, --video-only                Only download video tracks.
  -A, --audio-only                Only download audio tracks.
  -S, --subs-only                 Only download subtitle tracks.
  -C, --chapters-only             Only download chapters.
  -ns, --no-subs                  Do not download subtitle tracks.
  -na, --no-audio                 Do not download audio tracks.
  -nc, --no-chapters              Do not download chapters tracks.
  -nv, --no-video                 Do not download video tracks.
  -ad, --audio-description        Download audio description tracks.
  --slow                          Add a 60-120 second delay between each Title
                                  download to act more like a real device.
                                  This is recommended if you are downloading
                                  high-risk titles or streams.
  --list                          Skip downloading and list available tracks
                                  and what tracks would have been downloaded.
  --list-titles                   Skip downloading, only list available titles
                                  that would have been downloaded.
  --skip-dl                       Skip downloading while still retrieving the
                                  decryption keys.
  --export PATH                   Export Decryption Keys as you obtain them to
                                  a JSON file.
  --cdm-only / --vaults-only      Only use CDM, or only use Key Vaults for
                                  retrieval of Decryption Keys.
  --no-proxy                      Force disable all proxy use.
  --no-folder                     Disable folder creation for TV Shows.
  --no-source                     Disable the source tag from the output file
                                  name and path.
  --no-mux                        Do not mux tracks into a container file.
  --workers INTEGER               Max workers/threads to download with per-
                                  track. Default depends on the downloader.
  --downloads INTEGER             Amount of tracks to download concurrently.
  --no-cache                      Bypass title cache for this download.
  --reset-cache                   Clear title cache before fetching.
  --best-available                Continue with best available quality if
                                  requested resolutions are not available.
  -?, -h, --help                  Show this message and exit.

(continues)

[sipho]

@stabbedbybrick

I was wondering if you are able to create an unshackle service for crave.ca please? It looks like a lot of content will not be available anymore on ctv.ca. The bellmedia login works across both sites which is helpful.

No rush of course.

Thanks.

[Tom Saurus]

@stabbedbybrick

I was wondering if you are able to create an unshackle service for crave.ca please? It looks like a lot of content will not be available anymore on ctv.ca. The bellmedia login works across both sites which is helpful.

No rush of course.

Thanks.

That certainly would be useful. But we must remember Crave has paid content as well and stabbedbybrick makes services for free services so he may chose not to make a Crave service.

[phased]

@stabbedbybrick

I was wondering if you are able to create an unshackle service for crave.ca please? It looks like a lot of content will not be available anymore on ctv.ca. The bellmedia login works across both sites which is helpful.

No rush of course.

Thanks.

Yeah, but how do you get a login without a Bell Telephone account? And doesn't twinvine have crave as a service already?

[sipho]

That certainly would be useful. But we must remember Crave has paid content as well and stabbedbybrick makes services for free services so he may chose not to make a Crave service.

All these sites have paid content. ITVX, ALL4, CTV etc.

[sipho]

Yeah, but how do you get a login without a Bell Telephone account? And doesn't twinvine have crave as a service already?

I think you can create a free login account via CBC GEM. All those sites use the same login details. Put it another way, the login I have for CBC works on Crave.

I will look at twinvine as I'm not currently using that, thanks.

[LastResort]

Good Evening everyone,...
I come cap in help requesting some advice please,...
I have completed the git pull and uv sync.. successfully from my vinefeeder folder.. but after running the gui I am met with the following:

Could not import service vinefeeder.services.PLEX: f-string: unmatched '(' (__init__.py, line 302)

Would it be possible for anyone to kindly explain how I can rectify the above. I am aware that this is not an error and I believe it is something that I need to add to possibly my yaml file. (there is also the possibility that I am also completely wrong).

A quick note,... I ventured into Twinvine/packages/envied/src/envied/services/PLEX I have one folder and two files.... an _init_.py and a config.yaml all i can see at line 302 is the following:

title=re.sub(r"\s*\(\d{4}\)", "", episode.get("grandparentTitle", "")),
# year=episode.get("year"),
data=episode,
)
]

(line 320 has the data=episode,)

looks like i have this totally wrong....