svtplay-dl - Config

How to use configfile in svtplay-dl

commandline argument to svtplay-dl will override the values from the config. the script use yaml for the config.

Path to config

Current working directory

svtplay-dl.yaml

then it will check following

linux / macOS

it will check for the config in following order:

$XDG_CONFIG_HOME/svtplay-dl/svtplay.yaml
~/.config/svtplay-dl/svtplay-dl.yaml
~/.svtplay-dl.yaml

ex /home/johan/.svtplay-dl.yaml

Windows

You need to create the directory under the appdata folder

%APPDATA%\svtplay-dl\svtplay-dl.yaml

ex c:\users\johan\appdata\roaming\svtplay-dl\svtplay-dl.yaml

keywords

all_episodes: try to download all episodes. set to true to enable
all_last: get last NN episodes instead of all episodes: set to a number
chapters: set to true to enable. Get chapters and add it to the file
convert_subtitle_colors: converts the color information in subtitles, to tags . set to true to enable
cookies: A cookies to add to each HTTP request. (cookie1=value;cookie2=value2)
exclude: exclude videos with the WORD(s) in the filename. comma separated (eg kalle,anka)
filename: "{title}.s{season}e{episode}.{episodename}-{id}-{service}.{ext}" # you need " before and after the text string
flexibleq: allow given quality (as above) to differ by an amount
force_subtitle: download only subtitle if its used with subtitle
get_all_subtitles: download all available subtitles for the video. set to true to enable
get_raw_subtitles: also download the subtitles in their native format. set to true to enable
get_url: do not download any video, but instead print the URL. set to true to enable
http_headers: A header to add to each HTTP request (header1=value;header2=value2)
merge_subtitle: merge subtitle with video/audio file with corresponding ISO639-3 language code. set to true to enable
password: what password to use
path: output directory (ex /path/to/directory)
preferred: preferred download method (dash, hls or http)
format_preferred: choose the format you prefer (h264, h265, h264-51). –list-quality will show which format is available
proxy: Use the specified HTTP/HTTPS/SOCKS proxy.
quality: what quality it should download.
resolution: choose what video resolution to download e.g. 480,720,1080.
remux: set to true to enable
require_subtitle: download only if a subtitle is available. set to true to enable
silent: be less verbose. set to true to enable
silent_semi: only show a message when the file is downloaded. set to true to enable
ssl_verify: set to false if you dont want to verify the certificate
stream_prio: If two streams have the same quality, choose the one you prefer (dash,hls,http)
subfolder: sort downloaded files in subfolders. set to true to enable
subtitle: set to true to enable
thumbnail: download thumbnail from the site if available. set to true to enable
username: what username it should use
verbose: set to true to enable
only_audio: set to true to enable
only_video: set to true to enable
audio_language: Choose the language of the audio (it can override the default one), –list-quality to show which one to choose from
output_format: format you want resulting file in (mkv or mp4), mp4 is default
token: add a value for token
reverse_list: set to true for reverse download order

filename

{title}: the title of the show
{season}: the season number
{episode}: the episode number
{episodename}: episode name
{id}: the id number
{service}: service name
{ext}: the file extension

Example configs:

Simple

This will output all files to the folder ~/grejgrej/ in your home directory

default:
  path: ~/grejgrej

service

default:
  path: ~/grejgrej

service:
  dplay:
    username: [email protected]
    password: superHemligt

This will output all files to the folder ~/grejgrej/ in your home directory. if downloading a video from dplay. it will use [email protected] as username and superHemligt as password

default:
  path: ~/grejgrej

service:
  dplay:
    username: [email protected]
    password: superHemligt

Downloading a video from svtplay will save the file to /storage/video/svtplay, it will exclude every file with a or b or c in the name and if the quality is between 837 and 1837. it will write a filename without the id number in it.

default:
  path: ~/grejgrej

service:
  svtplay:
    path: /storage/video/svtplay
    exclude: a,b,c
    quality: 1337
    flexibleq: 500
    filename: "{title}.s{season}e{episode}.{episodename}-{service}.{ext}"

This will download all episodes with subtitles and audio merged in to the video, sort them in to subfolders within ~/svtplay-dl and finally write the file name without the service attached.

default:
    path: ~/svtplay-dl
    subtitle: true
    merge_subtitle: true
    all_episodes: true
    subfolder: true
    filename: "{title}.s{season}e{episode}.{episodename}.{ext}"