Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/sergei-mironov/xscreensaver-run

Run the screensaver from XScreenSaver collection synchronousely in the fullscreen
https://github.com/sergei-mironov/xscreensaver-run

c linux make nixos x11 xscreensaver

Last synced: 5 days ago
JSON representation

Run the screensaver from XScreenSaver collection synchronousely in the fullscreen

Awesome Lists containing this project

README

        

Xscreensaver-run
================

This tiny program may be used to run screensavers from
[XScreenSaver](https://www.jwz.org/xscreensaver/) collection synchronously,
in fullscreen and without additional effects like screen locks or timers.

See also

Build
-----

Just make install

$ make install

NixOS users may use the following commands to install the application in the
current user's profile:

$ nix-build
$ nix-env -i ./result

Usage
-----

Run any screensaver from Xscreensaver collection by typing `xscreensaver-run
SCREENSAVER_APP_ARGS`. For example:

$ ./xscreensaver-run /usr/libexec/xscreensaver/apple2 -text -program 'uname -a'

Enjoy!

Development notes
-----------------

### Environment

To test the application in Nix:

1. `$ nix-shell`
2. `(shell) $ nix-build '' -A pkgs.xscreensaver`
3. `(shell) $ make`
4. `(shell) $ ./xscreensaver-run ./result/libexec/xscreensaver/apple2 -text`

### Hints

* To reset root window's cursor (just in case): `xsetroot -cursor_name left_ptr`

### References

* [X Event definitions](https://fossies.org/dox/tightvnc-1.3.10_unixsrc/X_8h.html)
* [X Event documentation](https://tronche.com/gui/x/xlib/events/processing-overview.html)
* https://linux.die.net/man/3/xwindowevent
* https://linux.die.net/man/3/xgrabkeyboard

Bugs?
-----

Yes! Check FIXMEs in the source code. Feel free to fix them and file PRs!