stov/doc/configuration.rst

=============
CONFIGURATION
=============
CONFIGURATION
-------------

mailto:	recipient address used for notitifications

mailfrom:	sender address used for notifications

mailhost:	host name or ip address of the mail server which is used to send notifications

auth_needed:	define if the smtp server need authentication (yes or no)

user_name:	user name to use for smtp authentication if defined

password:	password to use for SMTP authentication

youtube-dl:	path to the youtube-dl binary if not found automatically

downloaddir:	path the downloaded videos are saved into

database:	file name to use for the database

smtpport:	port used to connect to the mail server

maxvideos:	maximum number of videos to retrieve from the youtube API for each subscription, default 25, maximum 50, reduce this parameter for better parsing performance

notify:	define if you want to be notified via email about new episodes of your subscriptions, valid values: yes or no

db_version:	database version (Do not change!)

config_version:	configuration version (Do not change!)

videocodec:	video codec used for downloaded videos (valid values: h264, webm or flv)

maxresolution:	maximum resolution to use for downloaded videos, please note that not all codecs and resolutions might be available so a lower resolution or other codec might be used in these cases

maxfails: 	number of times the download of a video may fail until it is marked as failed and won't be tried again

check_title:	define if stov should check the title of each video in a search or channel with search string subscription. This works around some deficits of the youtube API which sometimes also returns video completely unrelated to your search. Videos whose titles don't match the search string will be entirely ignored. valid values: yes or no

use_api: Define if you want to use the Youtube Data API v2. If this is set to false,
        a fallback mode using youtube-dl will be used. This is generally much slower,
        so using the API is recommended. However Google will cease offering the API 
        without authentication in the foreseable future, so using the fallback mode
        will be the only option then.