logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

gtklock - GTK-based lockscreen for Wayland

Authors

       Maintained by Jovan Lanik <jox969@gmail.com>, who is assisted by other contributors. For more information
       about gtklock development, see <https://github.com/jovanlanik/gtklock>.

                                                   2025-02-24                                         gtklock(1)

Configuration

       Configuration is stored in glib key file format. Options are specified as name=value and can be used from
       the command-line as --name=value. All options should be under the main group.

       All available options are:

       -g,--gtk-theme <string>
           Set the GTK theme.

       -s,--style <path>
           Load CSS style file.

       -x,--layout <path>
           Load XML layout file.

       -m,--modules <name>
           Load gtklock modules. Module name can be an absolute path, relative path (starting with ./ or ../) or
           name in system directory (such as example-module.so for /usr/lib/gtklock/example-module.so). The  .so
           suffix can be ommited.

       -b,--background <path>
           Load background. Specified background can be overwritten by CSS.

       -t,--time-format <string>
           Set time format. See date(1).

       -d,--date-format <string>
           Set date format. See date(1).

       -f,--follow-focus
           Follow focus between monitors. May not work for all compositors, recommended for hyprland.

       -H,--idle-hide
           Hide input form when idle.

       -T,--idle-timeout <int>
           Idle timeout in seconds.

       -S,--start-hidden
           Start with input form hidden.

       -L,--lock-command
           Command to execute after locking. Command is executed asynchronously.

       -U,--unlock-command
           Command to execute after unlocking. Command is executed asynchronously.

       -M,--monitor-priority <name>
           Set monitor focus priority. Option can be specified multiple times.

Example

       Example config:

           [main]
           gtk-theme=Adwaita-dark

       Example style:

           window {
              background-image: url("background.png");
              background-size: cover;
              background-repeat: no-repeat;
              background-position: center;
              background-color: black;
           }

Name

       gtklock - GTK-based lockscreen for Wayland

Options

-h,--help
           Show help options

       --help-config
           Show options available in the config. See CONFIGURATION.

       -d,--daemonize
           Detach from controlling terminal.

       -c,--config <path>
           Specify  config  file  to  use.  By  default, the following paths are checked in the following order:
           $XDG_CONFIG_HOME/gtklock/config.ini and gtklock/config.ini under each directory in $XDG_CONFIG_DIRS.

Synopsis

       gtklock [options...]

See Also