Cetus is a simple wallpaper setting tool written in Go https://andinus.nand.sh/cetus
Go to file
Andinus 83754e3a06
Add an entry to Tested on in README
Tested the latest binary on OpenBSD 6.7 with i3wm.
2020-06-17 23:15:13 +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 Update drone ci config 2020-04-24 19:53:42 +05:30
cache Add Dir func on darwin systems 2020-04-24 20:30:09 +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 Update email in license 2020-04-24 20:25:55 +05:30
README.org Add an entry to Tested on in README 2020-06-17 23:15:13 +05:30
apod.go Move app func to main 2020-04-24 19:52:18 +05:30
bpod.go Move app func to main 2020-04-24 19:52:18 +05:30
env.go Move app func to main 2020-04-24 19:52:18 +05:30
go.mod Upgrade to lynx v0.4.0 2020-04-24 19:46:49 +05:30
go.sum Upgrade to lynx v0.4.0 2020-04-24 19:46:49 +05:30
main.go Bump version to v0.6.9 2020-04-24 20:30:53 +05:30
parseargs.go Change APOD timezone to UTC - 8 2020-04-24 20:19:39 +05:30
usage.go Move app func to main 2020-04-24 19:52:18 +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 supports 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.7
  • 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