atongen / flickpaper

A Flickr app that sets your GNOME wallpaper to a recent interesting photo

Flickpaper

A Ruby Gem and Flickr App that sets your Linux or OSX wallpaper to a recent interesting photo.

For linux, it works under Gnome and window managers that use feh to update the desktop wallpaper.

Does not (and will likely never) work under MS Windows.

Installation

Install the gem:

$ gem install flickpaper

Or add this line to your application's Gemfile:

gem 'flickpaper'

And then execute:

$ bundle

Usage

Usage: $ flickpaper [options]
    -d, --dump PATH                  Dump file for used photo ids. Default: $HOME/.flickpaper.dump
    -i, --image PATH                 Where to store the downloaded image. Default: $HOME/.flickpaper.jpg
    -l, --log PATH                   Path to log file. Default: STDOUT
    -p, --per-page PER_PAGE          Number of interesting photos per page in flickr api call. Default: 100
        --date DATE                  A specific date, formatted as YYYY-MM-DD, to return interesting photos for. Default: null (most recent)
        --page PAGE                  The page of results to return. Default: 1
    -s, --size SIZE                  Minimum acceptable image size. Default: Large 2048
    -v, --verbose                    Be verbose.
        --sizes                      Print sizes and exit.
        --version                    Show version and exit.

Use with cron to periodically get a new interesting desktop wallpaper.

Most of the time you are using a ruby switcher (rvm, rbenv, chruby, etc), which means you will want a way to call the correct gem executable via cron. A script similar to this will work for chruby. You would need to adapt it for your ruby switcher and ruby version.

#!/bin/bash

source /usr/local/share/chruby/chruby.sh
chruby ruby-2.2.0
FLICKPAPER=`which flickpaper`
if [ ! -z "$FLICKPAPER" ]; then
  $FLICKPAPER
fi

And something similar to this in your crontab:

# m h  dom mon dow   command
27 * * * * DISPLAY=:0.0 XAUTHORITY=/home/atongen/.Xauthority /home/atongen/bin/flickr_wallpaper.sh

Contributing

1. Fork it ( https://github.com/atongen/flickpaper/fork )
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request