Tree [61fe60] default tip /
History



File Date Author Commit
doc 2012-12-23 Benjamin Johnson Benjamin Johnson [c36538] Use friendlier names for various options and fe...
firefox 2011-09-13 Benjamin Johnson Benjamin Johnson [b1e425] firefox: update for new Firefox versions
graphics 2011-07-16 Benjamin Johnson Benjamin Johnson [45b61d] HelpWindow: add toolbar icons
lib 2012-12-23 Benjamin Johnson Benjamin Johnson [7c222e] Remove a crufty comment in qfileentry.cxx
src 2012-12-23 Benjamin Johnson Benjamin Johnson [7d8066] Remove printing support from the Help window in...
win32 2012-12-23 Benjamin Johnson Benjamin Johnson [7a853d] Remove Sansa Fuze support from the Windows inst...
.hgignore 2011-07-08 Benjamin Johnson Benjamin Johnson [31d1fb] don't track the launcher binary
.hgtags 2012-12-23 Benjamin Johnson Benjamin Johnson [61fe60] Added tag 2.0.0b7 for changeset 5d055defb7ed
Build.ini 2012-12-23 Benjamin Johnson Benjamin Johnson [5d0d13] Fix some build system sloppiness
COPYING 2009-12-28 obeythepenguin@gmail.com obeythepenguin@gmail.com [614871] initial commit of GPL youtube2mp3
README 2012-12-23 Benjamin Johnson Benjamin Johnson [5d055d] Update the documentation in the source tarball
configure.py 2012-12-23 Benjamin Johnson Benjamin Johnson [5d0d13] Fix some build system sloppiness

Read Me

+----------------------------------------------------------------------------+
|                                                                            |
|  PLEASE NOTE!!                                                             |
|                                                                            |
|  Youtube2mp3 is no longer actively maintained.  It depends on an obsolete  |
|  widget toolkit (Qt 3.3) and a number of third-party media programs which  |
|  are prone to frequent breakage from version to version.                   |
|                                                                            |
|  I strongly encourage you to switch to a more current program for all      |
|  your video piracy and conversion needs.                                   |
|                                                                            |
+----------------------------------------------------------------------------+

Youtube2mp3 is a free audio/video downloader and converter.

It can convert YouTube, Google Video, DVDs, and local media files to MP3,
Ogg Vorbis, Windows Media Video, and other popular formats.  It also
supports portable devices such as the Apple iPod and Sandisk Sansa View.

It has a simple, uncluttered interface that doesn't get in your way.
It runs on Windows and Unix-like systems, and the complete source code
is released under the GNU GPL.


COMPATIBILITY
-------------

Video sites:	See <http://youtube2mp3.sourceforge.net/sites.html>
		Most popular sites are supported, including YouTube,
		Google Video, Metacafe, Yahoo!, etc.  The list changes
		often; please see our homepage for more information.

Video players:	See <http://youtube2mp3.sourceforge.net/formats.html>
		Depending on conversion options, youtube2mp3 can create
		media files compatible with all popular players, including
		Windows Media Player and QuickTime.

Devices:	See <http://youtube2mp3.sourceforge.net/devices.html>
		The Apple iPod settings are compatible with many devices.

Browsers:	Optional toolbar buttons are available for Microsoft
		Internet Explorer, Mozilla Firefox, and Opera browsers.

Platforms:	Youtube2mp3 is currently known to compile and run on
		Windows, Linux (x86_64-bmj-linux), and OpenBSD platforms.


DEPENDENCIES
------------

The Qt library and Python are required to build youtube2mp3.
All others are runtime dependencies; youtube2mp3 will compile and
run without them, but it won't be particularly useful for anything.

Name:		Qt (3.3 or newer; NOT 4.x)
Homepage:	http://qt.nokia.com/
Status:		REQUIRED.
Description:	User interface toolkit.
Use(s):		The entire program.

Name:		Python (2.6 or newer)
Homepage:	http://www.python.org/
Status:		REQUIRED.
Description:	Interpreted, object-oriented programming language.
Use(s):		Build system, youtube-dl (downloader), etc.

Name:		youtube-dl
Homepage:	http://rg3.github.com/youtube-dl/
Status:		Optional.
Description:	Video downloader for YouTube and other sites.
Use(s):		Downloading videos from YouTube and other sites.

Name:		MPlayer/MEncoder
Homepage:	http://www.mplayerhq.hu/
Status:		REQUIRED.
Description:	Movie player and encoder.
Use(s):		Backend to virtually all video converters.

	 ->	Name:		libdvdcss
	 ->	Homepage:	http://www.videolan.org/pub/libdvdcss/
	 ->	Status:		Optional.
	 ->	Description:	Video DVD playback library.
	 ->	Use(s):		Required for DVD ripper functionality.

Name:		Nero AAC Codec
Homepage:	http://www.nero.com/enu/technologies-aac-codec.html
Status:		Optional.
Description:	High quality AAC encoder.
Use(s):		Backend to AAC converter.

Name:		LAME
Homepage:	http://lame.sourceforge.net/
Status:		Optional.
Description:	An MP3 encoder.
Use(s):		Backend to MP3 converter.

Name:		OggEnc
Homepage:	http://www.xiph.org/downloads/
Status:		Optional.
Description:	Ogg Vorbis reference encoder.
Use(s):		Backend to Ogg Vorbis encoder.

Name:		FFmpeg (0.5.x; newer versions will NOT work!)
Homepage:	http://www.ffmpeg.org/
Status:		Optional.
Description:	Video encoder.
Use(s):		Backend to portable devices, MPEG-4 encoders.

	 ->	Name:		x264
	 ->	Homepage:	http://www.videolan.org/x264.html
	 ->	Status:		Optional.
	 ->	Description:	H.264 encoding library.
	 ->	Use(s):		Needed to support H.264 in FFmpeg.

	 ->	Name:		Xvid
	 ->	Homepage:	http://www.xvid.org/
	 ->	Status:		Optional.
	 ->	Description:	MPEG-4 encoding library.
	 ->	Use(s):		Needed to support MPEG-4 part 2 in FFmpeg.

	 ->	Name:		FAAC
	 ->	Homepage:	http://www.audiocoding.com/faac.html
	 ->	Status:		Optional.
	 ->	Description:	AAC encoding library.
	 ->	Use(s):		Needed to support AAC in FFmpeg.

Name:		fuzemux
Homepage:	http://code.google.com/p/fuzemux/
Status:		Optional.
Description:	Sansa Fuze video muxer.
Use(s):		Required to support Sandisk Sansa Fuze.

Name:		TiMidity++
Homepage:	http://timidity.sourceforge.net/
Status:		Optional.
Description:	Software MIDI player.
Use(s):		Required to support converting MIDI files.

________________
WINDOWS-SPECIFIC

Name:		MinGW/MSYS
Homepage:	http://www.mingw.org/
Status:		REQUIRED.
Description:	Port of GNU development toolchain to Windows.
Use(s):		Required to build youtube2mp3.

Name:		Q.. (substitute for Qt)*
Homepage:	http://qtwin.sourceforge.net/
Status:		REQUIRED.
Description:	Unofficial Qt/Win ported from X11 version.
Use(s):		Substitute for Qt on Windows.

	 ->	A pre-compiled version (Qt-3.3.8-p8.exe) is
	 ->	available from our SourceForge project page.

Name:		NSIS
Homepage:	http://nsis.sourceforge.net/
Status:		Optional.
Description:	Scriptable installation system.
Use(s):		Required to build Windows installer.


INSTALLATION
------------

The build system assumes a UNIX shell environment.
Windows users, note that Visual C++ and Cygwin are NOT supported.

Linux/UNIX:
 1. Run `./configure.py' to configure the application.
 2. Run `make' to build the application.
 3. Run `make install' (as root) to install.

Windows:
 1. Run `./configure.py' to configure the application.
 2. Run `export QTDIR=/c/mingw/Qt' so we can find the Q.. library.
 3. Run `make' to build the application.
 4. Run `make setup' to build the installer.

Note: Use `./configure.py --help' to display all supported options.
The $DESTDIR variable is supported for packaging, e.g. Slackware.

Unless you specify a debug build (using ./configure.py --enable-debug),
`make' will automatically strip the youtube2mp3 program binary.

Debug builds might contain some experimental features not yet ready
for public consumption.  These are enabled by defining the SHOWDEBUG
preprocessor macro.  They aren't usually that exciting, though.


AUTHORS
-------

Benjamin Johnson <obeythepenguin@users.sourceforge.net>