# -[ INSTALL NOTES ]----------------------------------------------------------- # # Please see http://wiki.archlinux.org/index.php/Perl_Background_Rotation for # complete installation notes. The documentation in this file only covers # what the different options do. # -[ GENERAL OPTIONS ]--------------------------------------------------------- # # debug enables a LOT of text in your logs when processing. Turn it on at first or # when debugging. It serves no purpose when used with a cron job. Set to 1 for # basic logging output, set to 2 for REALLY verbose output. # debug 0 # clean_shm determines if you would like to delete the wallpapers from the # temporary rendering area once exe_scale has placed the completed wallpaper on # your screen. This saves you quite a bit of shared memory, but it can be nice # to have the original image around to set as your wallpaper in the event that # your need to restart X. The default is to remove it. # clean_shm 1 # bgdir points to a base "background" directory which contains only # subdirectories or categories of images. # bgdir /home/user/.backgrounds # exe_scale is the programs to use to actually put the background # on your desktop. The default is to use feh. Esetroot works fine too. Tiled # backgrounds are created for you, so tiling support in the external program is # not needed. And since the resolution is pre-determined, scaling support # really isn't needed either. # # Gnome users should try a command like (all on one line!) # # "gconftool-2 /desktop/gnome/background/picture_options scaled ; gconftool-2 /desktop/gnome/background/picture_filename /dev/shm/done.png" # exe_scale feh --bg-scale # -[ WALLPAPER OPTIONS ]------------------------------------------------------- # In the event that a color scheme cannot be determined for an image, a random # "preset" scheme based on a color in this array will be selected. Usually, a # preset is needed with extremely bright or dark backgrounds where a dominant # color cannot be picked out. # # A good rule of thumb is to just run this script with debug turned on for a # while, and when you come across a really good looking theme you think might work # well with a white photo, grab the scheme data from wallpaper --scheme. Write # down the first color in the list and use it here. # # If you'd like to see a preview of what a particular scheme would look like, # visit http://wellstyled.com/tools/colorscheme2/index-en.html, click on "enter # rgb" and then click on analogic and check "add the complement". # schema_preset 555555 # Grey # schema_preset 666666 # More Grey! # schema_preset 777777 # Grey Galore! # -[ DIRECTORIES AND TIMES ]--------------------------------------------------- # # These configuration items point to a directory to choose from depending on # the time of day. For example, if $bgdir is set to /home/cpm/.backgrounds, # and the first photoset is set to "Early", between midnight and 1:00 am all # the backgrounds will be selected from /home/cpm/backgrounds/Early/* # # This script will recurse through any subdirectories you may have defined # under one of the photosets. These directories should ONLY have photos in # them. Imagemagick (the tool I use to render photos), has no idea how to # render PDF files, so store them somewhere else. :) # # Each directory should have at a MINIMUM, 6 photos in them. If you list a # directory below with less than 6 files in it, the script will kill itself to # prevent a race condition. This is done because the names of the last 5 # photos are stored, and the randomization process filters those names out of # the selection process. With only 6 photos it can get by. More is better :) # # Below are the hardcoded defaults. If you uncomment any of the photoset # options, YOU MUST DEFINE THEM ALL. Thats right, all 24 of them. # # Please note that these directories MUST exist before running the wallpaper # script! # photoset Early # 12 PM to 01 AM # photoset Early # 01 AM to 02 AM # photoset Early # 02 AM to 03 AM # photoset Early # 03 AM to 04 AM # photoset Early # 04 AM to 05 AM # photoset Early # 05 AM to 06 AM # photoset Morning # 06 AM to 07 AM # photoset Food/Breakfast # 07 AM to 08 AM # photoset Morning # 08 AM to 09 AM # photoset Morning # 09 AM to 10 AM # photoset Morning # 10 AM to 11 AM # photoset Work/Arriving # 11 AM to 12 PM # photoset Work/Arriving # 12 AM to 01 PM # photoset Food/Lunch # 01 PM to 02 PM # photoset Work/Hacking # 02 PM to 03 PM # photoset Work/Hacking # 03 PM to 04 PM # photoset Afternoon # 04 PM to 05 PM # photoset Afternoon # 05 PM to 06 PM # photoset Afternoon # 06 PM to 07 PM # photoset Afternoon # 07 PM to 08 PM # photoset Food/Dinner # 08 PM to 09 PM # photoset Evening # 09 PM to 10 PM # photoset Evening # 10 PM to 11 PM # photoset Evening # 11 PM to 12 PM # -[ SCREEN CONFIGURATION ]---------------------------------------------------- # # The following configuration parameters show the defaults for the first monitor # on your workstation. If you have more than one monitor, copy what you need # below this line and duplicate it, replacing "0.0" with the display name you # wish to configure. # # YOU NEED TO ENABLE AT LEAST ONE DISPLAY. THE DEFAULT IS TO DISABLE THEM ALL! # enable 0 # Set the resolution of that display. All images rendered to this screen will # be resized or tiled to this resolution. # resolution 1024x768 # -[ CONKY OPTIONS ]----------------------------------------------------------- # # If you want to update your conky configuration based on the colorscheme, you # MUST enable the conky configuration option. In addition, you should define # a template (a conky file to read from) and an output (the file conky reads # from itself, typically .conkyrc. # # If you leave 'enable' set to 0, you do not have to define template or output. # # enable 0 # template /home/user/.conkyrc.template # output /home/user/.conkyrc # # -[ GTK OPTIONS ]----------------------------------------------------------- # If you want to update your gnome/gtk configuration based on the colorscheme, you # MUST enable the gtk configuration option. In addition, you should define # a gtk template (a gtkrc file to read from) and an output (the file to set the # theme to) # # WARNING: GNOME DOES NOT ALLOW FOR MONITOR SPECIFIC GTK THEMES. ONLY ENABLE # THIS OPTION ON ONE (1) MONITOR. # # enable 0 # template /home/user/.themes/Wallie1/gtk-2.0/gtkrc.template # output /home/user/.themes/Wallie1/gtk-2.0/gtkrc # # -[ OPENBOX OPTIONS ]--------------------------------------------------------- # If you want to update your openbox configuration based on the colorscheme, you # MUST enable the ob configuration option. In addition, you should define # an openbox style template (a style file to read from) and an output (the file # to set the theme to) # # WARNING: OPENBOX DOES NOT ALLOW FOR MONITOR SPECIFIC STYLES. ONLY ENABLE # THIS OPTION ON ONE (1) MONITOR. # # enable 0 # template /home/user/.themes/Wallie1/openbox-3/themerc.template # output /home/user/.themes/Wallie1/openbox-3/themerc # # -[ URXVT OPTIONS ]----------------------------------------------------------- # # If you want to create urxvt (or other terminal backgrounds, you MUST enable # the urxvt option. # # If you leave 'enable' set to 0, you do not have to define any further urxvt # options. # # enable 0 # theme_op 10 # theme "tint" applied to the urxvt xpm background image # black_op 70 # black "tint" applied to the urxvt xpm background image # blur 5 # The amount of blur, this value is the sigma of the blur # dir /dev/shm/walls # Where to store urxvt xpm background images. # # -[ LAYOUT OPTIONS ]---------------------------------------------------------- # # by enabling the mangle option, you are telling the script to generate a # formatted background with a preview of the next photo. This takes a good # chunk of resources to complete. If you leave this option commented out, the # script will act like a normal wallpaper changer. # If you leave 'enable' set to 0, you do not have to define any further layout # options for this display. # # enable 0 # bordersize 2 # tbar_height 26 # the height of the area at the top of the screen to format # rbar_width 342 # the width of the stats area created at the right side # # The collage is a preview of the next photo to be displayed as your background, # it paints a sort of set of stacked photographs at the bottom right of your # background. It's a neat effect, but can triple the amount of ram needed to # generate new background. # # If you leave 'enable' set to 0, you do not have to define any further collage # options for this display. # # enable 0 # container !315x250 # This is the maximum allowed size of the collage. # photo !265x200 # This is the size of individual photos in the collage. # font is the full pathname to a truetype font to use when displaying the next # image text. size is the size of point of that font. content is the text to # be actually rendered. x and y refer to the location of that text, in respect # to the bottom right corner. # # font /usr/share/fonts/TTF/aquafont.ttf # size 15 # x 30 # y 270 # content " ... the next background will be ... " # # border1 is a reference to the inside border of photographs in the collage. # The default is a 5 pixel border in white. border2 is the outermost border of # photographs in the collage. The default is a 1 pixel grey border. # # geo 5x5 # color white # # # geo 1x1 # color grey40 # # # END