Freevine - A downloader for free streaming services (discontinued)

[stabbedbybrick]

There's not much I can do about it. The way they have these weird old soaps stored will cause issues. On ITV some episodes skip a number, and they have the Latest Episodes section loaded which causes some apparent duplicates. On STV, they don't use season numbering at all for this show. So it's either S00 or adding a made-up number.

It is possible that these shows are stored differently on a proper API endpoint (I doubt it), but I can't be bothered to look. I knew soaps were an issue, but I honestly didn't think the user base of this program and the audience of old soaps would ever overlap so I just let it be

[deccavox]

@stabbedbybrick not a problem mate. I just thought I'd mention it since you asked for any anomalies.
Incidently, they aren't old soaps, they're the up to date ones (still rubbish though, after all these years )

[sipho]

New update! (20231010)

You can now download episodes directly by URL (Pluto TV not yet supported):

python freevine.py EPISODE_URL
python freevine.py --quality EPISODE_URL
python freevine.py --info EPISODE_URL

Ch4 works with just the episode URL but I tried two Ch5 episodes from the 10th (yesterday) and neither worked. Had to use the 'old' method.

[deccavox]

Also, I'm afraid it fails miserably with:
py freevine.py -e s01e07 https://www.bbc.co.uk/iplayer/episodes/p0ggr8mb/the-firm

The other episodes are good. I suspect it's because S01E07 doesn't have subtitles at this point in time, the others do (typical BBC eh?).

Regarding sipho's post above. I'm happy to use the 'old' method because I cannot trust how the various sites classify series/episodes. I always do a -t url first to check.

[stabbedbybrick]

Ch4 works with just the episode URL but I tried two Ch5 episodes from the 10th (yesterday) and neither worked. Had to use the 'old' method.

This was because of a tired mistake on my part and will be easily fixed in the next update.

Also, I'm afraid it fails miserably with:
py freevine.py -e s01e07 https://www.bbc.co.uk/iplayer/episodes/p0ggr8mb/the-firm

The other episodes are good. I suspect it's because S01E07 doesn't have subtitles at this point in time, the others do (typical BBC eh?).

Regarding sipho's post above. I'm happy to use the 'old' method because I cannot trust how the various sites classify series/episodes. I always do a -t url first to check

You're correct that it fails because it can't find any subtitles. I was lazy and assumed they would always be there, which is not a good idea when it comes to these services. You should never assume anything.

As for methods, I'm always going to recommend the standard way. But being able to download single episodes by URL can come in handy for shows with odd labels.

[videosplash]

This seems like an awesome tool, but unfortunately I'm running into a few hurdles with it setup on WSL2.

I'm running into this error when trying to download something.

Traceback (most recent call last):
  File "/home/splash/freevine/services/channel4.py", line 307, in download
    subprocess.run(args, check=True)
  File "/usr/lib/python3.10/subprocess.py", line 503, in run
    with Popen(*popenargs, **kwargs) as process:
  File "/usr/lib/python3.10/subprocess.py", line 971, in __init__
    self._execute_child(args, executable, preexec_fn, close_fds,
  File "/usr/lib/python3.10/subprocess.py", line 1738, in _execute_child
    and os.path.dirname(executable)
  File "/usr/lib/python3.10/posixpath.py", line 152, in dirname
    p = os.fspath(p)
TypeError: expected str, bytes or os.PathLike object, not NoneType

During handling of the above exception, another exception occurred:

[stabbedbybrick]

@videosplash:

It looks like the path to N_m3u8DL-RE can't be found in your environment. Can you call on it outside of the script? You need to either have it in the Freevine folder or in PATH.

[videosplash]

I already had the binary in the freevine folder but adding it to PATH has resolved the issue. Thanks.

[stabbedbybrick]

Another day, another update! v0.5.7-beta (20231011)

ALL4/Channel4:
I've added the option to switch API endpoint from android to web. By default, this program is accessing the android assets in order to get those tasty 5000kbps+ 1080p streams, but in some cases the 1080p is completely missing from there while being available in the regular web stream. Now you can easily access either by switching the All4 client from "android" to "web" in services.yaml.

I've also corrected the issues with MY5 URLs and iPlayer's breakdown when subtitles are missing.

And I've improved the cleanup so that no unnecessary folders are created when using --info.

[sipho]

Nice one, thank you.

[bubblebaths]

Hey, thank you for the tool! Just had some problems trying my first download, I followed all the instructions but I'm stuck here. What am I doing wrong?
[Attachment 74322 - Click to enlarge]

[stabbedbybrick]

I'll need some more info. What command and title were you using?

[bubblebaths]

I'll need some more info. What command and title were you using?

I ran the command

python freevine.py https://www.ctv.ca/shows/children-ruin-everything/therapy-s3e1

[bubblebaths]

I tried running it again and I got hit with this this time:


[Attachment 74324 - Click to enlarge]

[stabbedbybrick]

That's the same issue @videosplash had a few posts up. Your environment can't find the path to N_m3u8DL-RE. You need to make sure it's in the proper path, either by adding to your systems PATH, or placing it in the Freevine folder. Adding it to PATH is highly recommended since it will be reachable globally, no matter what environment you're using.

[bubblebaths]

Sorry, I'm really new/bad at this.

I added it to both the folder and the path (on OS X, unzipped the .tar.gz file and placed it in both). Still running into the same issue, N_m3u8dl-re is just not being found.

[stabbedbybrick]

I have little experience with OSX, but assuming it's similar to Linux, try running this in the terminal:

echo $PATH

That should print out all locations that are currently in your path. Simply place the unpacked N_m3u8DL-RE inside one of those locations.

Then navigate to that location in your terminal and run this command to make the file executable:

chmod +x N_m3u8DL-RE

If all goes well, N_m3u8DL-RE should be able to run from anywhere on your system. If these commands don't work, you might need to google some OSX equivalents.

[bubblebaths]

It worked. Thank you!

[stabbedbybrick]

Great!

[Isotta]

Hello,
I'm trying to use this new script for ITV but I have some troubles.
Some months ago I've used your previous script for Channel 4 and it worked.
I've changed nothing on Python since then. I've tried to follow your instructions for this new script, I've a new fresh pair of CMD ready, but I got this result:

C:\Users\carlo\Documents\Try\Freevine mod>py freevine.py https://www.itv.com/watch/daily-mirror-pride-of-britain-awards-2023/L2604

11:57:51.611 INFO : Freevine v0.5.7-beta (20231011)

11:57:52.575 INFO : ITV
Traceback (most recent call last):
  File "C:\Users\carlo\AppData\Local\Programs\Python\Python311\Lib\site-packages\httpcore\_exceptions.py", line 10, in map_exceptions
    yield
  File "C:\Users\carlo\AppData\Local\Programs\Python\Python311\Lib\site-packages\httpcore\_backends\sync.py", line 28, in read
    return self._sock.recv(max_bytes)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\carlo\AppData\Local\Programs\Python\Python311\Lib\ssl.py", line 1296, in recv
    return self.read(buflen)
           ^^^^^^^^^^^^^^^^^
  File "C:\Users\carlo\AppData\Local\Programs\Python\Python311\Lib\ssl.py", line 1169, in read
    return self._sslobj.read(len)
           ^^^^^^^^^^^^^^^^^^^^^^
TimeoutError: The read operation timed out

The above exception was the direct cause of the following exception:

Traceback (most recent call last):
  File "C:\Users\carlo\AppData\Local\Programs\Python\Python311\Lib\site-packages\httpx\_transports\default.py", line 60, in map_httpcore_exceptions
    yield
  File "C:\Users\carlo\AppData\Local\Programs\Python\Python311\Lib\site-packages\httpx\_transports\default.py", line 218, in handle_request
    resp = self._pool.handle_request(req)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\carlo\AppData\Local\Programs\Python\Python311\Lib\site-packages\httpcore\_sync\connection_pool.py", line 262, in handle_request
    raise exc
  File "C:\Users\carlo\AppData\Local\Programs\Python\Python311\Lib\site-packages\httpcore\_sync\connection_pool.py", line 245, in handle_request
    response = connection.handle_request(request)
               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\carlo\AppData\Local\Programs\Python\Python311\Lib\site-packages\httpcore\_sync\connection.py", line 96, in handle_request
    return self._connection.handle_request(request)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\carlo\AppData\Local\Programs\Python\Python311\Lib\site-packages\httpcore\_sync\http11.py", line 121, in handle_request
    raise exc
  File "C:\Users\carlo\AppData\Local\Programs\Python\Python311\Lib\site-packages\httpcore\_sync\http11.py", line 99, inhandle_request
    ) = self._receive_response_headers(**kwargs)
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\carlo\AppData\Local\Programs\Python\Python311\Lib\site-packages\httpcore\_sync\http11.py", line 164, in _receive_response_headers
    event = self._receive_event(timeout=timeout)
            ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\carlo\AppData\Local\Programs\Python\Python311\Lib\site-packages\httpcore\_sync\http11.py", line 200, in _receive_event
    data = self._network_stream.read(
           ^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\carlo\AppData\Local\Programs\Python\Python311\Lib\site-packages\httpcore\_backends\sync.py", line 26, in read
    with map_exceptions(exc_map):
  File "C:\Users\carlo\AppData\Local\Programs\Python\Python311\Lib\contextlib.py", line 155, in __exit__
    self.gen.throw(typ, value, traceback)
  File "C:\Users\carlo\AppData\Local\Programs\Python\Python311\Lib\site-packages\httpcore\_exceptions.py", line 14, in map_exceptions
    raise to_exc(exc) from exc
httpcore.ReadTimeout: The read operation timed out

The above exception was the direct cause of the following exception:

Traceback (most recent call last):
  File "C:\Users\carlo\Documents\Decriptare\Freevine mod\freevine.py", line 42, in <module>
    main()
  File "C:\Users\carlo\AppData\Local\Programs\Python\Python311\Lib\site-packages\click\core.py", line 1157, in __call__
    return self.main(*args, **kwargs)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\carlo\AppData\Local\Programs\Python\Python311\Lib\site-packages\click\core.py", line 1078, in main
    rv = self.invoke(ctx)
         ^^^^^^^^^^^^^^^^
  File "C:\Users\carlo\AppData\Local\Programs\Python\Python311\Lib\site-packages\click\core.py", line 1434, in invoke
    return ctx.invoke(self.callback, **ctx.params)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\carlo\AppData\Local\Programs\Python\Python311\Lib\site-packages\click\core.py", line 783, in invoke
    return __callback(*args, **kwargs)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\carlo\Documents\Decriptare\Freevine mod\freevine.py", line 36, in main
    Service(config, srvc, **kwargs)
  File "C:\Users\carlo\Documents\Decriptare\Freevine mod\services\itv.py", line 43, in __init__
    self.get_options()
  File "C:\Users\carlo\Documents\Decriptare\Freevine mod\services\itv.py", line 220, in get_options
    downloads, title = self.get_episode_from_url(self.url)
                       ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\carlo\Documents\Decriptare\Freevine mod\services\itv.py", line 192, in get_episode_from_url
    data = self.get_data(url)
           ^^^^^^^^^^^^^^^^^^
  File "C:\Users\carlo\Documents\Decriptare\Freevine mod\services\itv.py", line 46, in get_data
    soup = BeautifulSoup(self.client.get(url), "html.parser")
                         ^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\carlo\AppData\Local\Programs\Python\Python311\Lib\site-packages\httpx\_client.py", line 1041, in get
    return self.request(
           ^^^^^^^^^^^^^
  File "C:\Users\carlo\AppData\Local\Programs\Python\Python311\Lib\site-packages\httpx\_client.py", line 814, in request
    return self.send(request, auth=auth, follow_redirects=follow_redirects)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\carlo\AppData\Local\Programs\Python\Python311\Lib\site-packages\httpx\_client.py", line 901, in send
    response = self._send_handling_auth(
               ^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\carlo\AppData\Local\Programs\Python\Python311\Lib\site-packages\httpx\_client.py", line 929, in _send_handling_auth
    response = self._send_handling_redirects(
               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\carlo\AppData\Local\Programs\Python\Python311\Lib\site-packages\httpx\_client.py", line 966, in _send_handling_redirects
    response = self._send_single_request(request)
               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\carlo\AppData\Local\Programs\Python\Python311\Lib\site-packages\httpx\_client.py", line 1002, in _send_single_request
    response = transport.handle_request(request)
               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\carlo\AppData\Local\Programs\Python\Python311\Lib\site-packages\httpx\_transports\default.py", line 217, in handle_request
    with map_httpcore_exceptions():
  File "C:\Users\carlo\AppData\Local\Programs\Python\Python311\Lib\contextlib.py", line 155, in __exit__
    self.gen.throw(typ, value, traceback)
  File "C:\Users\carlo\AppData\Local\Programs\Python\Python311\Lib\site-packages\httpx\_transports\default.py", line 77, in map_httpcore_exceptions
    raise mapped_exc(message) from exc
httpx.ReadTimeout: The read operation timed out

I don't understand what I'm doing wrong.

[iamghost]

python freevine.py --help (READ THIS!)

Examples:
python freevine.py --titles URL
python freevine.py --info --episode S01E01 URL
python freevine.py --episode S01E01 URL
python freevine.py --episode S01E01-S01E10 URL
python freevine.py --episode S01E01,S03E12,S05E03 URL
python freevine.py --season S01,S03,S05 URL
python freevine.py --quality 720p --season S01 URL
python freevine.py --remote --season S01 URL

[barry25]

hi Does this software Freevine work for sites like uktvplay site and channel 4 and channel 5 sites thoses sites are free sites but i think they use some type of drm would this software work for thoses sites

i can get the video links off the sites for some shows but i dont know of anyway to download programs from thoses sites

and also does this software work with bbciplayer and itv x and stv player sites

[ElCap]

hi Does this software Freevine work for sites like uktvplay site and channel 4 and channel 5 sites thoses sites are free sites but i think they use some type of drm would this software work for thoses sites

i can get the video links off the sites for some shows but i dont know of anyway to download programs from thoses sites

and also does this software work with bbciplayer and itv x and stv player sites

What?

[sipho]

hi Does this software Freevine work for sites like uktvplay site and channel 4 and channel 5 sites thoses sites are free sites but i think they use some type of drm would this software work for thoses sites

i can get the video links off the sites for some shows but i dont know of anyway to download programs from thoses sites

and also does this software work with bbciplayer and itv x and stv player sites

What?

Just tell him no it doesn't.

[Isotta]

Okay, two words for my experience with ITV.
I've tried with downloading an episode from an 'actual' series and it worked.
But I was interested in a single episode of a tv show, so:

1) With this command I've learned that the code was S00E00

py freevine.py -t https://www.itv.com/watch/daily-mirror-pride-of-britain-awards-2023/L2604

10:50:49.308 INFO : Freevine v0.5.7-beta (20231011)

10:50:50.821 INFO : ITV
10:50:52.567 INFO : Pride of Britain Awards: 1 Season(s), 1 Episode(s)

10:50:52.568 INFO : Pride of Britain Awards S00E00 Daily Mirror Pride of Britain Awards 2023

2) And then with this command I was finally able to download it!

py freevine.py -e S00E00 https://www.itv.com/watch/daily-mirror-pride-of-britain-awards-2023/L2604

Thanks a million to iamghost for the hint, and to stabbedbybrick for this piece of gold.

[[ss]vegeta]

Marvelous job @stabbedbybrick
Bravo!
I applaud you and thank you in the name of everyone who never did.

[stabbedbybrick]

Thank you, vegeta! Appreciate it

-----------------------------------------------

New update! v0.5.8-beta (20231015)

Search option (beta):
I've added a function that'll let you search for titles on one or multiple services at once. The results will print title, type, synopsis(if available) and a usable URL for further downloading.
NOTE: Remember to wrap your keywords in quotes " " !

python freevine.py --search all4 "taskmaster"
python freevine.py --search itv,stv "payback"

Like always, no two services are alike so results will differ. Some don't have synopsis, and some don't even provide a proper path so I had build it.
You can search on as many services as you want at the same time, which is useful since many of these sites share content but differ in quality.

Right now it's set to display first 10 results if it's only one service, and 5 results per service if you search on multiple at the same time. Just to not completely flood the terminal.
And remember that some of these services geo block even the search function, so keep that in mind.

Screens:

[Attachment 74348 - Click to enlarge]

[Attachment 74349 - Click to enlarge]

[peterb999]

Thanks a lot, looks good.

[deccavox]

hi Does this software Freevine work for sites like uktvplay site and channel 4 and channel 5 sites thoses sites are free sites but i think they use some type of drm would this software work for thoses sites

i can get the video links off the sites for some shows but i dont know of anyway to download programs from thoses sites

and also does this software work with bbciplayer and itv x and stv player sites

For every post that the OP and grandmaster of this superb script makes (ie stabbedbybrick) you will see the github freevine link that answers all your questions and more. Have you actually looked at that link?

Also, as described, 'py freevine.py --help' is your (big) friend.

@stabbedbybrick. I've been away for a break for a week. I'm now back and there's two more updates to your script since then. Wow. There's just no stopping you lol.

Once again, many many thanks for your commitment and dedication.

PS. When will the script pour me a beer?

[liongtwap]

Hi, me as a subtitle uploader, just need subtitles, is it possible to download subtitles only from episodes / movies or maybe to download audio only...?
Thank you