webnail − create a webnail image
[XML_INPUT_FILE]
[−[uU] [−a USER
PASSWORD]] [−t IMAGE_TYPE]
[INPUTFILE OUTPUTFILE]...
[−[uU] [−a USER
PASSWORD]] [−t IMAGE_TYPE]
[ −w [−i] [WEB_OPTIONS]]
[INPUTFILE]...
[-[uU] [-a USER PASSWORD]]
[−t IMAGE_TYPE]
[ −w [−i] [WEB_OPTIONS]]
[INPUTFILE]...
[XML_INPUT_FILE]
Webnail is a program that scales an image to create a
thumbnail of the image, typically for use in web pages that
show multiple images, or that alternatively creates a full
web page. With no arguments, the program is run from a GUI
(Graphical User Interface). With a single argument that does
not start with "−", the argument is assumed
to be the name of an XML input file, as described below,
that will configure the GUI. The GUI has an option to save
its state in a file using this XML format. Otherwise the
arguments other than options are as follows. The maximum
width of an thumbnail image in pixels. The maximum height of
a thumbnail image in pixels. The path name or file name of
an input file containing the full-sized image. The path name
or file name of the thumbnail file to be created. Any number
of pairs of input and output files can be passed, up to
system imposed limits on the length of a command line.
Webnail will use a GUI. If there is a following argument, an
XML file with the default extension (xml) or the extension
wnl, that file will be loaded. The file represents the saved
state of a webnail session and has a MIME type of
application/x.webnail+xml. The window system will normally
be configured to recognize this type of file and open the
file by using this command-line flag. The DTD for this file
is described in the on-line manual accessible from
webnail’s menu. On Linux or Unix systems, it is also
described in part 5 of the Linux/Unix manual. On Windows
systems, it will typically be in found at
%PROGRAMDATA%/webnail/doc/webnail-files.html. When there is
a following argument - either a file name or a URL, webnail
will set its current working directory to the parent
directory if that file, provided one exists. The target
directory or zip file will contain a WEB-INF subdirectory
that contains a web.xml file, as required by the web archive
standard. This option simplifies deployment to a web server.
The target directory or zip file will contain the files
needed for a web page displaying the images. Within this
directory or zip file, the file named index.html specifies
the web page to display. The following argument, gives a
directory to put the output files. The following argument,
gives the name of a zip file in which to put thumbnail
images or the directory tree for a web page. Thumbnail
images will have the same name as the original files, but
may have a different suffix. The last component of a path
name should be unique among all of those given as otherwise
a thumbnail image will be overridden. If refers to an
existing zip file, that file will be overridden. If the zip
file’s name ends in the suffix ".war", The
file will be formatted as a web-archive JAR file, in which
case the −w and −i options are turned on. If the
name of the file is "-", standard output is used
instead. The following argument, gives the name of an XML
input file that specifies additional details as to how the
images should be displayed beyond those provided by the
command-line interface. If the name of the file is
"-", standard input is used instead. File name
extensions should be either ".xml" or
".wnl". Aside from a preceding "-u"
option, the only options allowed with a "-f"
option are the "-z" and "-d" options.
The syntax of the input file is described in Part 5 of this
manual. It is also described in the on-line manual provided
with Webnail that is accessible from the "Help"
menu when the GUI is used. lists the supported image types
(media/MIME types, with file-name extensions). The following
argument, specifies an image type for files that will be
created by giving their MIME types. The arguments are URLs
instead of system-dependent file names. This allows images
to be fetched from a server, file, etc. If this argument
precedes the "-f" option, the argument of the
"-f" option is a URL. The arguments are URLs
instead of system-dependent file names. This allows images
to be fetched from a server, file, etc. In addition, for
full-sized images, a link to the image instead of a local
copy will be used. specifies a user name and password to use
for authorization for HTTP or HTTPS requests. The following
options are used only when the option was selected
explicitly or implicitly by using the option. The following
argument, gives the background color to use for web pages.
The color is specified by any form acceptable as a color by
CSS1 (Cascading Style Sheets version 1). The following
argument, give the foreground (or text) color to use for web
pages. The color is specified by any form acceptable as a
color by CSS1 (Cascading Style Sheets version 1). Icons used
for controls will use a light color suitable for a dark
background. When a slideshow is running in full-screen mode,
if there is an error loading an image, the previous image
will be displayed until the time interval for the image that
caused the error has expired. When a slideshow is running in
full-screen mode, and an image arrives late, the time
interval for that image (and perhaps subsequent ones) will
be shortened with a goal of synchronizing the display time
with the sequence of times indicated by the image-Time
interval. The following argument, gives the time interval
for displaying an image in a slideshow. The following
argument, gives the minimal time interval for displaying an
image in a slideshow, and is used when the image’s
time interval has to be shortened for time synchronization.
The following argument, is a string giving the default title
to display on the web page for the images. The following
argument, is a string giving the default window title to
display on the web page for the images. This title will
typically appear in frame surrounding a browser’s
window. The following argument, is a string giving a default
description to display on the web page for the images. This
option configures the web page to disable full-screen mode
for slideshows, and eliminates the presence of
high-resolution images. Normally when the option is
selected, all high-resolution images go into a subdirectory
named The option places the high-resolution images in the
top level directory for the web page. This is useful if you
want the web files built around existing images (e.g., the
images in a or directory created by software that downloads
images from a digital camera) as existing files will used
rather than copied. This option sets up the web page so that
when you click on the larger image (not one of the thumbnail
images), one will follow a link to the original image. The
image arguments should in this case preferably be URLs, not
file names (a file name would be converted to a
"file" URL, but this is appropriate only for use
on a single computer system). Set the TCP port to use when
webnail is used as a web server. When the port is zero, or
not provided, a port will be automatically chosen.
Unfortunately, with Firefox 98.0.1 (and possibly later),
someone decided that the ephemeral port range is verboten,
and when the port is zero, or not provided, that is the
range from which the port will be chosen. Set up passwords
for user authentication. Three users will be created. The
user will be configured with the password and will determine
the timing of transitions on ’remote’ browsers.
The user will be configured with the password and, when its
slideshow is started, will run in full-screen mode, staying
in sync with the browser logged in as ’main’.
The user will be configured with the password and its
slideshows will run independently of other browsers. If the
password option is missing, the server is configured without
any user authentication. While will try to start a browser
directly, an issue was discovered with Firefox 96.0 with the
NoScript extension on an ubuntu-based system when
authentication is enabled: most of the time, NoScript fails
to allow a script when asked to allow it. This also happens
when right-clicking a URL in a terminal window, but does not
happen when Firefox is started by double-clicking its icon.
The work-around is to close the browser window and restart
Firefox. To make this easier, copies the URL (if possible)
to the system clipboard when the server starts.
Start webnail as a web server. The argument is either a directory, a zip file, or a WAR (Web ARchive) file that was generated with although it can be used with other files or directories as well. Some versions of Firefox such as 98.0.1 can behave erratically with this option: if Firefox is not already running, the browser window that opens may not show either the slideshow controls or a message indicating that scripting has to be enabled. If this happens, reloading the page may restore the normal behavior. Another thing to try is to push the ’home page’ button and then the back button. This behavior also occurs when Firefox is started by opening a link directly from a terminal window, but does not occur if the link is opened by entering the URL in Firefox’s "location" window. Java archive Shell script to start the program