kevcui / soaper-dl

:tv: Soaper downloader: download TV series and movies in your terminal

soaper-dl

Download TV series and movies from Soaper in your terminal

Table of Contents

• Dependency
• Installation
• How to use
  • Usage
  • Example
• Disclaimer

Dependency

• curl
• jq
• pup
• fzf
• ffmpeg

How to use

Usage

Usage:
  ./soaper-dl.sh [-n <name>] [-p <path>] [-e <num1,num2,num3-num4...>] [-l] [-s] [-d]

Options:
  -n <name>               TV series or Movie name
  -p <path>               media path, e.g: /tv_XXXXXXXX.html
                          ingored when "-n" is enabled
  -e <num1,num3-num4...>  optional, episode number to download
                          e.g: episode number "3.2" means Season 3 Episode 2
                          multiple episode numbers seperated by ","
                          episode range using "-"
  -l                      optional, list video or subtitle link without downloading
  -s                      optional, download subtitle only
  -d                      enable debug mode
  -h | --help             display this help message

Example

• Search TV series or movies name and select the right one in fzf:

$ ./soaper-dl.sh -n 'game of'
  [/movie_mlkW68VGba.html][2023] The Game of Crowns: The Tudors
  [/movie_nXDEY29Dml.html][2023] Game of Love
  [/movie_LwD8MEPg9a.html][2023] Game of Deceit
  [/movie_zrYg3nbDL1.html][2022] A Game of Secrets
  [/movie_wY4GQ0Wgbe.html][2023] Game of Love
> [/tv_34OGB6G6Zl.html][2011-04-17] Game of Thrones

• If the media URI path is known, for instance, /tv_34OGB6G6Zl.html in the previous example is the path for Game of Thrones:

$ ./soaper-dl.sh -p /tv_34OGB6G6Zl.html
...
[2.1] 1.Winter is Coming
[2.2] 2.The Kingsroad
[2.3] 3.Lord Snow
[2.4] 4.Cripples, Bastards, and Broken Things
[2.5] 5.The Wolf and the Lion
[2.6] 6.A Golden Crown
[2.7] 7.You Win or You Die
[2.8] 8.The Pointy End
...
Which episode(s) to download:

• Download Friends S01E01:

$ ./soaper-dl.sh -p /tv_YxAgjOVGEL.html -e 1.1
[INFO] Downloading video 1.1...

The downloaded video will be present in the folder ~/<media_name>/

• Support batch downloads: download Friends S01E01 to S01E05:

$ ./soaper-dl.sh -p /tv_aTo2OTs.html -e 1.1,1.2,1.3,1.4,1.5
[INFO] Downloading video 1.1...
...
[INFO] Downloading video 1.2...
...
[INFO] Downloading video 1.3...
...
[INFO] Downloading video 1.4...
...
[INFO] Downloading video 1.5...
...

OR using episode range:

$ ./soaper-dl.sh -p /tv_aTo2OTs.html -e 1.1-1.5
[INFO] Downloading video 1.1...
...
[INFO] Downloading video 1.2...
...
[INFO] Downloading video 1.3...
...
[INFO] Downloading video 1.4...
...
[INFO] Downloading video 1.5...
...

⚠️ The range option only works when the season number is the same. To download episodes in different seasons, for example: ... -e 1.1-1.5,2.2-2.8,3.1-3.5

• Display only video link, used to pipe into mpv or other media player:

$ mpv "$(./soaper-dl.sh -p /tv_YxAgjOVGEL.html -e 1.1 -l)"

• Download subtitle only

./soaper-dl.sh -n 'game of thrones' -s

• Customize subtitle language

SOAPER_SUBTITLE_LANG=fr ./soaper-dl.sh -n 'game of thrones'

Disclaimer

The purpose of this script is to download TV series episodes and movies in order to watch them later in case when Internet is not available. Please do NOT copy or distribute downloaded materials to any third party. Watch them and delete them afterwards. Please use this script at your own responsibility.

---

soaper-dl's Issues

curl: (6)Could not resolve host: d3.wewon.to

Since two days ago, any download requests fail with the error message from the title. Downloading from soap2day with getting the links directly works fine...

windows

Dear developer
is it possible to have the same code in python
or some way to run it in windows
I have been trying to run it
or convert it to python using chat gpt
no success
I am a noob in coding

parse issue

Hi,
Can someone tell how to fix this.
parse error: Invalid numeric literal at line 2, column 14
[ERROR] Media not found!
[ERROR] Media not found! Missing option -n or -p ?

Thank you

TypeError: page._client.send is not a function

I just installed everythhinng annd got thhis, Any tips, on windows?

Can you add this site as well?

A site with good content

https://swatchseries.ru

parse error: Invalid numeric literal at line 2, column 6

I noticed that script seems to be broken now. It could be they changed something at the site because direct browsing still works for me.

It looks like the following line is throwing the "parse error: Invalid numeric literal at line 2, column 6"

el="$($_JQ -r '.val' <<< "$d")"

The HTML code below is what it is trying to parse.

`

	<div class="content">
		<div class="container">
			<br>
			<div class="row">

				<div  style="width:50%;margin:0 auto">
					
					<div class="panel panel-default">
			
						<div class="panel-heading">Sorry, An unexpected error has occurred. Please try again. <a href ="\">Go back home</a></div>
					
					</div>
				</div>
			</div>
		</div>
		
	</div>
	
	<footer>
		<div class="container">
		<div class="row">
		<div class="col-sm-12 text-center">
		<h5>copyright @ SOAP2DAY.com</h5>
		</div>
		</div>
		</div>
	</footer>
		
</body>

`

Not displaying porgress

Does anyone know how i can use this script to display the progress of downloading a episode. It only show when a subtitle is downloading but not when a video is downloading.

Parse Error

Getting a parse error: Invalid numeric literal at line 2, column 14 on Debian.

Running the script just does nothing

I'm on mac, and maybe I just installed the chrome thing wrong? I put it in the file and ran command -v chrome and nothing happened, and then I ran the script and nothing happened.

Downloads get stuck on "Fetching cookie"

It's just stuck on Fetching cookie. Running Ubuntu 21.04.

Cookie

I am keep getting [ERROR] Cannot get cookie. Try again later.

Can someone please help me with this.

Wait a few seconds for fetching cookie...

Hello, Can i run this on ubuntu VPS or is it for Windows? Sorry I am a newbie and trying to set up this amazing script. I tried running on ubunut and i am getting "Wait a few seconds for fetching cookie..." when I type ./soap2day-dl.sh -p /tv_aTo2Mjs.html and nothing happens.

Not working ?

Doesn't work because it's recaptcha

Multiple connection

How can you use the script to run multiple connections like IDM, to download faster than 500kbps.

Is the new soap2day update gonna affect the downloader?

The new screen that asks you to continue

media not found?

./soap2day-dl.sh: line 37: realpath: command not found
[INFO] Fetching cookie...
[ERROR] Media not found!

Broken

This is Broken

After installing all packages and running the script, nothing is outputted into the console

no errors, no warnings, nothing

just nothing, no feedback from the script

Media Not Found (Again)

Now that it works, Any show, even if it exists, shows media not found. Any tips??

Persistent cannot get cookie error

Command used: ./soap2day-dl.sh -n 'game of'

Curl error message

I am getting this error message. Does anyone know how to fix it?

curl (3) url using bad/illegal format or missing url

Media not found!

when I tried to use the script using the -n or -p parameters.

Can't download some episodes

I can't download some episodes of a TV series it shows error [ERROR] Wrong download link or episode not found!, But i can play those episodes in the website.

Request: Add the possibility to get subtitle link (instead of downloading) or a json output with all related links.

I would expect that when the options -s and -l are present then the answer should be the link of the subtitle instead of the link of the video.

Indeed, perhaps it is better to add some command line option --json (or simply '-j) to get all the information related to the episode: video link, links of all subtitles, etc. Indeed, when this software is run with the -d flag (for debugging) this "json" information is shown in the terminal.

Multi Episode Download Missing x.x0

Just noticed when using an episode download range the episodes ending in 0 are missing from the downloads. For example if you use -e 1.1-1.51 you will be missing 1.10,1.20,1.30,1.40,1.50. I have not been able to test if it makes a difference if the the last digit in the range is a 0 if it makes a difference (example 1.1-1.50).

Thanks!

Chrome error

Good Morning, I'm trying to use the script but i get chrome errors and i dont know how to install it since im using it on a machine with just command line. Is there any way i can install it without needing a GUI or a way to get it running on windows?

Wait's forever for cookie

Won't load.

External downloader

How can I use this script with a external downloader like aria2c.

Downloading more that 7 Episodes Error

Great work! I noticed something after I got this up and running on a Ubuntu laptop.

If you download more than 7 episode you get an error message stating:
parse error: Invalid numeric literal at line 1, column 10

Error downloading

There's some episodes that don't download correctly, I tried running with the bash -x ./soap2day-dl.sh -n halt and catch fire and when I paste the output URL on the browser code 404 appears.

My computer is an M1 MacBook Pro, that might have something to do with it.

Here's the output when I try to download multiple Devs episodes: