Skip to content
/ bgur Public

Desktop background wrapping Imgur favourites folders

License

Notifications You must be signed in to change notification settings

m1cr0man/bgur

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

bgur - Desktop backgrounds without the effort

Have you got a massive collection of desktop backgrounds favourited on imgur? Time to throw them into a folder and let bgur do the magic to set them as your background.

Features

  • Set desktop background from imgur (you'd hope so at least. Macs untested)
  • Randomise backgrounds with anti-repeat logic
  • minratio + maxratio options to ignore mobile oriented photos on desktop
  • Syncing! Uses imgur, an album, and your own account - so no GDPR shenanigans
  • Caching so that it doesn't kill imgur (offline coming soon)

Usage

  • If you don't have one already, set up a favourites folder on imgur with all your desktop backgrounds. Call it Desktop Backgrounds (optional). It can be a mix of private images, public images and albums.
  • Alternatively, you can use a friend's folder. See the -folder-owner and -folder-name options
  • Install and run bgur
go get github.com/m1cr0man/bgur
go build -o bgur github.com/m1cr0man/bgur/cmd/bgur
chmod +x bgur # linux users
  • Run bgur (basic usage)
./bgur -sync

Advanced usage

You can run bgur -h to get all the options correct to the version you installed. I have to update the below list manually, but if you are lazy you can reference this.

Usage of ./bgur:
  -change-interval int
        Minutes between background changes. Default is 12 hours (default 720)
  -folder-name string
        Name of the folder to pull desktop backgrounds from (default "desktop backgrounds")
  -folder-owner string
        Username who owns the backgrounds folder. Defaults to you
  -force-change
        Force a background change now. Overrides expiry
  -max-ratio int
        Maximum ratio of width:height, in percent. Use this for vertical screens, overrides minRatio
  -min-ratio int
        Minimum ratio of width:height, in percent. For example 160 which is 16:10
  -refresh-cache
        Refresh list of images from the folder on Imgur
  -seed int
        Seed to use for shuffling the folder. Set to 0 to skip shuffling (default 1577751173)
  -sync
        Sync state to Imgur so that the same backgrounds appear on other computers

TODO

  • Auto building of the project
  • Logo
  • Work offline properly
  • A web UI, because not everyone is a CLI hero. This will not be an electron app.