refresh-pinboard - changes as GUI of set-wallpaper the wallpaper or the whole wallpaper folder for the desktop background and can be used also to repair the desktop (provided by Starbuntu)

refresh-pinboard [-f|--fix] [<Image Source>] [<Period>] [ <Graphics mode> ]
refresh-pinboard -n|--next
refresh-pinboard -r|--repair

With the Starbuntu program refresh-pinboard which represents the graphical front-end of the Starbuntu program set-wallpaper you can change the wallpaper of the deaktop or the folder with the wallpapers or simply to the next wallpaper of the current image folder.

A file selection box gets opened, with which you can choose a new wallpaper or a new wallpaper folder as well as the graphics mode (centred | fit | scaled | stretched | tiled). If the chosen path is an image folder another entry field for the wallpaper period pops up. If you cancel or type a wrong entry the period remains as it was saved before. If you close the folder selection box by clicking 'Next', the desktop proceeds to the next wallpaper of the current wallpaper folder (hotkey: Ctrl+Super+Right). If you close it by pressing the Escape key there will be a reset of the desktop, for instance in case of being damaged (hotkey: Ctrl+Super+Escape).

In case you want to change the wallpaper path permanently please, after choosig it, click on 'Always'. After having set the graphics mode and the wallpaper period the new setting is saved in the file $HOME/.config/openbox/environment.

You can also call the program refresh-pinboard in a command line with the parameters [-f|--fix] [ <Image Source> ] [ <Period> ] [ <Graphics mode> ]. If you set "" for the image source it remains unchanged. Omitting the period preserves the previous saved one. With the parameter '-f' or '--fix' the wallpaper settings get saved. If you call the program only with the parameter '-n' resp. '-r' (or '--next' resp. '--repair') you change to the next wallpaper of the current image folder resp. you repair the desktop.

-f, --fix    saves the wallpaper settings
-n, --next  proceeds to the next wallpaper
-r, --repair  repairs the desktop

/usr/local/bin/refresh-pinboard
/usr/local/bin/set-wallpaper
$HOME/.config/openbox/environment

wallpaper = a new wallpaper or a new wallpaper folder
duration = the wallpaper period in sec.
(both variables in $HOME/.config/openbox/environment)

Peter Starfinger <info@die-starfingers.de>

Starbuntu program set-wallpaper