desktop-tools/README.adoc

69 lines
2.7 KiB
Plaintext
Raw Normal View History

desktop-tools
=============
:compact-option:
'desktop-tools' is a collection of tools to run my desktop that might be useful
to other people as well:
- 'wmstatus' does literally everything i3/sway don't but I'd like them to.
It includes PulseAudio volume management and custom-made NUT and MPD clients,
all in the name of liberation from GPL-licensed software, of course
- 'paswitch' displays a list of all PulseAudio sinks and ports and allows
switching between them, moving all playing inputs
2017-07-05 03:09:23 +02:00
- 'brightness' allows me to change the brightness of w/e display device I have
- 'input-switch' likewise switches the input source of external displays
2016-01-22 08:56:34 +01:00
- 'fancontrol-ng' is a clone of fancontrol that can handle errors on resume
from suspend instead of setting fans to maximum speed and quitting;
in general it doesn't handle everything the original does
2017-07-06 12:45:58 +02:00
- 'priod' sets process CPU, I/O and OOM killer priorities automatically
according to configuration
2016-01-22 08:59:58 +01:00
- 'shellify' is a simple script that sets up a shell for commands like vgdb
and nmcli that are painfully lacking it
2017-07-06 12:45:58 +02:00
- 'iexec' runs a program and attempts to restart it cleanly when the
executable file is replaced on the disk
2016-01-27 20:22:49 +01:00
- 'gdm-switch-user' tells the running GDM daemon, if any, to show the switch
user screen
- 'siprandom' uses the SipHash 2-4 algorithm to produce a stream of
pseudo-random data; it should be fast enough to saturate most devices
- 'big-brother' tracks the title of the active window and the idle state of
the user and writes these events to standard output.
Few of them are useful outside of Linux.
2016-03-10 21:55:15 +01:00
Packages
--------
Regular releases are sporadic. git master should be stable enough.
2016-03-10 21:55:15 +01:00
Building
--------
Build dependencies: CMake, pkg-config, liberty (included) +
2017-05-14 19:33:59 +02:00
Runtime dependencies: libpulse, libx11, dbus-1, libgdm (optional)
2018-06-24 03:14:39 +02:00
$ git clone --recursive https://git.janouch.name/p/desktop-tools.git
$ mkdir desktop-tools/build
$ cd desktop-tools/build
$ cmake .. -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Debug
$ make
To install the applications, you can do either the usual:
# make install
Or you can try telling CMake to make a package for you. For Debian it is:
$ cpack -G DEB
# dpkg -i desktop-tools-*.deb
Contributing and Support
------------------------
2018-06-24 03:14:39 +02:00
Use https://git.janouch.name/p/desktop-tools to report bugs, request features,
or submit pull requests. `git send-email` is tolerated. If you want to discuss
the project, feel free to join me at ircs://irc.janouch.name, channel #dev.
2018-06-24 03:14:39 +02:00
Bitcoin donations are accepted at: 12r5uEWEgcHC46xd64tt3hHt9EUvYYDHe9
2017-05-14 19:33:59 +02:00
License
-------
This software is released under the terms of the 0BSD license, the text of which
is included within the package along with the list of authors.