bgrot man page on DragonFly

Man page or keyword search:  
man Server   44335 pages
apropos Keyword Search (all sections)
Output format
DragonFly logo
[printable version]

BGROT(1)		  BSD General Commands Manual		      BGROT(1)

NAME
     bgrot — a program to alleviate background boredom

SYNOPSIS
     background.sh
     createlist.sh

DESCRIPTION
     The bgrot suite consists of a set of scripts to handle background image
     rotation.	The user interface scripts are Bourne shell (/bin/sh) scripts,
     while the backends are implemented in Perl 5.  The primary user inter‐
     faces are provided by two scripts: background.sh and createlist.sh.

   background.sh
     background.sh is the meat of bgrot.  It is the script that handles the
     randomization of the background image list, and the rotation of the
     images.  Users may override the system defaults with a config file in
     their home directory.  $CONFDIR, which is where the system defaults live,
     is normally /usr/local/etc, though that maybe have been changed by your
     system administrator on installation.  The file $CONFDIR/bgrot.conf con‐
     tains the system-wide defaults for bgrot, which can be overriden by cre‐
     ating the file $BGROTDIR/conf/bgrot.conf, (though $HOME/.bgrotrc is
     accepted for backward compatibility) and inserting the settings you wish
     to override into it.  Most of the settings are self-explanatory, the rest
     can be easily understood by a cursory examination of the scripts.

   createlist.sh
     createlist.sh Is a utility used to prepare the list of background images
     for background.sh.	 All per-user information for bgrot is kept in
     $BGROTDIR, which is normally $HOME/.bgrot.	 The createlist.sh program
     creates the image list from the images in $BGROTDIR/images (which can be
     a symlink or a directory of symlinks), and puts the output list into the
     file $BGROTDIR/conf/master.background.list.  Note that createlist.sh ONLY
     includes files with the extensions stated in the bgrot.conf file (either
     global or individual), and WILL recurse through subdirectories of
     $BGROTDIR/images.

USAGE
     Simple place the images you wish to rotate in the $BGROTDIR/images direc‐
     tory, run createlist.sh to create the master image list, and run
     background.sh in the background (perhaps nice'd, for instance
     /usr/bin/nice -15 background.sh & ), and it should run perfectly.	It's
     not that complicated.

AUTHOR
     bgrot is written, used, and maintained by Matthew Fuller ⟨fullermd@over-
     yonder.net⟩.  See the official bgrot homepage at
     http://www.over-yonder.net/~fullermd/projects/bgrot for updates.

UNIX			       January 18, 1999				  UNIX
[top]

List of man pages available for DragonFly

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net