:: README.md for evdh (public version) last update at 2015-03-31 14:55 GMT+0800 CST

evdh : EisF Video Download Helper

author sceext sceext@foxmail.com 2009EisF2015, 2015.03
copyright 2015 sceext All rights reserved.

NOTE: This file will be updated for new evdh version 0.1.31.0 !

evdh is used to AUTO download videos on webpages. (such as sohu)
(Features of evdh) (test info)

evdh can auto download all parts of video files, and auto merge them. With the "task_list" mode, evdh can even auto download many videos.
With evdh, it will be much easier to download videos.

This is the English version of evdh. (public version) branch version

INSTALL

• Recommend to use GIT

  (Git is the best distributed version control system (without "one of the best").
  It is very convenient to download and upgrade evdh.

  • To download please use this command:

    $ git clone git@github.com:sceext2/evdh.git --depth 1 --branch version --single-branch

  • To upgrade please use this command:

    $ git pull

  If you do not use git, you have to Download and Upgrade evdh by hand.

• Software Dependence

  evdh depends on these softwares:

  • MUST INSTALL: nodejs xmldom
  • RECOMMEND: ffmpeg

  After installed these softwares can you use the functions of evdh partly or entirely.

  On ArchLinux you can use pacman to install the softwares:

  $ sudo pacman -S nodejs ffmpeg
$ npm install xmldom

  And use npm to install xmldom (third part module of node.js).

  Or to install them from the official websites:

  • official website of node.js: http://nodejs.org
  • official website of ffmpeg: http://www.ffmpeg.org/

CONFIGURE

The default config file is etc/evdh.conf.xml

Please edit it to your own needs.

RUN evdh

Please use evdh start shell script to start run evdh. You can use this command:

$ ./evdh.sh

This will start evdh interactively.

You can use $ ./evdh.sh --version to show version info of evdh.
Or you can use $ ./evdh.sh --help to get help.

This is FREE SOFTWARE

This is FREE SOFTWARE, released under GNU GPLv3+
please see LICENSE for more information.

   evdh : EisF Video Download Helper, auto download videos on web pages. 
   Copyright (C) 2015 sceext <sceext@foxmail.com> 

   This program is free software: you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation, either version 3 of the License, or
   (at your option) any later version.

   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with this program.  If not, see <http://www.gnu.org/licenses/>.

Other Branches

You can get evdh from https://github.com/sceext2/evdh
and get the source code of evdh at the same time.

This is the English version of evdh. (public version) branch version
https://github.com/sceext2/evdh/tree/version

evdh also has these versions

• 中文版 (public zh-cn version) branch version-zh-cn
  https://github.com/sceext2/evdh/tree/version-zh-cn

• windows version (public win version) branch version-win
  https://github.com/sceext2/evdh/tree/version-win

Or you can download evdh releases from
https://github.com/sceext2/evdh/releases

uuid mark for evdh

uuid mark for this program evdh is

uuid=1df11f80-183f-405f-b93c-4dff2ce08398 (public version)

VERSION

current version 0.1.5.0 test201502141915 (public version) (English version)

version 0.1.5.0 test201502141915 (public version)

• add "task_list" mode. Now evdh can auto download many urls. You can write many urls of video play pages in a file, for example a url.list file. Each url in one line. Then you can use $ ./evdh.sh --list-file url.list to auto download all urls in the list file.

• add command line arguments support. Previously, evdh can only run interactively. But now evdh has command line mode. You can use $ ./evdh.sh --version to show version info. Or use $ ./evdh.sh --help to show help info.

• auto select video by keywords. Previously, evdh can only select video by quality hd number. If there is more than one video, evdh has to ask user to select one. But now evdh can auto select one by keywords given by user in config file.

• auto retry after download failed. In "task_list" mode, if download failed, evdh will auto retry to download. Default retry times is 4.

• UI improve. Now new evdh ui looks better.

NOTE: in "task_list" mode, you can not break evdh or continue task after exit. This may be improved in further versions.

More Information

To get more information about version (include version history)
please see VERSION.md (o/VERSION.md)
Or https://github.com/sceext2/evdh/releases

FEATURES

evdh now has these features

• use flv.cn's service to analyse URL (api.flvxz.com)
  AUTO analyse the URL of video playing pages, and get the URL of part video files to download.

• AUTO download all part video files, and AUTO create the file name to save
  

• AUTO merge part video files
  evdh uses ffmpeg to AUTO merge part video files. There it merges videos without re-encoding. So it is very fast, and willnot hurt quality of video.

• [NEW] AUTO download many videos
  In "task_list" mode, evdh can AUTO download many videos. For example, write many URLs of video playing pages in the url.list file, each in a line.
  Then use the command $ ./evdh.sh --list-file url.list to AUTO download every videos in this list file.

• Continue the task not finished last time
  evdh has log file, supports resuming HTTP download, can continue to do the unfinished task last time when start.

• [NEW] AUTO mode and Interactive mode
  evdh has 2 kinds of modes, AUTO mode and Interactive mode. Use the command $ ./evdh.sh to start evdh in interactive mode. The usage of AUTO mode, please use $ ./evdh.sh --help to show it.

• [NEW] AUTO retry after download failed
  In "task_list" mode, if a download failed, evdh will AUTO retry to download. Default retry times is 4.

• AUTO select video
  Many videos can be got after analysing only one URL, with different video quality. evdh can AUTO select one of them to download.
  First, evdh will select video by the code of video quality (the "hd" number, which is provided by the analyse service of flv.cn), which can be set in config file.

  [NEW] Otherwise, in AUTO mode, evdh can AUTO select video by KEYWORDS. If there is more than one video selected with the hd number, in Interactive mode, evdh will ask user to select one. But in AUTO mode, evdh will not ask user, and AUTO select videos with keywords in the "quality string". (the "quality string" is provided by the analyse service of flv.cn) Keywords is writen in config file.

• Show download status and speed
  When downloading videos, evdh will show the information such as finished bytes, download speed.

• Multi-thread download
  Each part video file downloads with single thread, but many file can be downloaded at the same time. So it is multi-thread download on the whole. Default number of thread is 2, which can be changed in config file.

• Download memory buffer
  Default size is 2MB (each file), which can be changed in config file. This is used to protect hard disk, to prevent write too often.

• Config file
  evdh has its own config file. token is stored in another file, which can help to protect the private token.

Shortcomings of evdh

Now evdh has some shortcomings, and some known BUGs.

(Sorry, this part has not been finished now. )

TESTED

Test info of evdh English version (public version) branch version

evdh is now tested on ArchLinux (2015.03)

• Sorry, evdh can not work now !!! Because the website flvxz.com can not be visited now, the current version of evdh can not work now.

• Known problems
  

  • Installing ffmpeg on Ubuntu 14.04 is not very easy.
    So the function "Auto merge part video files" has not been tested on Ubuntu 14.04.

NOTE: evdh is an auto download tool writen to run on GNU/Linux OS, with node.js.

About sceext and 2009EisF2015

sceext is my pen name. sceext reads as s-c-e-e-x-t.
sceext has no meaning, but only I use sceext on the Internet. (There is hardly no conflicts.)

EisF is the mark that I add to my programs.

EisF means EisF is EisF. EisF is a forked recursive acronym.
(Just like GNU = GNU's Not Unix) EisF = EisF is EisF ([E]isF [is] Eis[F])

2009EisF2015 means that the mark EisF has been used from year 2009 to now (year 2015).

keywords

evdh EisF Video Download Helper English version public version branch version

auto download videos

download videos easier download videos on web pages analyse videos on web pages

download sohu video

:: end README.md