i3lock(1)                        User Manuals                        i3lock(1)




<?><?><?> (NAME)
       i3lock - <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?>


<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       i3lock [-v] [-n] [-b] [-i image.png] [-c color] [-t] [-p pointer] [-u]
       [-e] [-f]


<?><?><?><?><?><?> <?><?><?><?><?><?><?><?> (RECOMMENDED USAGE)
       xss-lock --transfer-sleep-lock -- i3lock --nofork

       <?><?><?><?><?><?><?> <?><?> xss-lock <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> (suspend) <?><?><?> <?><?><?>.

       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> systemd <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?> <?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>.


<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?><?> i3lock <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> slock
       <?><?><?>. <?><?> <?><?> <?><?><?><?> <?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>
       (<?><?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>).
       <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?>.


<?><?><?><?><?><?><?> (IMPROVEMENTS)
       o <?><?><?><?><?><?> i3lock <?><?><?><?><?><?> <?><?> <?><?><?><?>
         (<?><?><?><?><?><?>) <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
         <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?> <?><?><?>
         <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> RAM
         <?><?><?><?><?> <?><?><?><?> (<?><?><?><?><?> "i3lock && echo mem >
         /sys/power/state" <?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?>
         <?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?>
         <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>).

       o <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?>
         <?><?> <?><?> <?><?><?><?><?> PNG <?><?><?><?><?> <?><?><?><?> <?><?>
         <?><?> <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
         <?><?><?><?><?> <?><?><?><?> <?><?><?>.

       o <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
         <?><?><?> i3lock <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
         <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>
         <?><?><?><?> <?><?> <?><?><?>.

       o <?><?><?><?><?><?> i3lock <?><?> PAM <?><?><?><?><?><?><?>
         <?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?> <?><?> LDAP <?>
         <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
         <?><?><?>.



<?><?><?><?><?><?><?><?> (OPTIONS)
       -v, --version
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> i3lock


       -n, --nofork
              <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> (<?><?><?><?><?><?>)
              <?><?><?><?><?><?><?>.


       -b, --beep
              <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?>.
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
              (<?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?>)<?> <?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?>.


       -u, --no-unlock-indicator
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?>. <?><?><?><?><?><?> i3lock
              <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?>
              <?><?><?><?><?> <?><?><?><?> PAM <?><?> <?><?><?><?>
              <?><?><?><?><?><?> (<?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?>
              <?><?><?>).


       -i path, --image=path
              <?><?><?><?><?> <?><?><?><?><?> PNG <?><?><?><?><?><?><?><?>
              <?><?> <?><?><?> <?><?> <?><?><?><?> <?><?><?><?>.


       --raw=format
              <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> --image
              <?><?> <?><?> <?><?><?> PNG <?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?> (raw) <?><?><?><?><?><?><?><?>.
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?> <width>x<height>:<pixfmt>
              <?><?><?>. <?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?>: 'native', 'rgb', 'xrgb', 'rgbx', 'bgr', 'xbgr' <?>
              'bgrx'.  <?><?><?><?> <?><?><?><?><?> "native"
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?> (<?> <?><?><?><?><?>) <?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?> <?> <?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?>. <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?> <?> <?><?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.

              <?><?><?><?>:
                   --raw=1920x1080:rgb

              <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> convert(1)
              <?><?><?><?><?> <?><?> ImageMagick <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?> <?><?> i3lock <?><?><?><?><?><?><?>
              <?><?><?><?>:

                   convert wallpaper.jpg RGB:- | i3lock --raw 3840x2160:rgb --image /dev/stdin

              <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?> i3lock <?><?><?><?><?><?> <?><?>
              <?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>.


       -c rrggbb, --color=rrggbb
              <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>.
              <?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?> <?><?><?><?><?>
              rrggbb <?><?><?><?><?> <?><?><?> (<?><?><?><?><?> ff0000
              <?><?><?><?> <?><?><?>).


       -t, --tiling
              <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
              (<?><?> <?><?><?><?> -i)<?> <?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> (<?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?>).


       -p win|default, --pointer=win|default
              <?><?><?> <?><?><?><?><?> "default" <?><?> <?><?><?><?>
              <?><?><?><?><?> i3lock <?><?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?> "win" <?><?>
              <?><?><?><?><?> <?><?><?><?><?> i3lock <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> (<?><?>
              <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?>).


       -e, --ignore-empty-password
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.
              <?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?> <?><?> PAM <?><?><?><?><?> <?><?><?><?><?><?> <?>
              <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?>
              <?><?> <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?>. <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?>
              <?><?><?><?> XF86ScreenSaver <?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?> Enter <?><?><?><?><?> <?><?><?>.


       -f, --show-failed-attempts
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>.


       -k, --show-keyboard-layout
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?>.


       --debug
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
              (debug) <?><?> <?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> (stdout) <?><?><?>
              <?><?><?><?><?><?>.


<?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> (DPMS)
       <?><?><?><?><?> -d (--dpms) <?><?> <?><?><?><?> 2.8 <?><?> i3lock
       <?><?><?> <?><?>. <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>. <?><?>
       <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> i3 <?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>.

       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> DPMS
       <?><?><?><?> <?><?> <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?>:

            #!/bin/sh
            revert() {
              xset dpms 0 0 0
            }
            trap revert HUP INT TERM
            xset +dpms dpms 5 5 5
            i3lock -n
            revert

       <?><?><?><?><?> -I (--inactivity-timeout=seconds) <?><?><?> <?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> DPMS
       <?><?><?><?> <?><?><?><?>.


<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       xss-lock(1) - <?><?><?><?><?> i3lock <?><?> <?><?><?><?> <?><?><?><?>
       systemd

       convert(1) - <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> i3lock


<?><?><?><?><?><?><?><?><?> (AUTHORS)
       Michael Stapelberg <michael+i3lock at stapelberg dot de>

Linux                            JANUARY 2012                        i3lock(1)