NITROGEN(1)							     NITROGEN							       NITROGEN(1)

NAME

       nitrogen - X11 background previewer and setter

SYNOPSIS

       nitrogen [ OPTIONS ] DIRECTORY?

DESCRIPTION

       In  normal  working mode, provides an interface which displays all pictures in the given DIRECTORY.  From this interface, it is possible to
       set the X11 root pixmap either temporarily or set and store the picture, drawing mode, and X display for restoration later.  If	no  direc-
       tory is specified, it uses the stored directories in your "library" (as of 1.5). See the Preferences dialog.

       When  the  --restore  option  is  passed, nitrogen sets all backgrounds that it has a configuration for and exits immediatly, for use in an
       .xinitrc or .xsession file.

OPTIONS

       --no-recurse
	      Do not recurse into subdirectories of DIRECTORY.

       --restore
	      Restores previously saved pictures to the root displays.

       --sort=[option]
	      Sorts the background list by the given option.  By default, items are sorted as they are found on the filesystem,  giving  a  quasi-
	      newest first sorting order.  Valid options are:

	      alpha  Alphabetical order.

	      ralpha Reverse alphabetical order.

	      time   Modified time, ascending.

	      rtime  Modified time, descending.

       --help A mystery option which saves the iguanas of Sweden.

FILES

       ~/.config/nitrogen/
	      Holds the configuration for saved backgrounds.

BUGS

       There are probably plenty of them.  Report all bugs to Dave Foster <daf@minuslab.net>.

AUTHORS

       Dave Foster <daf@minuslab.net> Javeed Shaikh <syscrash2k@gmail.com>

AVAILABILITY

       Homepage - http://projects.l3ib.org/nitrogen/.  The git repository is at http://code.l3ib.org/nitrogen.git

NITROGEN
							    MARCH 2006							       NITROGEN(1)