YG(1)

NAME
yg - A lightweight, command line YouTube.com video downloader.

SYNOPSIS
yg [URL]...

DESCRIPTION
YouGrabber is a lightweight, command line YouTube.com video downloader, made from scratch in ANSI C.

It's known to compile/run out of the box, on several POSIX platforms (GNU/Linux, *BSD, MacOSX, Cygwin), and computer architectures (x86, x86_64, PPC).

FEATURES
- Simple to use Ncurses interface
- UTF8 character support (video title and file name)
- Dynamic interface resize (when running in terminal emulators)
- Real time download statistics
- Community flagged video download support
- Multiple video download support
- .ini style configuration file
- Proxy support (HTTP, SOCKS 4 and 5)
- Configurable download directory
- Low CPU usage and small memory footprint

FILES
/usr/share/doc/yougrabber/yg.conf.example
~/.yg.conf

EXAMPLE
yg "http://www.youtube.com/watch?v=haFdXeEPBcU"

DIAGNOSTICS
yg returns 0 on success, and 1 otherwise.

The configuration will fallback to default values, if ~/.yg.conf
- doesn't exist
- is empty/commented/ill-formed
- has ungrouped keys

yg will use the current working directory to store downloads, if the [download] directory key in ~/.yg.conf
- is empty/commented/nonexistent
- points to a directory that doesn't exist
- points to a directory without read/write permissions

yg will immediately exit if both current and download directories cannot be read/written by the user.

BUGS
Temporary files may be left in the working directory if yg exits abnormally.

Some URLs might contain & (ampersand) characters, causing yg to be executed into the background, when interpreted by the shell.

Workaround: put the URL inside '' (quotes) or "" (double quotes), like in the EXAMPLE shown above.

REPORTING BUGS
Bug reports should be sent to <quetzyg@users.sourceforge.net>.

RESOURCES
For news and updates, see <http://yougrabber.sourceforge.net/>.

AUTHOR
Written by Quetzy Garcia.

COPYRIGHT
Copyright (C) 2006-2008 Quetzy Garcia

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 2 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/>.