======================================
README of YouTubeDownloader2
======================================
This file is part of ytd2
ytd2 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.
ytd2 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 ytd2.
If not, see <http://www.gnu.org/licenses/>.
USAGE
YTD2 is for downloading videos as flv/mp4-files on your
computer.
The web-browser downloads webresources of youtube
(e.g. binary data) to a temporary folder before
displaying it. YTD2 does the same except You can choose
where to save the files.
The author is not responsible for downloading
videos that youtube refuses to show in your country.
Everybody is urged to check ownership of videos before
downloading!
FILES
The source code is available via subversion at
https://sourceforge.net/projects/ytd2/.
The repository contains either the latest released sources or
changes for the next upcoming release. There are no branches or
tags for now.
The jar-files/sources of the http-components can be downloaded at
http://hc.apache.org/downloads.cgi
INSTALL
There is no need to install it. YTD2 consists of just one
runnable file. Maybe there is an option of Java Web Start in the
future if javaw is able to use mirror server.
RUNNING
runytd2.jar should be executable via Java Runtime Environment
JRE 1.5 and later.
running ytd2 via command shell:
java -jar runytd2.jar
running ytd2 via file explorer:
just click on the jar-file (works if the file has execute file
permissions (on *ix platform) and JRE is a registered application
for jar-files)
CLI run (without GUI window)
If your linux-box runs in runlevel 5 you have to clear the environment
variable DISPLAY to use CLI-mode.
knoedel@section60:~/workspace$ unset DISPLAY
knoedel@section60:~/workspace$ java -jar runytd2.jar --help
V20120407_0955 by MrKnödelmann
Usage:
...
PROXY
You can set the proxy either before running ytd2 or after start via
input "proxy http://proxyhost:proxyport" with or without http://
example (on GNU/Linux) before start:
knoedel@section60:~/workspace$ http_proxy=http://localhost:3128
knoedel@section60:~/workspace$ java -jar runytd2.jar
example (on M$-Windows) before start:
c:\> set http_proxy=http://localhost:3128
c:\> java -jar runytd2.jar
example after start - type in as URL:
proxy http://localhost:3128
localhost:3128 is just an example (of a local squid-cache proxy)
TODO
- GUI option for proxy
- correct handling of directories for download (esp. on M$-Windows)
- submit login credentials or load cookies-file
- save configuration and load upon start
- port to Android
maybe: Java Web Start
Any hints, suggestions, features, questions .. are welcome!
CHANGES
V20150609
2015-06-09 bug fix, adding new video formats (<4k)
V20141013
2014-11-02 convert to Maven, moved source to trunk and created other branches, testing SonarQube
2014-10-24 bug fix regarding new video formats (audio&video in two streams)
V20140125
2014-01-24 changed to work with new webpage source code
added gui option to download 4k (ultra hd) videos
added nongui option to download audio file only
added context menu in textfield for paste&clear command
V20130910
2013-12-10 changed to work with new webpage source code
V20130506
2013-05-06 bug fix - no illegal characters in filenames
V20130224
2013-02-24 updated apache http core components
filename will be shown
bug fix regarding format selection
2013-02-23 webm is also selectable
2013-02-17 3D videos can be downloaded
youtube ID in filename
new config parameter "ID" to set ID in filename on/off
2013-02-15 UTF8 characters instead of HTML codes in filenames
V20121221
2012-12-20 changed to work with new webpage source code
more output if download did not work due to restrictions or unsupported protocol
V20121008
2012-10-09 bug fix regarding filename on m$-windows
V20120926
2012-10-07 bug fix regarding filename
2012-09-26 changed to work with new webpage source code
removing LD from filename
starting 6 threads by default
bug fix (lower res fall through)
V20120729
2012-07-29 bug fix (infinite download loop)
new option SBS to save diskspace
V20120407
2012-02-04 selectable video format (mpeg/flv/webm)
SSL webpage does work as well
2012-03-21 CLI-only mode (without GUI)
V20110922
bug fix (itag=8)
V20110828
2011-08-29 - " -
V20110730
2011-07-30 changed to work with new webpage source code
V20110328
2011-07-04 simplified source code for parsing javascript
bug fix (clearing proxy)
2011-03-28 bug fix (utf8 characters)
some translations
V20110308
2011-03-08 changed to work with new webpage source code
V20110219
2011-02-19 new option (ndl) to only show file sizes
2011-02-15 video resolution can be selected
2011-02-05 files get renamed if download was canceled
V20110121
2011-01-21 bug fix (drop events from Firefox on GNU/Linux)
minor changes in GUI
2011-01-12 proxy can be set with input
german text in GUI if JRE environment is german
V20110111
2011-01-11 bug fixes (better handling of drop events)
V20110103
2011-01-03 URLs with a playlist now work
selected folder will be saved
entire GUI as drop target for mouse events
V20101223
2010-12-27 better handling of URLs pasted in
bug fixes (proxy with/without protocol)
application can be shut down while download runs
2010-12-23 files being downloaded are shown with "downloading "
percentage is correct now ;)
V20101219
2010-12-19 URLs to mp4 (hd) now work
initial version
2010-12-17 bug fix (application shutdown)
2010-12-16 sf.net project page registered and
initial version uploaded
2010-12-01? development started
I decided not to provide a single version number but rather
a releasedate_time. A number does not provide any extra
information but the date does. (IMHO)
YTD2 is named after ytd (https://sourceforge.net/projects/ytd/)
but the author never changed any bug reports nor answered
forum posts.
THANKS
My special thanks go to my family, Dean, Anonyous, "Loki" and "Odie" for testing and support! :)
