tschwery/alock
Archived
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
This repository has been archived on 2025-02-01. You can view files and clone it, but cannot push or open issues or pull requests.
40 commits 1 branch 0 tags 891 KiB
C 93.8%
Python 4.4%
Makefile 1.8%
Find a file
mathias 83cf2e7a88 * lock all screens when X runs in multiscreen mode and display whatever the 
-bg defines

--HG--
extra : convert_revision : svn%3Aeebe1cee-a9af-4fe4-bd26-ad572b19c5ab/trunk%4040
2006-05-05 00:41:21 +00:00
bitmaps * lock all screens when X runs in multiscreen mode and display whatever the 2006-05-05 00:41:21 +00:00
contrib * minor error in contrib/README 2005-06-22 17:58:26 +00:00
src * lock all screens when X runs in multiscreen mode and display whatever the 2006-05-05 00:41:21 +00:00
alock.txt * lock all screens when X runs in multiscreen mode and display whatever the 2006-05-05 00:41:21 +00:00
CHANGELOG * lock all screens when X runs in multiscreen mode and display whatever the 2006-05-05 00:41:21 +00:00
LICENSE * license is : MIT 2005-05-18 10:29:02 +00:00
README * lock all screens when X runs in multiscreen mode and display whatever the 2006-05-05 00:41:21 +00:00
scons_alock.py * added sha256,sha384 and sha512 2005-12-25 09:30:25 +00:00
SConstruct * added sha256,sha384 and sha512 2005-12-25 09:30:25 +00:00

README 

alock - README
==============
Mathias Gumz <akira@fluxbox.org>
v1.0, 05 May 2006

About
-----
'alock' locks your current session in X. It's not a full featured
screensaver distribution like 'xlockmore' or 'xscreensaver', but just a
tiny locker: "uh, i need coffee .. so i need a lock" .. 
You can modify the way you have to authenitificate yourself, the way the
mousepointer looks when you locked the display and the way the content of
the display is handled. Eg: with -bg none you can see whats going on, 
even when you are not able to modify what you see, which might be pretty 
usefull for public terminals where a demo should run but noone should
press any buttons or keys (you know those little kids ... )

Installation
------------
To install / compile 'alock' you need 'scons':

* link:http://www.scons.org[scons]

It's a clever buildsystem which i prefer over make/autotools. Be sure you
grab the latest (0.96.90) version installed to avoid problems at install-time.
After installing 'scons' you just type:

    $> scons

and it should build your personal version of 'alock'.
You can influence the build-process by some variables, check

    $> scons -h

To install it finally to your system use:

    $> scons install

and thats it.
If you grabed a svn-version (not a release-tarball) you also need
'asciidoc' and 'xmlto' to create the documentation-files:

* link:http://www.methods.co.nz/asciidoc/[AsciiDoc]
* link:http://cyberelk.net/tim/xmlto/[xmlto]

Tested platforms (so far):

* gentoo-linux (pc and ppc with gcc3.4.3) 
* freebsd5.3 (pc gcc3.4.2)
* slackware (pc, gcc3.3.5, shadow)

Usage
-----
You find more info about how to use 'alock' in the alock-documentation:

    $> less alock.txt
    $> man alock
    $> firefox alock.html

History
-------
An irc-buddy of mine (izhirahider) was using 'xtrlock' and had some
problems with it .. no wonder, development stopped some years ago
and it doesnt support 'pam'. Since i liked the minimalism of 'xtrlock' 
but wanted to add some minor things to it i forked 'alock' from
'xtrlock' and modified it a bit :) At the moment there is almost no code
from 'xtrlock' left.

Author / Contributors
---------------------
* 2005 - 2006 Mathias Gumz aka akira <akira@fluxbox.org> (code)
* 1993 - 1994 Ian Jackson (xtrlock)

* 2005        Tenner (alock-logo)
* 2001-2005   Fluxbox-Team (fluxbox-logo)
* 2005        Pekwm-Team (pekwm-logo)