README.md

   1 # Declare
   2
   3 An Emacs interface to youtube-dl which is a fork of Christopher Wellons's version. It addes some
   4 features and improvement. Mainly it support multiple process downloading.
   5
   6 # A youtube-dl download manager for Emacs
   7
   8 This package manages a video download queue for [youtube-dl][yt], which
   9 serves as the back end. It manages a single youtube-dl subprocess,
  10 downloading one video at a time. New videos can be queued at any time.
  11
  12 The `youtube-dl` command queues a single URL for download. Failures are
  13 retried up to `youtube-dl-max-failures`. Items can be paused or set to
  14 download at a slower rate (`youtube-dl-slow-rate`).
  15
  16 The `youtube-dl-playlist` command queues an entire playlist, just as if
  17 you had individually queued each video on the playlist.
  18
  19 The `youtube-dl-list` command displays a list of all active video
  20 downloads. From this list, items under point can be canceled
  21 (<kbd>d</kbd>), paused (<kbd>p</kbd>), slowed (<kbd>s</kbd>), and have
  22 its priority adjusted (<kbd>[</kbd> and <kbd>]</kbd>).
  23
  24 ![](https://i.imgur.com/wDWNsMf.png)
  25
  26 ## Features
  27
  28 - support youtube-dl directly
  29 - [improved] display download status in table list view
  30 - two downloading model
  31   - single-process downloading queue
  32   - multiple-processes downloading
  33 - support download playlist
  34 - support download audio
  35 - support download subtitle
  36 - support pause/resume/delete/priority downloading
  37 - support specifying network proxy
  38 - downloading finished notifications
  39 - log output to buffer `" *youtube-dl log*"`
  40 - auto close download list window after finished all downloading
  41
  42 ## Limitations
  43
  44 To display the size and progress, this package relies on a specific
  45 output format from youtube-dl. Using an external downloader
  46 (`--external-downloader`) breaks this, as can mucking around too much
  47 with the command line switches (`youtube-dl-arguments`).
  48
  49 [yt]: https://rg3.github.io/youtube-dl/