Skip to content

Latest commit

 

History

History
74 lines (60 loc) · 1.91 KB

README.md

File metadata and controls

74 lines (60 loc) · 1.91 KB
Raw

XRootGIF xrootgif

A simple program for setting animated wallpapers, targeting performance

Usage

Usage: ./xrootgif d:S:s:apt:TqQh [image]
  -d | --display [display]
       X-Display to use (:0), if none, use default display
  -S | --screen [num]
       X-Screen to use, if none, use default screen
  -s | --speed [float]
       Playback speed as float
  -a | --anti-alias
       Use anti-aliasing
  -p | --performance
       Performance mode - scale framerate to 5 (default)
  -t | --target-fps [float]
       In performance mode, set target framerate
  -T | --test-pattern
      A little test pattern used for developing
  -q | --quiet
       Only print basic information
  -Q | --Quiet
       No output
  --scale-per-monitor
       Scales the image on each monitor (default)
  --scale-across-monitor
       Scales the image across all monitors
  --daemon
       After loading the image, fork of a daemon and exit
  --version
       Print version
  -h | --help

Performance

This Program grew out of the pain, that most GIF-Viewer consume quiet some CPU time, so having a GIF as wallpaper somewhat drained the battery. XRootGIF tries to minimize CPU time used to display fancy GIFs, by pre rendering all frames and allocating them in the X-Display instance. Some GIFs may still make your PC heat your room, but this can be avoided by using the performance mode, which will simply downscale the framerate.

Planned features

  • more image fitting modes
  • configuration files
  • other animation formats (webm, apng, ...)

Building

The following libraries are used by XRootGIF:

  • libx11
  • giflib
  • imlib2
  • (libXrandr)

Tools:

  • gcc
  • meson
  • ninja

To compile, simply run

meson build && cd build && ninja

You can disable multimonitor support by changing 'multimonitor_feature' in meson_options.txt