.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.ie \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.el \{\
.    de IX
..
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "nomnom 1"
.TH nomnom 1 "2011-10-30" "0.3.1" "nomnom manual"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
NomNom \- The graphical media download tool
.SH "DESCRIPTION"
.IX Header "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 \s-1URL\s0 onto the application window.
.SS "Project name"
.IX Subsection "Project name"
The name of the application refers to the sound effect that is made when
eating something tasty or nutritious.
.SH "GETTING STARTED"
.IX Header "GETTING STARTED"
.SS "Right-click opens the context-menu"
.IX Subsection "Right-click opens the context-menu"
Most the application features can be accessed via this menu.
.SS "Check the settings (Ctrl+E)"
.IX Subsection "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 \s-1OK\s0) unless you have entered
everything needed.
.SS "Check that NomNom is set to do what you expect"
.IX Subsection "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 \f(CW\*(C`Download\*(C'\fR or \f(CW\*(C`Stream\*(C'\fR from the widget.
.SS "Drop media page URLs to main window"
.IX Subsection "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 \f(CW\*(C`Address...\*(C'\fR.
.PP
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.
.SS "NomNom defaults to resume interrupted transfers"
.IX Subsection "NomNom defaults to resume interrupted transfers"
See also the \*(L"\s-1KNOWN\s0 \s-1ISSUES\s0\*(R" for more about this. You can also choose
to overwrite any existing media files if you'd prefer this.
.SS "You can grab media page URLs from YouTube feeds"
.IX Subsection "You can grab media page URLs from YouTube feeds"
Choose \f(CW\*(C`Feed...\*(C'\fR from the context-menu or hit the key-shortcut (Ctrl+F)
to open the dialog.
.SH "COMMAND LINE"
.IX Header "COMMAND LINE"
NomNom supports the following command line options.
.SS "\-\-config\-path"
.IX Subsection "--config-path"
Prints the path to the local user config file and exits.
.SS "\-\-locale"
.IX Subsection "--locale"
Prints the system locale (as returned by Qt) and exits.
.SS "\-\-detect"
.IX Subsection "--detect"
Prints the detected commands and exits.
.SS "\-\-verbose"
.IX Subsection "--verbose"
Turns on verbose output. Please make a note that NomNom must be
configured and built with the \f(CW\*(C`\-\-enable\-verbose\*(C'\fR switch for this to be
available in the application.
.SS "\-\-help"
.IX Subsection "--help"
Prints the help and exits.
.SS "\-\-version"
.IX Subsection "--version"
Prints the version and exits.
.SH "GLOSSARY"
.IX Header "GLOSSARY"
.SS "Media page \s-1URL\s0"
.IX Subsection "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).
.PP
These URLs are known to go around also as \f(CW\*(C`video page URLs\*(C'\fR.
.PP
\fIExample\fR
.IX Subsection "Example"
.PP
http://vimeo.com/1485507
.SS "Media stream \s-1URL\s0"
.IX Subsection "Media stream URL"
Not to be confused with \*(L"Media page \s-1URL\s0\*(R". The media \fIstream\fR \s-1URL\s0 is
the \s-1URL\s0 to the media resource that is returned by the \f(CWquvi(1)\fR
command and then used by NomNom to either download or stream from it.
.SS "YouTube feeds"
.IX Subsection "YouTube feeds"
NomNom can read, with the help of \f(CWumph(1)\fR command, and grab media
URLs from YouTube feeds. These feeds may be \fIplaylists\fR, user
\&\fIfavorites\fR and user \fIuploads\fR.
.PP
You can open the user-interface by selecting it from the right-click
context-menu (\f(CW\*(C`Feed...\*(C'\fR) or by hitting the key-shortcut (Ctrl+F).
.SS "YouTube format strings"
.IX Subsection "YouTube format strings"
The YouTube \f(CW\*(C`fmtNN\*(C'\fR string IDs are documented at:
 http://en.wikipedia.org/wiki/YouTube#Quality_and_codecs
.SH "KNOWN ISSUES"
.IX Header "KNOWN ISSUES"
.SS "Resuming partially transferred files may fail"
.IX Subsection "Resuming partially transferred files may fail"
Some websites are known to refuse to work with the \s-1HTTP\s0 requests to
resume a file transfer.
.PP
\fIWorkaround\fR
.IX Subsection "Workaround"
.PP
Either check \*(L"Always overwrite existing media files\*(R" in the settings
or remove the existing file manually.
.SS "\s-1HTTP\s0 user-agent"
.IX Subsection "HTTP user-agent"
Some websites refuse to play nice with renegade user-agent strings.
.PP
\fIRecommendations\fR
.IX Subsection "Recommendations"
.PP
Make sure both \f(CWquvi(1)\fR and \f(CWcurl(1)\fR use the same user-agent string.
Note that \f(CWquvi(1)\fR uses \*(L"Mozilla/5.0\*(R" by default.
.SS "\s-1HTTP\s0 proxy"
.IX Subsection "HTTP proxy"
Generally \s-1OK\s0, although some proxies may have been configured to
\&\f(CW\*(C`cook up\*(C'\fR the \s-1HTTP\s0 headers before they are sent back to the server.
This may sometimes lead to issues with the servers.
.PP
\fIRecommendations\fR
.IX Subsection "Recommendations"
.PP
If you use an \s-1HTTP\s0 proxy, make sure you have configured all of the commands
that NomNom uses (e.g. \f(CWquvi(1)\fR, \f(CWcurl(1)\fR, etc.) to use the same proxy.
.SH "TIPS"
.IX Header "TIPS"
.SS "Use configuration files"
.IX Subsection "Use configuration files"
Although it is possible to configure custom commands for NomNom to use
(via \f(CW\*(C`settings\*(C'\fR and \f(CW\*(C`commands\*(C'\fR), another way is to add/edit the appropriate
configuration files for these commands.
.PP
\fIExamples\fR
.IX Subsection "Examples"
.PP
.Vb 3
\& ~/.quvirc ;# refer to the quvi(1) documentation
\& ~/.umphrc ;# refer to the umph(1) documentation
\& ~/.curlrc ;# refer to the curl(1) documentation
.Ve
.PP
Same goes for whatever media player you choose to use with NomNom.
.SH "FILES"
.IX Header "FILES"
.SS "Configuration file"
.IX Subsection "Configuration file"
The location of this file may vary and depends on how Qt was configured.
You can use the \f(CW\*(C`\-\-config\-path\*(C'\fR program option to print it. See also
\&\*(L"\s-1COMMAND\s0 \s-1LINE\s0\*(R".
.SH "LICENSE"
.IX Header "LICENSE"
NomNom is free software, licensed under the GPLv3+.
.SH "WWW"
.IX Header "WWW"
.Vb 2
\& Home  : <http://nomnom.sourceforge.net/>
\& gitweb: <http://repo.or.cz/w/nomnom.git>
.Ve
.SH "AUTHOR"
.IX Header "AUTHOR"
Toni Gundogdu <legatvs at sign gmail com>
.PP
Thanks to all those who have contributed to the project by sending
patches, reporting bugs and writing feedback. You know who you are.