[repo.or.cz] nomnom.git branch next updated: 0.1.4-33-g14a98bd
Brought to you by:
legatvs
|
From: <nom...@li...> - 2011-10-18 19:37:57
|
This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project nomnom.git.
The branch, next has been updated
via 14a98bd7a4952326f87cd1e43bef604c80f13acb (commit)
via eb79a0bf54183a26643bfd5f22214571c5a3bb8d (commit)
via 2e880672b0504c69ecbc07fda2fc6cd50e60813c (commit)
via d2271c269575875486870739ee01510d8c663e94 (commit)
from 06d0b4255af50242e5be797e357cb36345cc7648 (commit)
Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.
- Log -----------------------------------------------------------------
http://repo.or.cz/w/nomnom.git/commit/14a98bd7a4952326f87cd1e43bef604c80f13acb
commit 14a98bd7a4952326f87cd1e43bef604c80f13acb
Author: Toni Gundogdu <le...@gm...>
Date: Tue Oct 18 22:22:47 2011 +0300
Revise README.packagers
diff --git a/README.packagers b/README.packagers
index cbe0805..59be41d 100644
--- a/README.packagers
+++ b/README.packagers
@@ -2,15 +2,46 @@
PACKAGERS
=========
-Please consider packaging a preconfigured system wide configuration file
-with nomnom. See "examples/NomNom.conf" for an example of this.
+Prerequisites
+-------------
-nomnom will set the default values (e.g. paths to commands) which may
-not always be correct which is why installing a preconfigured configuration
-file with nomnom is recommended.
+Make sure you read the INSTALL file for the application prerequisites.
-You could also run nomnom, edit the preferences and then reuse the
-configuration file in your package. You can see the path to the config
-file in the Preferences / Other.
-Please see also the manual page notes.
+System wide configuration file
+------------------------------
+
+You can distribute 0.2 without a system wide configuration file.
+
+NomNom was, until 0.2, a tedious application to configure -- which is
+why installing a system wide config file with predefined values was
+previously a recommended step.
+
+You may still do this, if you like. Refer to the Qt documentation
+(look up QSettings) for the typical search paths, e.g. on Unix-like
+systems:
+
+ /etc/xdg/NomNom/NomNom.conf
+ /etc/xdg/NomNom.conf
+ /etc/NomNom.conf
+
+Keep in mind, however, that the "system wide config values" are nothing
+more than recommendations as the users may override them (in settings) at
+anytime.
+
+Example (/etc/NomNom.conf):
+
+ [Settings]
+ ParseUsing=other:
+ ParseUsingOther=/foo/bar^-f -b %u
+
+Make a note of the use of "other". This would make "/foo/bar" to be
+used as the default value for "Parse using" command. The command line
+arguments follow after the "^".
+
+Full list of the supported variables, can be found in:
+
+ $top_srcdir/src/settings/nsettings.cpp
+
+Or take a look at your local user config. Run "nomnom --config-path"
+to find the path to it.
http://repo.or.cz/w/nomnom.git/commit/eb79a0bf54183a26643bfd5f22214571c5a3bb8d
commit eb79a0bf54183a26643bfd5f22214571c5a3bb8d
Author: Toni Gundogdu <le...@gm...>
Date: Tue Oct 18 22:13:09 2011 +0300
Revise INSTALL
diff --git a/INSTALL b/INSTALL
index c3a352a..58408ca 100644
--- a/INSTALL
+++ b/INSTALL
@@ -3,15 +3,12 @@
Prerequisites
=============
-* quvi (0.2.16.1+) <http://quvi.googlecode.com/>
+* quvi (0.2.16.1+) <http://quvi.sourceforge.net/>
* umph (0.1.6+) <http://umph.googlecode.com/>
* curl (7.20.0+) <http://curl.haxx.se/>
* qt (4.6+) <http://qt.nokia.com/>
* media player that supports streaming (e.g. vlc, mplayer)
-Note that nomnom may or may not compile with earlier versions.
-The above versions are the ones that I've tested.
-
Installation from source
========================
@@ -20,7 +17,12 @@ Installation from source
If you are compiling nomnom from the development code from the git
repository, see "Installation from development code", instead.
- --without-manual Do not install manual page(s)
+ --enable-verbose Enable --verbose program option
+ If enabled, the program can use --verbose to
+ turn on verbose output to stderr. Recommended
+ for debugging purposes only.
+
+ --without-manual Do not install manual pages
Installation from development code
@@ -34,5 +36,5 @@ repository. You will need:
* GNU autoconf
* GNU automake
-Once the files have been generated, follow the instructions in "Installation
+Once the files have been generated, follow the instructions of "Installation
from source" above.
http://repo.or.cz/w/nomnom.git/commit/2e880672b0504c69ecbc07fda2fc6cd50e60813c
commit 2e880672b0504c69ecbc07fda2fc6cd50e60813c
Author: Toni Gundogdu <le...@gm...>
Date: Tue Oct 18 20:20:38 2011 +0300
Revise README
diff --git a/README b/README
index 1dd32d2..f3c5785 100644
--- a/README
+++ b/README
@@ -1,20 +1,7 @@
-
-NomNom
-===========
-
NomNom is an application for downloading media from Youtube and other similar
media websites that require flash to view the media content. Media streaming
-or downloading can be started simply by dropping an URL onto the application
-window.
-
-NomNom relies on a number of different other programs: quvi(1) to parse the
-media links, curl(1) to download the media, and a media streaming capable
-player software, such as vlc(1), to stream the media. NomNom is written in
-C++ to use the Qt framework.
-
-The name of the application refers to the sound effect that is made when
-eating something tasty or nutritious.
+or downloading can be started by dropping an URL onto the application window.
Home : <http://nomnom.sourceforge.net/>
gitweb: <http://repo.or.cz/w/nomnom.git>
http://repo.or.cz/w/nomnom.git/commit/d2271c269575875486870739ee01510d8c663e94
commit d2271c269575875486870739ee01510d8c663e94
Author: Toni Gundogdu <le...@gm...>
Date: Tue Oct 18 19:39:09 2011 +0300
Revise manual
diff --git a/doc/man1/nomnom.1.pod b/doc/man1/nomnom.1.pod
index ea0ea9e..acf6716 100644
--- a/doc/man1/nomnom.1.pod
+++ b/doc/man1/nomnom.1.pod
@@ -9,59 +9,149 @@ NomNom - The graphical media download tool
NomNom is an application for downloading media from Youtube and other similar
media websites that require flash to view the media content. Media streaming
-or downloading can be started simply by dropping an URL onto the application
-window.
+or downloading can be started by dropping an URL onto the application window.
-NomNom relies on a number of different other programs: C<quvi(1)> to parse
-the media links, C<curl(1)> to download the media, and a media streaming
-capable player software, such as C<vlc(1)>, to stream the media. NomNom is
-written in C++ to use the Qt framework.
+=head2 Project name
The name of the application refers to the sound effect that is made when
eating something tasty or nutritious.
=head1 GETTING STARTED
- * Right-click on the window to open the context-menu
+=head2 Right-click opens the context-menu
- * Check the configuration (Preferences, Ctrl+E)
+Most the application features can be accessed via this menu.
- - Check the paths to quvi(1), curl(1) and player (e.g. vlc(1))
+=head2 Check the settings (Ctrl+E)
- The default values should work on most systems out of the box.
- Make any changes you see necessary.
+NomNom will attempt to detect the available commands when you run it the
+first time. Going over the settings before use is recommended. The
+dialog will not close (by clicking OK) unless you have entered
+everything needed.
- * Drag and drop media page URLs from, for example, your web browser.
- This starts the download (or streaming if selected).
+=head2 Check that NomNom is set to do what you expect
- * You can make NomNom stay on top of other windows (Preferences / Other).
- This will make it easier to use NomNom if you have limited screen space.
+Make a note of the combobox widget on the main window. You may choose to
+either C<Download> or C<Stream> from the widget.
- * Nomnom resumes file transfers by default (determined by the curl command
- in the Preferences). Check "Overwrite" in the context menu if you want to
- overwrite the existing files.
+=head2 Drop media page URLs to main window
-=head1 FILES
+You could, for example, have a web browser open from which you then drag
+the URLs onto the main window of NomNom. Alternatively, open the
+right-click context-menu and choose C<Address...>.
+
+You may also consider making sure that NomNom stays on top of other
+windows if you are working on a small screen. There is an option for
+this in the application settings.
+
+=head2 NomNom defaults to resume interrupted transfers
+
+See also the L</KNOWN ISSUES> for more about this. You can also choose
+to overwrite any existing media files if you'd prefer this.
+
+=head2 You can grab media page URLs from YouTube feeds
+
+Choose C<Feed...> from the context-menu or hit the key-shortcut (Ctrl+F)
+to open the dialog.
+
+=head1 COMMAND LINE
+
+NomNom supports the following command line options.
+
+=head2 --config-path
+
+Prints the path to the local user config file and exits.
+
+=head2 --detect
+
+Prints the detected commands and exits.
+
+=head2 --verbose
+
+Turns on verbose output. Please make a note that NomNom must be
+configured and built with the C<--enable-verbose> switch for this to be
+available in the application.
+
+=head2 --help
+
+Prints the help and exits.
+
+=head2 --version
+
+Prints the version and exits.
+
+=head1 GLOSSARY
+
+=head2 Media page URL
-=over 4
+NomNom feasts on media page URLs. You can drop these URLs to the
+main window to start the process of downloading (or streaming).
-=item Application settings
+These URLs are known to go around also as C<video page URLs>.
-The location where the application settings are depends on the platform.
-Open the Preferences dialog to see the path to the config file. On a
-typical Unix-like system, the path is typically one of the following:
+=head3 Example
- ~/.config/NomNom/NomNom.conf
- /etc/xdg/NomNom/NomNom.conf
- /etc/xdg/NomNom.conf
- /etc/NomNom.conf
+http://vimeo.com/1485507
+
+=head2 Media stream URL
+
+Not to be confused with L</Media page URL>. The media I<stream> URL is
+the URL to the media resource that is returned by the C<quvi(1)>
+command and then used by NomNom to either download or stream from it.
+
+=head2 YouTube feeds
+
+NomNom can read, with the help of C<umph(1)> command, and grab media
+URLs from YouTube feeds. These feeds may be I<playlists>, user
+I<favorites> and user I<uploads>.
+
+You can open the user-interface by selecting it from the right-click
+context-menu (C<Feed...>) or by hitting the key-shortcut (Ctrl+F).
+
+=head2 YouTube format strings
+
+The YouTube C<fmtNN> string IDs are documented at:
+ http://en.wikipedia.org/wiki/YouTube#Quality_and_codecs
+
+=head1 KNOWN ISSUES
+
+=head2 Resuming partially transferred files may fail
+
+Some websites are known to refuse to work with the HTTP requests to
+resume a file transfer. Either check "Always overwrite existing media
+files" in the settings or remove the existing file manually.
+
+=head2 Using of HTTP proxies
+
+If you use an HTTP proxy, please make sure you have configured all of
+the commands that NomNom uses (see C<settings> and open C<commands>) to
+use the same proxy. Some websites refuse to work with requests coming
+from different sources (IP addresses) trying to access the same
+media stream URL which is may be unique to an IP address.
+
+=head1 TIPS
+
+=head2 Use configuration files
+
+Although it is possible to configure custom commands for NomNom to use
+(via C<settings> and C<commands>), another way is to add appropriate
+configuration files for the commands that NomNom uses.
+
+=head3 Examples
+
+ ~/.quvirc ;# refer to the quvi(1) documentation
+ ~/.umphrc ;# refer to the umph(1) documentation
+ ~/.curlrc ;# refer to the curl(1) documentation
+
+Same goes for whatever media player you choose to use.
+
+=head1 FILES
-NomNom uses the QSettings class to save the application settings, please
-see the following links for the technical details:
- <http://doc.trolltech.com/4.7/qsettings.html>
- <http://doc.trolltech.com/4.7/qsettings.html#platform-specific-notes>
+=head2 Configuration file
-=back
+The location of this file may vary and depends on how Qt was configured.
+You can use the C<--config-path> program option to print it, if you are
+not sure. See also L</COMMAND LINE>.
=head1 LICENSE
-----------------------------------------------------------------------
Summary of changes:
INSTALL | 14 +++--
README | 15 +-----
README.packagers | 49 +++++++++++++---
doc/man1/nomnom.1.pod | 156 ++++++++++++++++++++++++++++++++++++++----------
4 files changed, 172 insertions(+), 62 deletions(-)
repo.or.cz automatic notification. Contact project admin le...@gm...
if you want to unsubscribe, or site admin ad...@re... if you receive
no reply.
--
nomnom.git ("The graphical media download tool")
|