1
0

README 3.5 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667
  1. === ABOUT ===
  2. stov is a program which allows you to subscribe to channels, playlists and search results on youtube. (More platforms may be implemented later) You don't need a youtube account for the program to work since it uses read-only access to the youtube API or retrieves the needed data using youtube-dl. You can for example run it as a cron job to automatically download your favourite videos.
  3. === USAGE ===
  4. see ./stov --help
  5. === DEPENDENCIES ===
  6. stov depends on the following software to be installed:
  7. * Python 2.7 or higher (python 3.x should work but is not officially supported, this is a release goal for 1.0)
  8. * youtube-dl (get it from http://rg3.github.com/youtube-dl/ if you don't have it yet, it is needed to download videos and also for the "no API"-mode)
  9. * lxml module for python
  10. === COPYING ===
  11. see LICENSE
  12. === CONFIGURATION ===
  13. By default, the configuration is defined in ~/stov/stov.json in the json format. A default config file is created for you when you run the program for the first time. The following parameters are currently available which you can alter manually:
  14. mailto: Recipient address used for notitifications
  15. mailfrom: Sender address used for notifications
  16. mailhost: Host name or ip address of the mail server which is used to send notifications
  17. auth_needed: Define if the smtp server need authentication (yes or no)
  18. user_name: User name to use for smtp authentication if defined
  19. password: Password to use for SMTP authentication
  20. youtube-dl: Path to the youtube-dl binary if not found automatically
  21. downloaddir: Path the downloaded videos are saved into
  22. database: File name to use for the database
  23. smtpport: Port used to connect to the mail server
  24. maxvideos: Maximum number of videos to retrieve from the youtube API for each subscription,
  25. default 25, maximum 50, reduce this parameter for better parsing performance
  26. notify: Define if you want to be notified via email about new episodes of your subscriptions,
  27. valid values: yes or no
  28. db_version: Database version (Do not change!)
  29. config_version: Configuration version (Do not change!)
  30. videocodec: Video codec used for downloaded videos (valid values: h264, webm or flv)
  31. maxresolution: Maximum resolution to use for downloaded videos, please note
  32. that not all codecs and resolutions might be available so a lower resolution
  33. or other codec might be used in these cases
  34. maxfails: Number of times the download of a video may fail until it is marked as failed
  35. and won't be tried again
  36. check_title: Define if stov should check the title of each video in a search or channel
  37. with search string subscription. This works around some deficits of the youtube
  38. API which sometimes also returns video completely unrelated to your search.
  39. Videos whose titles don't match the search string will be entirely ignored.
  40. valid values: yes or no
  41. use_api: Define if you want to use the Youtube Data API v2. If this is set to false,
  42. a fallback mode using youtube-dl will be used. This is generally much slower,
  43. so using the API is recommended. However Google will cease offering the API
  44. without authentication in the foreseable future, so using the fallback mode
  45. will be the only option then.
  46. === KNOWN ISSUES ===
  47. Currently none, contact me if you find any.
  48. === INSTALLATION ===
  49. You can just run the main file "stov" directly from this directory by calling
  50. it from the shell or with the python interpreter ("./stov" or "python stov").
  51. Furthermore, stov uses python distutils as default installation method. Just
  52. run "python setup.py install" to install it into your system. For further
  53. information an options run "python setup.py --help".