NAME¶
NomNom - The graphical media download tool
DESCRIPTION¶
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 by dropping an URL onto the application window.
Project name¶
The name of the application refers to the sound effect that is made when eating
something tasty or nutritious.
GETTING STARTED¶
Most the application features can be accessed via this menu.
Check the settings (Ctrl+E)¶
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.
Check that NomNom is set to do what you expect¶
Make a note of the combobox widget on the main window. You may choose to either
"Download" or "Stream" from the widget.
Drop media page URLs to main window¶
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 "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.
NomNom defaults to resume interrupted transfers¶
See also the "KNOWN ISSUES" for more about this. You can also choose
to overwrite any existing media files if you'd prefer this.
You can grab media page URLs from YouTube feeds¶
Choose "Feed..." from the context-menu or hit the key-shortcut
(Ctrl+F) to open the dialog.
COMMAND LINE¶
NomNom supports the following command line options.
--config-path¶
Prints the path to the local user config file and exits.
--locale¶
Prints the system locale (as returned by Qt) and exits.
--detect¶
Prints the detected commands and exits.
--verbose¶
Turns on verbose output. Please make a note that NomNom must be configured and
built with the "--enable-verbose" switch for this to be available in
the application.
--help¶
Prints the help and exits.
--version¶
Prints the version and exits.
GLOSSARY¶
Media page URL¶
NomNom feasts on media page URLs. You can drop these URLs to the main window to
start the process of downloading (or streaming).
These URLs are known to go around also as "video page URLs".
Example
http://vimeo.com/1485507
Not to be confused with "Media page URL". The media
stream URL
is the URL to the media resource that is returned by the
quvi(1) command and
then used by NomNom to either download or stream from it.
YouTube feeds¶
NomNom can read, with the help of umph(1) command, and grab media URLs from
YouTube feeds. These feeds may be
playlists, user
favorites and
user
uploads.
You can open the user-interface by selecting it from the right-click
context-menu ("Feed...") or by hitting the key-shortcut (Ctrl+F).
The YouTube "fmtNN" string IDs are documented at:
http://en.wikipedia.org/wiki/YouTube#Quality_and_codecs
KNOWN ISSUES¶
Resuming partially transferred files may fail¶
Some websites are known to refuse to work with the HTTP requests to resume a
file transfer.
Workaround
Either check "Always overwrite existing media files" in the settings
or remove the existing file manually.
HTTP user-agent¶
Some websites refuse to play nice with renegade user-agent strings.
Recommendations
Make sure both
quvi(1) and
curl(1) use the same user-agent string. Note that
quvi(1) uses "Mozilla/5.0" by default.
HTTP proxy¶
Generally OK, although some proxies may have been configured to "cook
up" the HTTP headers before they are sent back to the server. This may
sometimes lead to issues with the servers.
Recommendations
If you use an HTTP proxy, make sure you have configured all of the commands that
NomNom uses (e.g.
quvi(1),
curl(1), etc.) to use the same proxy.
TIPS¶
Use configuration files¶
Although it is possible to configure custom commands for NomNom to use (via
"settings" and "commands"), another way is to add/edit the
appropriate configuration files for these commands.
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 with NomNom.
FILES¶
Configuration file¶
The location of this file may vary and depends on how Qt was configured. You can
use the "--config-path" program option to print it. See also
"COMMAND LINE".
LICENSE¶
NomNom is free software, licensed under the GPLv3+.
WWW¶
Home : <http://nomnom.sourceforge.net/>
gitweb: <http://repo.or.cz/w/nomnom.git>
AUTHOR¶
Toni Gundogdu <legatvs at sign gmail com>
Thanks to all those who have contributed to the project by sending patches,
reporting bugs and writing feedback. You know who you are.