a simple cli application to start a background image slideshow using 'feh'.
Go to file
2023-11-27 12:28:25 +01:00
.vscode implemented variable 'SLIDESHOW_TMPFILE' to lower memory consumption 2023-11-27 12:28:25 +01:00
images initial commit 2023-11-16 15:26:24 +01:00
internal implemented variable 'SLIDESHOW_TMPFILE' to lower memory consumption 2023-11-27 12:28:25 +01:00
scanner code cleanup 2023-11-24 16:52:11 +01:00
.gitignore fixed .gitignore 2023-11-16 15:29:55 +01:00
go.mod extended service, tidied up 'go.mod' 2023-11-23 16:59:13 +01:00
go.sum extended service, tidied up 'go.mod' 2023-11-23 16:59:13 +01:00
LICENSE.md initial commit 2023-11-16 15:26:24 +01:00
main.go code cleanup 2023-11-24 16:52:11 +01:00
README.md implemented variable 'SLIDESHOW_TMPFILE' to lower memory consumption 2023-11-27 12:28:25 +01:00
slideshow.service extended service, tidied up 'go.mod' 2023-11-23 16:59:13 +01:00

slideshow

a simple cli application to start a background image slideshow using 'feh'.

requirements

configuration

configuration is entirely done via environment variables.

variable default description
SLIDESHOW_INTERVAL 60 the interval of the slideshow in seconds
SLIDESHOW_DIRECTORY "$HOME" path to a directory containing images
SLIDESHOW_SCANINTERVAL 60 the interval for directory scans in seconds
SLIDESHOW_TMPFILE path to a temporary file
SLIDESHOW_RESOLUTION the resolution to which images are scaled (i.e. 1920x1080)
SLIDESHOW_PALETTE path to a file where the color palette will be stored
SLIDESHOW_PALETTE_ALGORITHM "wsm" the algorithm used to generate the color palette
SLIDESHOW_PALETTE_COLORS 16 the amount of colors generated
SLIDESHOW_LOGLEVEL "info" the log level

note:

  • if SLIDESHOW_RESOLUTION is unset the images will be displayed as they are (without any scaling).
  • if SLIDESHOW_TMPFILE is set a temporary file will be used instead of keeping the image internally buffered. this could be useful on systems with limited ram.

available log levels:

  • debug
  • info
  • warning
  • error
  • fatal

color palette

available algorithms:

  • wsm
  • wu

for more information regarding the color palette see color-thief.