======================================
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 (e.g. binary data) to
a temporary folder before displaying it. YTD2 does the
same except You can choose where to save the files.
YTD2 is meant for private non-commercial use only.
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.
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)
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$ set http_proxy=http://localhost:3128
knoedel@section60:~/workspace$ java -jar runytd2.jar
example (on M$-Windows) before start:
c:\> 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)
- user-friendly behavior in case webpage source codes changes
maybe: Java Web Start, translated GUI (or no text at all),
video from other websites (imdb.com, video.web.de,..)
Any hints, suggestions, features, questions .. are welcome!
CHANGES
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
bugfixes: proxy now works 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 fixing bugs regarding 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 to Dean, Anonyous, "Loki" and "Odie" for testing and support! :)