andinus/cetus
andinus
/
cetus
1
0
Fork 0
Code Issues Pull Requests Releases Activity
Cetus is a simple wallpaper setting tool written in Go https://andinus.nand.sh/cetus
152 Commits 1 Branch 28 Tags 228 KiB
Go 92.8%
Shell 7.2%
Go to file
Andinus 202c8a1380
continuous-integration/drone/push Build is passing Details
Switch to lynx & remove custom unveil wrappers 		2020-04-06 14:59:25 +05:30
apod Add test for RandDate func 2020-03-26 15:31:00 +05:30
background Add background package 2020-03-24 18:35:27 +05:30
bpod bpod: Re-enable cache & fix issues with v0.6.2 2020-04-02 13:29:29 +05:30
build/ci Add vet to pipeline 2020-04-02 13:34:56 +05:30
cache Fix unveil rules 2020-04-04 21:59:01 +05:30
cmd/cetus Switch to lynx & remove custom unveil wrappers 2020-04-06 14:59:25 +05:30
notification Add apod support & fix errors 2020-03-25 00:13:51 +05:30
request Add apod support & fix errors 2020-03-25 00:13:51 +05:30
scripts Update install instructions to v0.6.4 2020-04-04 19:36:02 +05:30
LICENSE Initial commit 2020-03-11 19:53:02 +05:30
README.org Add note explaning broken behaviour on OpenBSD 2020-04-05 23:37:12 +05:30
go.mod Switch to lynx & remove custom unveil wrappers 2020-04-06 14:59:25 +05:30
go.sum Switch to lynx & remove custom unveil wrappers 2020-04-06 14:59:25 +05:30

README.org

Cetus

Cetus is a simple wallpaper management tool written in Go. It supports multiple sources for fetching the background. Currently it suports NASA Astronomy Picture of the Day & Bing Photo of the Day.

Project Home Cetus
Source Code Andinus / Cetus
GitHub (Mirror) Cetus - GitHub
Demo Video
Cetus v0.6.0
Cetus v0.6.0 Demo on macOS

Dependency: feh (optional), libnotify (optional)

It supports GNOME, Unity, LXDE, Pantheon & WM/DE similar to i3wm (including i3wm).

Tested on:

  • OpenBSD 6.6 with i3wm (with unveil)
  • Lubuntu 18.04 with LXDE
  • macOS Catalina 10.15.3

Examples

Run cetus help to get the usage printed & cetus <command> <service> -help to get the flags for that particular service.

# set today's image as background
cetus set <service>  # <service>: apod, bpod

# set a random apod image as background
cetus set apod -random

# send a desktop notification
cetus <command> <service> -notify # <command>: set, fetch

# don't set background but fetch the information
cetus fetch <service>

# print details in terminal
cetus <command> <service> -print

# print and notify
cetus <command> <service> -print -notify

Installation

Pre-built binaries

Pre-built binaries are available for OpenBSD, FreeBSD, NetBSD, DragonFly BSD, Linux & macOS.

If you don't understand what this command does then don't run it. It doesn't download the binary, it will just print the steps to install cetus & you have to run those commands manually.

v0.6.4

Note for OpenBSD users: If you are using GNOME, Unity, LXDE or Pantheon then this version may not work, due to unveil. This probably has been fixed in v0.6.7, compile it.

curl -s https://tildegit.org/andinus/cetus/raw/tag/v0.6.4/scripts/install.sh | sh

v0.6.0

Warning: Don't use random flag on BPOD, it has been disabled in v0.6.1 but v0.6.0 will cause issues if random flag is used with BPOD. This was fixed in newer versions.

cetus set bpod -random # don't do this

curl -s https://tildegit.org/andinus/cetus/raw/tag/v0.6.0/scripts/install.sh | sh