summary refs log tree commit diff stats
path: root/README.org
blob: 8543467d910d1d274b8f7abab8c16c8d268e6e67 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
#+TITLE: Cetus

Cetus is a wallpaper tool written in Go. It can set wallpapers from various
sources. Default behaviour is to set a random wallpaper.

* Defaults
| flag   | var    | default                                   |
|--------+--------+-------------------------------------------|
| mode   | mode   | random (daily when random is unavailable) |
| src    | src    | random                                    |

Currently only Unsplash Source random is supported for width, height
| width  | width  | 1920 |
| height | height | 1080 |
** Astronomy Picture of the Day
| flag         | var        | default                             |
|--------------+------------+-------------------------------------|
| apod-api     | apodAPI    | https://api.nasa.gov/planetary/apod |
| apod-api-key | apodAPIKey | DEMO_KEY                            |
| mode         | mode       | daily                               |
** Bing Photo of the Day
| flag     | var     | default                                  |
|----------+---------+------------------------------------------|
| bpod-api | bpodAPI | https://www.bing.com/HPImageArchive.aspx |
| bpod-num | bpodNum | 16                                       |
** Unsplash Source
| flag         | var         | default                     |
|--------------+-------------+-----------------------------|
| unsplash-api | unsplashAPI | https://source.unsplash.com |
* Dependency
- [[https://feh.finalrewind.org/][feh]]
* Features
- Set Daily, Weekly or Random wallpaper
- Supports multiple sources
* Examples
** Daily wallpaper
*** from Astronomy Picture of the Day
#+BEGIN_SRC sh
cetus -src=apod -mode=daily
#+END_SRC
*** from Bing Photo of the Day
#+BEGIN_SRC sh
cetus -src=bpod -mode=daily
#+END_SRC
*** from Unsplash Source
#+BEGIN_SRC sh
cetus -src=unsplash -mode=daily
#+END_SRC
*** from any service (choosen randomly)
#+BEGIN_SRC sh
cetus -src=random -mode=daily

cetus -mode=daily # This is same as above
#+END_SRC
** Weekly wallpaper
*** from Unsplash Source
#+BEGIN_SRC shp
cetus -src=unsplash -mode=weekly
#+END_SRC
** Random wallpaper
*** from Bing Photo of the Day
#+BEGIN_SRC sh
cetus -src=bpod -bpod-num 16 -mode=random # select from last 16 images

cetus -src=bpod # This is same as above
#+END_SRC
*** from Unsplash Source
#+BEGIN_SRC sh
cetus -src=unsplash -mode=random -width 1920 -height 1080

cetus -src=unsplash # This is same as above
#+END_SRC
*** from any service (choosen randomly)
#+BEGIN_SRC sh
cetus -src=random -mode=random

cetus # This is same as above
#+END_SRC