File manual of Package svtplay-dl

.\" Manpage for svtplay-dl.
.\" Process this file with
.\"     groff -man -Tascii svtplay-dl.1
.\"     groff -man -Tutf8 svtplay-dl.1
.\"     man ./svtplay-dl.1
.\" Convert manpage to pdf with
.\"     man -Tpdf ./svtplay-dl.1 > svtplay-dl.1.pdf
.\"
.TH man 1 "01 Sep 2025" "1.0" "svtplay-dl man page"
.SH NAME
svtplay-dl \- download published videos
.SH SYNOPSIS
\fBsvtplay-dl\fR [\fIOPTION\fRs] [\fIURL\fRs]
.P
svtplay-dl --help
.P
svtplay-dl [-h] [--version] [-o \fIOUTPUT\fR] [--filename \fIFILENAME\fR] [--subfolder] [--config \fICONFIGFILE\fR] [-f] [-l] [-c \fICAPTURE_TIME\fR] [-s] [--silent-semi] [-u \fIUSERNAME\fR] [-p \fIPASSWORD\fR] [--token \fITOKEN\fR] [-t] [-g] [--get-only-episode-url] [--dont-verify-ssl-cert] [--http-header header1=\fIVALUE1\fR;header2=\fIVALUE2\fR] [--cookies cookie1=\fIVALUE1\fR;cookie2=\fIVALUE2\fR] [--exclude \fIWORD1,WORD2,...\fR] [--after-date \fIyyyy-MM-dd\fR] [--proxy proxy] [-v] [--nfo] [--force-nfo] [--only-audio] [--only-video] [--socket-timeout \fISECONDS\fR] [-q \fIQUALITY\fR] [-Q \fIAMOUNT\fR] [-P \fIPREFERRED\fR] [--list-quality] [--stream-priority \fIdash,hls,http\fR] [--format-preferred \fIh264,h264-51\fR] [--audio-language \fIAUDIO_LANGUAGE\fR] [--video-role \fIVIDEO_ROLE\fR] [--resolution \fIRESOLUTION\fR] [-S] [-M] [--force-subtitle] [--require-subtitle] [--all-subtitles] [--raw-subtitles] [--convert-subtitle-colors] [-A] [--all-last \fINUMBER\fR] [--include-clips] [-R] [--no-remux] [--no-merge] [--no-postprocess] [--keep-original] [--output-format \fI{mp4,mkv}\fR] [--chapters] [\fIURL\fRs]
.SH DESCRIPTION
svtplay-dl is an open source command-line program written in python. You can quickly download published videos from various sites to your local computer.
.SH OPTIONS
.TP
.B -S\fR, \fB--subtitle
Download subtitle with the media if available.
.TP
.B -S --force-subtitle
Download only subtitle.
.TP
.B -M\fR, \fB--merge-subtitle
Merge subtitle with video/audio file. Merge subtitle with video/audio file with corresponding ISO639-3 language code. Also saved separately if used with -S.
.TP
.B --require-subtitle
Download only if a subtitle is available.
.TP
.B --all-subtitles
Download all available subtitles for the video.
.TP
.B --raw-subtitles
Also download the subtitles in their native format.
.TP
.B --convert-subtitle-colors
Converts the color information in subtitles, to <font color=""> tags.
.TP
.B -A\fR, \fB--all-episodes
Try to download all episodes.
.TP
.B -A --all-last=\fINUMBER
Get last \fINUMBER\fR episodes instead of all episodes.
.TP
.B -A --include-clips
Include clips from websites.
.TP
.B --list-quality
View available qualities.
.TP
.B -P \fIDOWNLOAD_METHOD\fR \fB-q\fR \fIWANTED_BITRATE\fR \fB-Q\fR \fIMAX_BITRATE_DEVIATION\fR
Download other video quality.
.TP
.B -P \fIPREFERRED\fR, \fB--preferred=\fIPREFERRED\fR
Preferred download method.
.TP
\fB-q\fR \fIQUALITY\fR, \fB--quality=\fIQUALITY\fR
Choose what format to download. It will download the best format by default.
.TP
.B -Q \fIAMOUNT\fR, \fB--flexible-quality=\fIAMOUNT\fR
Allow given quality (as above) to differ by an amount.
.TP
.B --version
Show version information.
.TP
.B \fB-h\fR, \fB--help\fR
Show description of options.
.TP
.B -o \fIFILENAME\fR, \fB--output=\fIFILENAME\fR
Outputs to the given filename.
.TP
.B --subfolder
Create a subfolder titled as the show, non-series gets in folder movies.
.TP
.B --config configfile
Specify configuration file.
.TP
.B -f\fR, \fB--force
Overwrite the output file if it exists already.
.TP
.B -r\fR, \fB--resume
Resume a download.
.TP
.B -R\fR, \fB--reverse
Reverse download order.
.TP
.B -l\fR, \fB--live
Enable support for live streams. (rtmp based ones)
.TP
.B -c \fICAPTURE_TIME\fR, \fB--capture_time \fICAPTURE_TIME\fR
Define capture time in minutes of a live stream.
.TP
.B  -s\fR, \fB--silent
Be less verbose.
.TP
.B --silent-semi
Only show a message when the file is downloaded.
.TP
.B  -v\fR, \fB--verbose
Explain what is going on, including HTTP requests and other useful debugging data.
.TP
.B -u \fIUSERNAME\fR, \fB--username=\fIUSERNAME\fR
Username, if the service requires authentication.
.TP
.B -p \fIPASSWORD\fR, \fB--password=\fIPASSWORD\fR
Password, if the serivce requires authentication.
.TP
.B --token \fITOKEN\fR
.TP
.B -t\fR, \fB--thumbnail
Download thumbnail from the site if available.
.TP
.B --exclude=\fIWORD1,WORD2,...\fR
Exclude videos with the WORD(s) in the filename. Comma separated.
.TP
.B --after-date \fIyyyy-MM-dd\fR
Only videos published on or after this date.
.TP
.B --proxy proxy
Use the specified HTTP/HTTPS/SOCKS proxy. To enable experimental SOCKS proxy, specify a proper scheme. For example socks5://127.0.0.1:1080/.
.TP
.B --nfo
Create a NFO file.
.TP
.B --nfo --force-nfo
Download only NFO.
.TP
.B --only-audio
Only download audio if audio and video is seperated.
.TP
.B --only-video
Only download video if audio and video is seperated.
.TP
.B --socket-timeout \fISECONDS\fR
Time to wait before giving up in seconds.
.TP
.B  -g\fR, \fB--get-url
Do not download any video, but instead print the URL.
.TP
.B --get-only-episode-url
Do not get video URLs, only print the episode URL.
.TP
.B --dont-verify-ssl-cert
Don't attempt to verify SSL certificates.
.TP
.B --http-header=header1=\fIvalue\fR;header2=\fIvalue2\fR
A header to add to each HTTP request.
.TP
.B --stream-priority=\fIdash,hls,hds,http,rtmp\fR
If two streams have the same quality, choose the one you prefer.
.TP
.B --format-preferred \fIh264,h264-51\fR
Choose the format you prefer, --list-quality to show which one to choose from.
.TP
.B --audio-language \fIAUDIO_LANGUAGE\fR
Choose the language of the audio (it can override the default one), --list-quality to show which one to choose from.
.TP
.B --video-role \fIVIDEO_ROLE\fR
Choose the role of the video (it can override the default one), --list-quality to show which one to choose from.
.TP
.B --resolution \fIRESOLUTION\fR
Choose what video resolution to download e.g. 480,720,1080 comma seperated.
.TP
.B --remux
Remux from one container to mp4 using ffmpeg or avconv.
.TP
.B --no-remux
Do not automatically remux to mp4.
.TP
.B --no-merge
Do not automatically merge video, audio and possibly also subtitle(s) together.
.TP
.B --no-postprocess
Do not postprocess anything.
.TP
.B --keep-original
Do postprocessing while also keeping original files.
.TP
.B --output-format {\fImp4\fR,\fImkv\fR}
format you want resulting file in (mkv or mp4), mp4 is default
.TP
.B --chapters
Get chapters and add it to the file.
.SH EXAMPLES
.TP
.B
svtplay-dl \fIhttps://url.to.video.page/season-1/episode-1
Download the first episode of the series.
.TP
.B
svtplay-dl -S \fIhttps://url.to.video.page/cooking/2287193
Download one cooking episode with subtitles
.TP
.B
svtplay-dl -S -A \fIhttps://url.to.video.page/season1
Download all episodes and subtitles.
.TP
.B svtplay-dl -P \fIhls \fB-q \fI988  \fB-Q \fI100 https://url.to.video.page/
The above example would look for HLS Video with a bitrate between 888 and 1088 and take the one closest to 988.
.SH POST PROCESSING
.TP
.B
ffmpeg -i \fIvideo.file.ts \fB-i \fIsubtitle.file.srt \fB-metadata:s:a:0 language=\fIeng \fB-metadata:s:s:0 language=\fIswe \fB-c copy \fIoutfile.mkv
.SH SEE ALSO
.UR https://svtplay-dl.se/usage/
https://svtplay-dl.se/usage/
.UE
.P
.UR https://github.com/spaam/svtplay-dl/blob/master/svtplay-dl.pod
https://github.com/spaam/svtplay-dl/blob/master/svtplay-dl.pod
.UE
.SH BUGS
Might need occasional software fix or update to fix download errors.
.SH AUTHOR
nobody (noreply@nodomain.org)