/animwall

Animated wallpapers for Linux

Primary LanguageShellGNU General Public License v2.0GPL-2.0

animwall

An orchestrator using xwinwrap and mpv to launch animated/gif desktop wallpapers

What is this for

For fun and because I like animated wallpapers.

Usage

$ animwall start

Ok, fine it's not that simple. You'll need a conf file, located at XDG_CONFIG_HOME/animwall.conf to properly run the script. The script will create an example file in the proper format for you on first run if you do not already have a conf file.

The format of the file is as follows: /path/to/wallpaper:WxH+X+Y

The path and monitor geometry are separated by a :. Each pair will be parsed by the script as a configuration and it will output the animated wallpaper found at path to the monitor geometry described by WxH+X+Y. The monitor geometry syntax is enforced by xwinwrap.

Multiple configurations can be specified in the same file, separated by some whitespace. A whitespace inside of a configuration section will not be parsed correctly!

By default, animwall runs with nice 19 making it the lowest priority to reduce resource usage. If you find mpv is not fast enough at nice 19, you can edit the script to lower this number. It may increase CPU usage.

This script is dumb. It will not auto stop when a window covers the wallpaper or anything fancy like that.

Subcommands

  • start
  • stop
  • restart

License

GPLv2

  The GPLv2 License

    Copyright (C) 2020  Peter Kenji Yamanaka

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License along
    with this program; if not, write to the Free Software Foundation, Inc.,
    51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.