path: root/README.org

#+TITLE: Cetus

Cetus is a wallpaper setting tool written in Go. This is a work in-progress.

* Dependency
** [[https://feh.finalrewind.org/][feh]]
Required to set the wallpaper.
* Examples
** Image of the Day
*** Astronomy Picture of the Day
#+BEGIN_SRC sh
cetus -apod -apod-api=https://api.nasa.gov/planetary/apod \
      -apod-api-key=DEMO_KEY
#+END_SRC
** Set given wallpaper
#+BEGIN_SRC sh
# Local image as wallpaper
cetus -img-path=/path/to/img

# Remote image as wallpaper
cetus -img-path=http://127.0.0.1
#+END_SRC

* Features
** Supports various Image of the Day services
There are several Image of the Day services on the web, cetus will pull the
latest image & set it as wallpaper.
*** DONE [[http://apod.nasa.gov/apod/astropix.html][Astronomy Picture of the Day]]
** DONE Set given wallpaper
Takes a path as input & sets it as wallpaper.