evdh
v0.0.2-1.npm
Published
evdh : EisF Video Download Helper, auto download videos on web pages.
Downloads
8
Maintainers
Readme
:: README.md for evdh (version 0.1.9.0 test201502211209 (public npm version)
evdh : EisF Video Download Helper
author sceext
[email protected] 2009EisF2015
, 2015.02
copyright 2015 sceext All rights reserved.
evdh is used to AUTO download videos on webpages (such as youku) with the analyse service provided by flv.cn (Download evdh) (Features of evdh) (test info)
flv.cn can analyse the URL of video playing web pages, and give the URLs of video files to download. (for example: videos of Youku can be downloaded by this way) But when it comes to videos cut in several parts, it can be painful to download each part of video files one by one by hand.
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 npm version of evdh. (public npm version) branch version-npm
NOTE: The current evdh npm version is NOT ready to be used by other npm modules! It is just a tool used by human to auto download videos.
INSTALL
Please use npm
evdh is an AUTO download tool used in node.js. Please use npm to install evdh. https://www.npmjs.com/package/evdh
If you do not use npm, you can try other ways to Download evdh.
Software Dependence
evdh depends on these softwares:
- RECOMMEND:
ffmpeg
After installed these softwares can you use the functions of evdh entirely.
On ArchLinux you can use
pacman
to install the softwares:$ sudo pacman -S ffmpeg
- On Debian/Ubuntu please use
apt-get
- On Fedora/Redhat please use
yum
to install the softwares.
Or to install them from the official websites:
- official website of ffmpeg: http://www.ffmpeg.org/
- RECOMMEND:
Description of Software Dependence
node.js evdh uses node.js as the runtime environment.
xmldom (a module on npm) evdh uses xmldom to process xml.
ffmpeg evdh uses ffmpeg to merge video part files. Without ffmpeg, you can not use the "AUTO merge part video files" function of evdh.
CONFIGURE
The default config file is etc/evdh.conf.xml
Please edit it to your own needs.
About token
evdh uses the Web API of [flv.cn] http://flv.cn/ (api.flvxz.com)
You can try to get a token for free from http://flv.cn/docs.php?doc=api
NOTE: Please notice that the token is very important for you. When using the URL analyse service of flv.cn, the token is used to identity yourself. So please be careful to prevent the token be used by others.
The token is stored in a separate file to protect your own private token. You can change the location of the token file in config file.
Default token file is etc/private/token
You should write your own token in such file before use evdh to download videos.
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 this to get help:
$ ./evdh.sh --help evdh : EisF Video Download Helper Usage: evdh evdh [OPTIONS] ... Options: none just use "evdh" without any command line arguments will start evdh in "normal" mode, which runs interactively --url <url> start evdh in "auto_url" mode in this mode, evdh will auto download files, and do not ask user to confirm --continue start evdh in "auto_continue" mode in this mode, evdh will auto continue unfinished task, do not ask user to confirm --list-file <file> You can let evdh auto download many URLs in this "task_list" mode. URLs is writen in <file>, one in a line --help Show this help information --version Show evdh version information NOTE: evdh is used to help download videos on website. The URL inputed in evdh is the url of the video playing web page. evdh will auto analyse the url by "api.flvxz.com", and get URLs of video part files, and auto download them all, and auto merge part videos in a whole one with "ffmpeg".
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 <[email protected]> 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 npm version of evdh. (public npm version) branch version-npm
https://github.com/sceext2/evdh/tree/version-npm
https://www.npmjs.com/package/evdh
evdh also has these versions
中文版
(public zh-cn version) branch version-zh-cn
https://github.com/sceext2/evdh/tree/version-zh-cnEnglish version
(public version) branch version
https://github.com/sceext2/evdh/tree/versionwindows 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 npm version)
VERSION
current version 0.0.2-1.npm test201502211207 (public npm version) branch version-npm
version 0.0.2-1.npm test201502211207 (public npm version)
- update README.md for evdh npm version.
version v0.0.1 test201502202333 (public npm version)
- first npm version of evdh. Forked from
evdh public version
. (evdh version 0.1.5.0 test201502141915 (public version) branch version
)
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.
More information please see SHORTCOMING.md (o/SHORTCOMING.md)
TESTED
Test info of evdh English version (public version) branch version
evdh is now tested on ArchLinux
(2015.02)
evdh works fine on ArchLinux.
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 youku video download sohu video
with analyse service provided by flv.cn api.flvxz.com
:: end README.md