2021-06-30 14:35:39 +00:00
# Betterlockscreen
> fast and sweet looking lockscreen for linux systems with effects!
2019-02-09 23:25:01 +00:00
2021-06-30 14:35:39 +00:00
< div align = "center" >
< a href = "https://github.com/pavanjadhaw/betterlockscreen/releases" > < img alt = "GitHub release (latest by date including pre-releases)" src = "https://img.shields.io/github/v/release/pavanjadhaw/betterlockscreen?include_prereleases&label=latest&style=for-the-badge" > < / a >
< a href = "https://github.com/pavanjadhaw/betterlockscreen/releases" > < img alt = "GitHub release (latest by date)" src = "https://img.shields.io/github/v/release/pavanjadhaw/betterlockscreen?label=Stable&style=for-the-badge" > < / a >
2021-07-01 16:41:50 +00:00
< a href = "https://github.com/pavanjadhaw/betterlockscreen/actions/workflows/main.yml?query=branch%3Amaster" > < img alt = "GitHub Workflow Status (master)" src = "https://img.shields.io/github/workflow/status/pavanjadhaw/betterlockscreen/Main/master?label=master&style=for-the-badge" > < / a >
< a href = "https://github.com/pavanjadhaw/betterlockscreen/actions/workflows/main.yml?query=branch%3Anext" > < img alt = "GitHub Workflow Status (next)" src = "https://img.shields.io/github/workflow/status/pavanjadhaw/betterlockscreen/Main/next?label=next&style=for-the-badge" > < / a >
2021-08-09 21:11:04 +00:00
< a href = "https://github.com/pavanjadhaw/betterlockscreen/milestone/²" > < img alt = "GitHub milestone" src = "https://img.shields.io/github/milestones/progress/pavanjadhaw/betterlockscreen/2?style=for-the-badge" > < / a >
2021-08-21 00:18:26 +00:00
< a href = "https://github.com/pavanjadhaw/betterlockscreen/compare/v4.0.3-beta1...next" > < img alt = "GitHub commits since latest release (by date) for a branch" src = "https://img.shields.io/github/commits-since/pavanjadhaw/betterlockscreen/v4.0.3-beta1/next?style=for-the-badge" > < / a >
2021-06-30 14:35:39 +00:00
< a href = "https://github.com/pavanjadhaw/betterlockscreen/blob/master/LICENSE" > < img src = "https://img.shields.io/github/license/pavanjadhaw/betterlockscreen.svg?style=for-the-badge" > < / a >
< / div >
2019-02-09 23:25:01 +00:00
2021-06-30 14:35:39 +00:00
< div align = "center" >
< h2 > You want to support us?< / h2 >
2019-02-09 23:25:01 +00:00
2021-06-30 14:35:39 +00:00
< a href = "https://github.com/pavanjadhaw/betterlockscreen/stargazers" > < img alt = "GitHub Repo stars" src = "https://img.shields.io/github/stars/pavanjadhaw/betterlockscreen?style=social" > < / a >
< a href = "https://github.com/pavanjadhaw/betterlockscreen/fork" > < img alt = "GitHub forks" src = "https://img.shields.io/github/forks/pavanjadhaw/betterlockscreen?style=social" > < / a >
< a href = "https://www.codetriage.com/pavanjadhaw/betterlockscreen" > < img src = "https://www.codetriage.com/pavanjadhaw/betterlockscreen/badges/users.svg" > < / a >
< / div >
< br / >
2017-12-07 20:16:52 +00:00
2018-11-22 20:45:28 +00:00
![scrot2 ](https://github.com/pavanjadhaw/betterlockscreen.demo/raw/master/scrots/scrot2.png 'scrot2.png' )
2021-06-30 14:35:39 +00:00
< br / >
2017-12-07 20:16:52 +00:00
2018-09-18 18:40:52 +00:00
## Table of Contents
2018-01-03 05:04:25 +00:00
2021-06-30 14:35:39 +00:00
- [About ](#about )
- [How it works ](#how-it-works )
- [System Requirements ](#system-requirements )
- [Installation ](#installation )
- [Configuration ](#configuration )
- [Usage ](#usage )
- [Background ](#background )
- [Keybinding ](#keybindings )
- [Lockscreen on sleep/suspend with systemd ](#systemd )
2018-11-22 20:45:28 +00:00
2021-06-30 14:35:39 +00:00
## About
2018-11-22 20:45:28 +00:00
2021-06-30 14:35:39 +00:00
Most of i3lock wrapper-scripts out there take an image, add some effect(s) then lock with the modified image as locker-background. Overall experience doesn't feel natural given delay of 2-3 seconds.
2018-11-22 20:45:28 +00:00
2021-06-30 14:35:39 +00:00
> Who would like a delay of 2-3 seconds while locking screen?
2018-11-22 20:45:28 +00:00
2021-06-30 14:35:39 +00:00
So Betterlockscreen was my attempt to solve this problem, as we dont need to change lockscreen background frequently this script caches images with effect so overall experience is simple and as fast as native i3lock.
2018-01-03 05:04:25 +00:00
2021-06-30 14:35:39 +00:00
## How it works
2018-09-18 03:33:59 +00:00
2021-06-30 14:35:39 +00:00
The script takes a directory or image, adds various effects and caches the images in special directory. Those cached images will be used as locker-background depending on configuration provided by user.
2018-11-22 20:45:28 +00:00
2021-06-30 14:35:39 +00:00
## System Requirements
2018-09-18 03:33:59 +00:00
2021-06-30 14:35:39 +00:00
* [i3lock-color ](https://github.com/Raymo111/i3lock-color ) `>= 2.13.c.3`
* [ImageMagick ](https://imagemagick.org/ )
* xdpyinfo, xrandr, xrdb and xset from [X.Org ](https://www.x.org/ )
* (Optional) [Dunst ](https://dunst-project.org/ )
* (Optional) [feh ](https://feh.finalrewind.org/ ) for wallpaper-functionality
2018-09-18 03:33:59 +00:00
2021-06-30 14:35:39 +00:00
> Note: Make sure your system has all dependencies satisfied
2018-11-22 20:45:28 +00:00
2021-06-30 14:35:39 +00:00
## Installation
### Package Manager
2018-09-18 18:40:52 +00:00
2021-06-30 14:35:39 +00:00
< a href = "https://repology.org/project/betterlockscreen" >
< img src = "https://repology.org/badge/vertical-allrepos/betterlockscreen.svg" alt = "Packaging status" align = "right" >
< / a >
2017-12-15 02:22:48 +00:00
2021-06-30 14:35:39 +00:00
Betterlockscreen is available via package manager on some linux-distributions, if you miss your favorite one you can follow along with our [installation-script ](#installation-script ) or [manual-installation ](#manual-installation ).
2017-12-07 18:51:34 +00:00
2021-06-30 14:35:39 +00:00
If you are using **Arch Linux** , you can install the AUR package
[betterlockscreen ](https://aur.archlinux.org/packages/betterlockscreen/ ) to get the latest
version, or [betterlockscreen-git ](https://aur.archlinux.org/packages/betterlockscreen-git/ ) for the most up-to-date (unstable) changes.
2018-01-03 05:04:25 +00:00
2021-07-20 23:42:54 +00:00
If you are using **Gentoo Linux** , you can install `betterlockscreen` from Gentoo's [GURU overlay ](https://wiki.gentoo.org/wiki/Project:GURU ) using `emerge x11-misc/betterlockscreen` .
If you are using **NixOS** , [betterlockscreen ](https://search.nixos.org/packages?query=betterlockscreen ) is available in both the [stable ](https://github.com/NixOS/nixpkgs/blob/nixos-21.05/pkgs/misc/screensavers/betterlockscreen/default.nix ) and [unstable ](https://github.com/NixOS/nixpkgs/blob/nixos-unstable/pkgs/misc/screensavers/betterlockscreen/default.nix ) channels and can be installed using `nix-env -iA nixos.betterlockscreen` .
2018-11-19 14:56:55 +00:00
2021-07-20 23:42:54 +00:00
If you are using **Void Linux** , you can install [betterlockscreen ](https://github.com/void-linux/void-packages/blob/master/srcpkgs/betterlockscreen/template ) using `xbps-install -S betterlockscreen` .
2018-11-19 14:56:55 +00:00
2021-06-30 14:35:39 +00:00
### Installation Script
2018-01-03 05:04:25 +00:00
2021-06-30 14:35:39 +00:00
We have created an automatic [install-script ](https://github.com/pavanjadhaw/betterlockscreen/blob/master/install.sh ) for Betterlockscreen. The script is very simple and takes three parameters:
* `<install-mode>` : (string) 'user' installs to '~/.local/bin/', 'system' installs to '/usr/local/bin'
* `[<version>]` : (string) defaults to 'latest' which will determinate the latest tag from git or specified branch/tag
* `[<systemd-service>]` : (boolean) defaults to 'false' - Whether to copy and enable system-service.
2018-01-03 05:04:25 +00:00
2021-06-30 14:35:39 +00:00
For system-installation:
```sh
wget https://git.io/JZyxV -O - -q | bash -- system
```
2017-12-07 18:51:34 +00:00
2021-06-30 14:35:39 +00:00
For user-installation:
```sh
wget https://git.io/JZyxV -O - -q | bash -- user
```
2017-12-07 18:51:34 +00:00
2021-06-30 14:35:39 +00:00
Please note: The [git.io ](https://git.io/ )-URL is just a short-url for the [master/install.sh ](https://raw.githubusercontent.com/pavanjadhaw/betterlockscreen/master/install.sh ).
2017-12-07 18:51:34 +00:00
2021-06-30 14:35:39 +00:00
### Manual Installation
2017-12-24 04:33:52 +00:00
2021-06-30 14:35:39 +00:00
Ỳou can download the latest release [here ](https://github.com/pavanjadhaw/betterlockscreen/releases ), please ensure to fullfill the [system-requirements ](#system-requirements )!
Prepare to merge (#228)
* Fix loginbox position for vertical arrangements
* Fix tabs everywhere
* 110 Automatically deduce DPI
* 118 Add description for Void Linux installation
* 119 Add Timeout Option
* Update README for multi-monitor
* Keep original directory
* Update README
* Rename project files
* Always use defaults
* Rewrite update() and get_display_list()
* Add lock_timeout to defaults
* Fix ExecStart in systemd unit
* Update README
* Fix bad variable name in wallpaper()
* Remove quoting, it breaks things
* Fix paths and canvas color
* Effects now are optional to speed up updating cache
* Fix fx_dimblur()
* Add shadow to loginbox (#3)
* Add create_loginbox(), add loginshadow option
* Add loginshadow option to example config
* Add solid color background effect (#4)
* Use array and fix quoting
* Add color effect, create solid color backgrounds
* Update README
* Add more arguments and options (#5)
* New arguments and config options
* Update usage more
* Update README
* Minor text edits
* Relocate config and cache (#6)
* Move config and cache directories
* Make sure cache dir exists
* Reorder defaults, clarify options and theme
* Reformat example config
* Moved example config
* Update header info
* Fix quoting in DEFAULT_TIMEOUT
* Rewrite usage()
* Touch up comments and some syntax
* Update README, fix usage
* Fix passing arguments to i3lock
lockargs needs to be an array so that it can expand to multiple
arguments (preferable to using wordsplitting or eval instead).
* Scale loginbox based on DPI
Fixes jeffmhubbard/multilockscreen#7.
* Add failsafe to lock screen when images not found (#13)
* Add optional description box (#10)
* Add optional description box
The box is located in the bottom right corner
of the lock screen image and contains a
custom description message
(e.g. to present a name for random images
or to display additional information)
Added option: --desc <DESCRIPTION>
* Adapt description to i3lock date font
* Description font queried like in i3lock-color
* description: force normal upright font style
* added support for dimpixel effect (#16)
* added support for using different images on different displays (#17)
* added support for using different images on different displays
* fixed list creation when passed a single image
* reworked how WALL_LIST is generated
* Fix span output (#19)
* Make output reflect one set of images is processed
* Return only 1 image when spanning
* Correct output in a few spots
* Add fancy output (#20)
* Add echo wrapper to prefix output
* Fix typo
* Update README.md (#21)
* Fixes misspelled fn (#22)
* Escape spaces in path for IM (#24)
* Minor fixes (#26)
* Better parsing --lock args
* Add --pass-media-keys
* Add --pass-screen-keys and --pass-power-keys
* Fix insanely short default timeout
* Make error text transparent
* Call init_config later, update example config (#27)
Reading config file later allows users to define
custom functions in config (prelock, postlock, etc)
Updated docs with example usage
* Fix suspend (#30)
* Fix borked logic in --lock arg that breaks suspend
* Don't check before all arguments read
* Use `dunstctl` to (un)pause the dunst pre/post-lock. (#31)
Please be aware that, the use of dunstctl means that users will be forced to have dunst v1.5.0 or newer installed.
* Update LICENSE
* Disable DPMS after unlocking if it was originally disabled (#32)
* feat[multilockscreen]: Add --show-layout option (#36)
* Only change DPMS timeout if Enabled (#38)
* Fix #40 (#41)
Don't wait for `prelock()` and `postlock()` to complete
* Add bgcolor option to set i3lock --color (#44)
Closes #43
* Update systemd unit (#45)
* Fix options name for i3color-lock release 2.13.c.3 (#49)
With release 2.13.c.3 i3color-lock has added dashes before color, pos, size, etc.
https://github.com/Raymo111/i3lock-color/releases/tag/2.13.c.3
* Add checklist
* Rename script
* Extra files from upstream
* Update README
Keep most of betterlockscreen README. Replaced configuration,
usage, and usage examples.
* Update example config
* Fix branding, paths, etc
* Add wallpaper_cmd and time_format, long arg only
* Fix quoting, remove unused variable
Co-authored-by: Fox Kiester <noct@posteo.net>
Co-authored-by: Richard <fr34q@users.noreply.github.com>
Co-authored-by: Sheeets <31318683+sheeets@users.noreply.github.com>
Co-authored-by: Paul Zeinlinger <paul.zeinlinger@gmail.com>
Co-authored-by: Luc Caspar <casparluc@users.noreply.github.com>
Co-authored-by: R. David Dunphy <rdd.dunphy@gmail.com>
Co-authored-by: Artem Vasenin <vasart169@gmail.com>
Co-authored-by: Nicolas Serafini <serafini.nicolas@gmail.com>
2021-05-30 23:46:01 +00:00
2021-06-30 14:35:39 +00:00
You will need to copy "betterlockscreen" to you desired binary-directory, if you want to use the systemd-service you will need to copy the service-file from "system/" to the desired location on your system.
Prepare to merge (#228)
* Fix loginbox position for vertical arrangements
* Fix tabs everywhere
* 110 Automatically deduce DPI
* 118 Add description for Void Linux installation
* 119 Add Timeout Option
* Update README for multi-monitor
* Keep original directory
* Update README
* Rename project files
* Always use defaults
* Rewrite update() and get_display_list()
* Add lock_timeout to defaults
* Fix ExecStart in systemd unit
* Update README
* Fix bad variable name in wallpaper()
* Remove quoting, it breaks things
* Fix paths and canvas color
* Effects now are optional to speed up updating cache
* Fix fx_dimblur()
* Add shadow to loginbox (#3)
* Add create_loginbox(), add loginshadow option
* Add loginshadow option to example config
* Add solid color background effect (#4)
* Use array and fix quoting
* Add color effect, create solid color backgrounds
* Update README
* Add more arguments and options (#5)
* New arguments and config options
* Update usage more
* Update README
* Minor text edits
* Relocate config and cache (#6)
* Move config and cache directories
* Make sure cache dir exists
* Reorder defaults, clarify options and theme
* Reformat example config
* Moved example config
* Update header info
* Fix quoting in DEFAULT_TIMEOUT
* Rewrite usage()
* Touch up comments and some syntax
* Update README, fix usage
* Fix passing arguments to i3lock
lockargs needs to be an array so that it can expand to multiple
arguments (preferable to using wordsplitting or eval instead).
* Scale loginbox based on DPI
Fixes jeffmhubbard/multilockscreen#7.
* Add failsafe to lock screen when images not found (#13)
* Add optional description box (#10)
* Add optional description box
The box is located in the bottom right corner
of the lock screen image and contains a
custom description message
(e.g. to present a name for random images
or to display additional information)
Added option: --desc <DESCRIPTION>
* Adapt description to i3lock date font
* Description font queried like in i3lock-color
* description: force normal upright font style
* added support for dimpixel effect (#16)
* added support for using different images on different displays (#17)
* added support for using different images on different displays
* fixed list creation when passed a single image
* reworked how WALL_LIST is generated
* Fix span output (#19)
* Make output reflect one set of images is processed
* Return only 1 image when spanning
* Correct output in a few spots
* Add fancy output (#20)
* Add echo wrapper to prefix output
* Fix typo
* Update README.md (#21)
* Fixes misspelled fn (#22)
* Escape spaces in path for IM (#24)
* Minor fixes (#26)
* Better parsing --lock args
* Add --pass-media-keys
* Add --pass-screen-keys and --pass-power-keys
* Fix insanely short default timeout
* Make error text transparent
* Call init_config later, update example config (#27)
Reading config file later allows users to define
custom functions in config (prelock, postlock, etc)
Updated docs with example usage
* Fix suspend (#30)
* Fix borked logic in --lock arg that breaks suspend
* Don't check before all arguments read
* Use `dunstctl` to (un)pause the dunst pre/post-lock. (#31)
Please be aware that, the use of dunstctl means that users will be forced to have dunst v1.5.0 or newer installed.
* Update LICENSE
* Disable DPMS after unlocking if it was originally disabled (#32)
* feat[multilockscreen]: Add --show-layout option (#36)
* Only change DPMS timeout if Enabled (#38)
* Fix #40 (#41)
Don't wait for `prelock()` and `postlock()` to complete
* Add bgcolor option to set i3lock --color (#44)
Closes #43
* Update systemd unit (#45)
* Fix options name for i3color-lock release 2.13.c.3 (#49)
With release 2.13.c.3 i3color-lock has added dashes before color, pos, size, etc.
https://github.com/Raymo111/i3lock-color/releases/tag/2.13.c.3
* Add checklist
* Rename script
* Extra files from upstream
* Update README
Keep most of betterlockscreen README. Replaced configuration,
usage, and usage examples.
* Update example config
* Fix branding, paths, etc
* Add wallpaper_cmd and time_format, long arg only
* Fix quoting, remove unused variable
Co-authored-by: Fox Kiester <noct@posteo.net>
Co-authored-by: Richard <fr34q@users.noreply.github.com>
Co-authored-by: Sheeets <31318683+sheeets@users.noreply.github.com>
Co-authored-by: Paul Zeinlinger <paul.zeinlinger@gmail.com>
Co-authored-by: Luc Caspar <casparluc@users.noreply.github.com>
Co-authored-by: R. David Dunphy <rdd.dunphy@gmail.com>
Co-authored-by: Artem Vasenin <vasart169@gmail.com>
Co-authored-by: Nicolas Serafini <serafini.nicolas@gmail.com>
2021-05-30 23:46:01 +00:00
2021-06-30 14:35:39 +00:00
Example (Ubuntu):
```sh
wget https://github.com/pavanjadhaw/betterlockscreen/archive/refs/heads/master.zip
unzip master.zip
Prepare to merge (#228)
* Fix loginbox position for vertical arrangements
* Fix tabs everywhere
* 110 Automatically deduce DPI
* 118 Add description for Void Linux installation
* 119 Add Timeout Option
* Update README for multi-monitor
* Keep original directory
* Update README
* Rename project files
* Always use defaults
* Rewrite update() and get_display_list()
* Add lock_timeout to defaults
* Fix ExecStart in systemd unit
* Update README
* Fix bad variable name in wallpaper()
* Remove quoting, it breaks things
* Fix paths and canvas color
* Effects now are optional to speed up updating cache
* Fix fx_dimblur()
* Add shadow to loginbox (#3)
* Add create_loginbox(), add loginshadow option
* Add loginshadow option to example config
* Add solid color background effect (#4)
* Use array and fix quoting
* Add color effect, create solid color backgrounds
* Update README
* Add more arguments and options (#5)
* New arguments and config options
* Update usage more
* Update README
* Minor text edits
* Relocate config and cache (#6)
* Move config and cache directories
* Make sure cache dir exists
* Reorder defaults, clarify options and theme
* Reformat example config
* Moved example config
* Update header info
* Fix quoting in DEFAULT_TIMEOUT
* Rewrite usage()
* Touch up comments and some syntax
* Update README, fix usage
* Fix passing arguments to i3lock
lockargs needs to be an array so that it can expand to multiple
arguments (preferable to using wordsplitting or eval instead).
* Scale loginbox based on DPI
Fixes jeffmhubbard/multilockscreen#7.
* Add failsafe to lock screen when images not found (#13)
* Add optional description box (#10)
* Add optional description box
The box is located in the bottom right corner
of the lock screen image and contains a
custom description message
(e.g. to present a name for random images
or to display additional information)
Added option: --desc <DESCRIPTION>
* Adapt description to i3lock date font
* Description font queried like in i3lock-color
* description: force normal upright font style
* added support for dimpixel effect (#16)
* added support for using different images on different displays (#17)
* added support for using different images on different displays
* fixed list creation when passed a single image
* reworked how WALL_LIST is generated
* Fix span output (#19)
* Make output reflect one set of images is processed
* Return only 1 image when spanning
* Correct output in a few spots
* Add fancy output (#20)
* Add echo wrapper to prefix output
* Fix typo
* Update README.md (#21)
* Fixes misspelled fn (#22)
* Escape spaces in path for IM (#24)
* Minor fixes (#26)
* Better parsing --lock args
* Add --pass-media-keys
* Add --pass-screen-keys and --pass-power-keys
* Fix insanely short default timeout
* Make error text transparent
* Call init_config later, update example config (#27)
Reading config file later allows users to define
custom functions in config (prelock, postlock, etc)
Updated docs with example usage
* Fix suspend (#30)
* Fix borked logic in --lock arg that breaks suspend
* Don't check before all arguments read
* Use `dunstctl` to (un)pause the dunst pre/post-lock. (#31)
Please be aware that, the use of dunstctl means that users will be forced to have dunst v1.5.0 or newer installed.
* Update LICENSE
* Disable DPMS after unlocking if it was originally disabled (#32)
* feat[multilockscreen]: Add --show-layout option (#36)
* Only change DPMS timeout if Enabled (#38)
* Fix #40 (#41)
Don't wait for `prelock()` and `postlock()` to complete
* Add bgcolor option to set i3lock --color (#44)
Closes #43
* Update systemd unit (#45)
* Fix options name for i3color-lock release 2.13.c.3 (#49)
With release 2.13.c.3 i3color-lock has added dashes before color, pos, size, etc.
https://github.com/Raymo111/i3lock-color/releases/tag/2.13.c.3
* Add checklist
* Rename script
* Extra files from upstream
* Update README
Keep most of betterlockscreen README. Replaced configuration,
usage, and usage examples.
* Update example config
* Fix branding, paths, etc
* Add wallpaper_cmd and time_format, long arg only
* Fix quoting, remove unused variable
Co-authored-by: Fox Kiester <noct@posteo.net>
Co-authored-by: Richard <fr34q@users.noreply.github.com>
Co-authored-by: Sheeets <31318683+sheeets@users.noreply.github.com>
Co-authored-by: Paul Zeinlinger <paul.zeinlinger@gmail.com>
Co-authored-by: Luc Caspar <casparluc@users.noreply.github.com>
Co-authored-by: R. David Dunphy <rdd.dunphy@gmail.com>
Co-authored-by: Artem Vasenin <vasart169@gmail.com>
Co-authored-by: Nicolas Serafini <serafini.nicolas@gmail.com>
2021-05-30 23:46:01 +00:00
2021-06-30 14:35:39 +00:00
cd betterlockscreen-master/
chmod u+x betterlockscreen
cp betterlockscreen /usr/local/bin/
Prepare to merge (#228)
* Fix loginbox position for vertical arrangements
* Fix tabs everywhere
* 110 Automatically deduce DPI
* 118 Add description for Void Linux installation
* 119 Add Timeout Option
* Update README for multi-monitor
* Keep original directory
* Update README
* Rename project files
* Always use defaults
* Rewrite update() and get_display_list()
* Add lock_timeout to defaults
* Fix ExecStart in systemd unit
* Update README
* Fix bad variable name in wallpaper()
* Remove quoting, it breaks things
* Fix paths and canvas color
* Effects now are optional to speed up updating cache
* Fix fx_dimblur()
* Add shadow to loginbox (#3)
* Add create_loginbox(), add loginshadow option
* Add loginshadow option to example config
* Add solid color background effect (#4)
* Use array and fix quoting
* Add color effect, create solid color backgrounds
* Update README
* Add more arguments and options (#5)
* New arguments and config options
* Update usage more
* Update README
* Minor text edits
* Relocate config and cache (#6)
* Move config and cache directories
* Make sure cache dir exists
* Reorder defaults, clarify options and theme
* Reformat example config
* Moved example config
* Update header info
* Fix quoting in DEFAULT_TIMEOUT
* Rewrite usage()
* Touch up comments and some syntax
* Update README, fix usage
* Fix passing arguments to i3lock
lockargs needs to be an array so that it can expand to multiple
arguments (preferable to using wordsplitting or eval instead).
* Scale loginbox based on DPI
Fixes jeffmhubbard/multilockscreen#7.
* Add failsafe to lock screen when images not found (#13)
* Add optional description box (#10)
* Add optional description box
The box is located in the bottom right corner
of the lock screen image and contains a
custom description message
(e.g. to present a name for random images
or to display additional information)
Added option: --desc <DESCRIPTION>
* Adapt description to i3lock date font
* Description font queried like in i3lock-color
* description: force normal upright font style
* added support for dimpixel effect (#16)
* added support for using different images on different displays (#17)
* added support for using different images on different displays
* fixed list creation when passed a single image
* reworked how WALL_LIST is generated
* Fix span output (#19)
* Make output reflect one set of images is processed
* Return only 1 image when spanning
* Correct output in a few spots
* Add fancy output (#20)
* Add echo wrapper to prefix output
* Fix typo
* Update README.md (#21)
* Fixes misspelled fn (#22)
* Escape spaces in path for IM (#24)
* Minor fixes (#26)
* Better parsing --lock args
* Add --pass-media-keys
* Add --pass-screen-keys and --pass-power-keys
* Fix insanely short default timeout
* Make error text transparent
* Call init_config later, update example config (#27)
Reading config file later allows users to define
custom functions in config (prelock, postlock, etc)
Updated docs with example usage
* Fix suspend (#30)
* Fix borked logic in --lock arg that breaks suspend
* Don't check before all arguments read
* Use `dunstctl` to (un)pause the dunst pre/post-lock. (#31)
Please be aware that, the use of dunstctl means that users will be forced to have dunst v1.5.0 or newer installed.
* Update LICENSE
* Disable DPMS after unlocking if it was originally disabled (#32)
* feat[multilockscreen]: Add --show-layout option (#36)
* Only change DPMS timeout if Enabled (#38)
* Fix #40 (#41)
Don't wait for `prelock()` and `postlock()` to complete
* Add bgcolor option to set i3lock --color (#44)
Closes #43
* Update systemd unit (#45)
* Fix options name for i3color-lock release 2.13.c.3 (#49)
With release 2.13.c.3 i3color-lock has added dashes before color, pos, size, etc.
https://github.com/Raymo111/i3lock-color/releases/tag/2.13.c.3
* Add checklist
* Rename script
* Extra files from upstream
* Update README
Keep most of betterlockscreen README. Replaced configuration,
usage, and usage examples.
* Update example config
* Fix branding, paths, etc
* Add wallpaper_cmd and time_format, long arg only
* Fix quoting, remove unused variable
Co-authored-by: Fox Kiester <noct@posteo.net>
Co-authored-by: Richard <fr34q@users.noreply.github.com>
Co-authored-by: Sheeets <31318683+sheeets@users.noreply.github.com>
Co-authored-by: Paul Zeinlinger <paul.zeinlinger@gmail.com>
Co-authored-by: Luc Caspar <casparluc@users.noreply.github.com>
Co-authored-by: R. David Dunphy <rdd.dunphy@gmail.com>
Co-authored-by: Artem Vasenin <vasart169@gmail.com>
Co-authored-by: Nicolas Serafini <serafini.nicolas@gmail.com>
2021-05-30 23:46:01 +00:00
2021-06-30 14:35:39 +00:00
cp system/betterlockscreen@.service /usr/lib/systemd/system/
systemctl enable betterlockscreen@$USER
```
2019-01-23 06:42:01 +00:00
2021-06-30 14:35:39 +00:00
## Configuration
2019-01-23 06:42:01 +00:00
2021-06-30 14:35:39 +00:00
You can customize betterlockscreen for your needs, copy the config file from the examples-directory to `~/.config/betterlockscreenrc` and edit it accordingly.
2019-01-23 06:42:01 +00:00
2021-06-30 14:35:39 +00:00
If no configuration-file is found, then the default configurations (which is equal to the example but currently hardcoded) will be used.
Prepare to merge (#228)
* Fix loginbox position for vertical arrangements
* Fix tabs everywhere
* 110 Automatically deduce DPI
* 118 Add description for Void Linux installation
* 119 Add Timeout Option
* Update README for multi-monitor
* Keep original directory
* Update README
* Rename project files
* Always use defaults
* Rewrite update() and get_display_list()
* Add lock_timeout to defaults
* Fix ExecStart in systemd unit
* Update README
* Fix bad variable name in wallpaper()
* Remove quoting, it breaks things
* Fix paths and canvas color
* Effects now are optional to speed up updating cache
* Fix fx_dimblur()
* Add shadow to loginbox (#3)
* Add create_loginbox(), add loginshadow option
* Add loginshadow option to example config
* Add solid color background effect (#4)
* Use array and fix quoting
* Add color effect, create solid color backgrounds
* Update README
* Add more arguments and options (#5)
* New arguments and config options
* Update usage more
* Update README
* Minor text edits
* Relocate config and cache (#6)
* Move config and cache directories
* Make sure cache dir exists
* Reorder defaults, clarify options and theme
* Reformat example config
* Moved example config
* Update header info
* Fix quoting in DEFAULT_TIMEOUT
* Rewrite usage()
* Touch up comments and some syntax
* Update README, fix usage
* Fix passing arguments to i3lock
lockargs needs to be an array so that it can expand to multiple
arguments (preferable to using wordsplitting or eval instead).
* Scale loginbox based on DPI
Fixes jeffmhubbard/multilockscreen#7.
* Add failsafe to lock screen when images not found (#13)
* Add optional description box (#10)
* Add optional description box
The box is located in the bottom right corner
of the lock screen image and contains a
custom description message
(e.g. to present a name for random images
or to display additional information)
Added option: --desc <DESCRIPTION>
* Adapt description to i3lock date font
* Description font queried like in i3lock-color
* description: force normal upright font style
* added support for dimpixel effect (#16)
* added support for using different images on different displays (#17)
* added support for using different images on different displays
* fixed list creation when passed a single image
* reworked how WALL_LIST is generated
* Fix span output (#19)
* Make output reflect one set of images is processed
* Return only 1 image when spanning
* Correct output in a few spots
* Add fancy output (#20)
* Add echo wrapper to prefix output
* Fix typo
* Update README.md (#21)
* Fixes misspelled fn (#22)
* Escape spaces in path for IM (#24)
* Minor fixes (#26)
* Better parsing --lock args
* Add --pass-media-keys
* Add --pass-screen-keys and --pass-power-keys
* Fix insanely short default timeout
* Make error text transparent
* Call init_config later, update example config (#27)
Reading config file later allows users to define
custom functions in config (prelock, postlock, etc)
Updated docs with example usage
* Fix suspend (#30)
* Fix borked logic in --lock arg that breaks suspend
* Don't check before all arguments read
* Use `dunstctl` to (un)pause the dunst pre/post-lock. (#31)
Please be aware that, the use of dunstctl means that users will be forced to have dunst v1.5.0 or newer installed.
* Update LICENSE
* Disable DPMS after unlocking if it was originally disabled (#32)
* feat[multilockscreen]: Add --show-layout option (#36)
* Only change DPMS timeout if Enabled (#38)
* Fix #40 (#41)
Don't wait for `prelock()` and `postlock()` to complete
* Add bgcolor option to set i3lock --color (#44)
Closes #43
* Update systemd unit (#45)
* Fix options name for i3color-lock release 2.13.c.3 (#49)
With release 2.13.c.3 i3color-lock has added dashes before color, pos, size, etc.
https://github.com/Raymo111/i3lock-color/releases/tag/2.13.c.3
* Add checklist
* Rename script
* Extra files from upstream
* Update README
Keep most of betterlockscreen README. Replaced configuration,
usage, and usage examples.
* Update example config
* Fix branding, paths, etc
* Add wallpaper_cmd and time_format, long arg only
* Fix quoting, remove unused variable
Co-authored-by: Fox Kiester <noct@posteo.net>
Co-authored-by: Richard <fr34q@users.noreply.github.com>
Co-authored-by: Sheeets <31318683+sheeets@users.noreply.github.com>
Co-authored-by: Paul Zeinlinger <paul.zeinlinger@gmail.com>
Co-authored-by: Luc Caspar <casparluc@users.noreply.github.com>
Co-authored-by: R. David Dunphy <rdd.dunphy@gmail.com>
Co-authored-by: Artem Vasenin <vasart169@gmail.com>
Co-authored-by: Nicolas Serafini <serafini.nicolas@gmail.com>
2021-05-30 23:46:01 +00:00
2019-01-28 05:26:47 +00:00
If you have installed betterlockscreen from AUR package, then you can copy default config from docs
```sh
cp /usr/share/doc/betterlockscreen/examples/betterlockscreenrc ~/.config
```
2021-06-30 14:35:39 +00:00
## Usage
2017-12-10 04:41:23 +00:00
2018-09-18 18:40:52 +00:00
Run `betterlockscreen` and point it to either a directory (`betterlockscreen -u "path/to/dir"`) or an image (`betterlockscreen -u "/path/to/img.jpg"`) and that's all. `betterlockscreen` will change update its cache with image you provided.
2017-12-10 04:41:23 +00:00
2018-09-18 18:40:52 +00:00
```sh
Prepare to merge (#228)
* Fix loginbox position for vertical arrangements
* Fix tabs everywhere
* 110 Automatically deduce DPI
* 118 Add description for Void Linux installation
* 119 Add Timeout Option
* Update README for multi-monitor
* Keep original directory
* Update README
* Rename project files
* Always use defaults
* Rewrite update() and get_display_list()
* Add lock_timeout to defaults
* Fix ExecStart in systemd unit
* Update README
* Fix bad variable name in wallpaper()
* Remove quoting, it breaks things
* Fix paths and canvas color
* Effects now are optional to speed up updating cache
* Fix fx_dimblur()
* Add shadow to loginbox (#3)
* Add create_loginbox(), add loginshadow option
* Add loginshadow option to example config
* Add solid color background effect (#4)
* Use array and fix quoting
* Add color effect, create solid color backgrounds
* Update README
* Add more arguments and options (#5)
* New arguments and config options
* Update usage more
* Update README
* Minor text edits
* Relocate config and cache (#6)
* Move config and cache directories
* Make sure cache dir exists
* Reorder defaults, clarify options and theme
* Reformat example config
* Moved example config
* Update header info
* Fix quoting in DEFAULT_TIMEOUT
* Rewrite usage()
* Touch up comments and some syntax
* Update README, fix usage
* Fix passing arguments to i3lock
lockargs needs to be an array so that it can expand to multiple
arguments (preferable to using wordsplitting or eval instead).
* Scale loginbox based on DPI
Fixes jeffmhubbard/multilockscreen#7.
* Add failsafe to lock screen when images not found (#13)
* Add optional description box (#10)
* Add optional description box
The box is located in the bottom right corner
of the lock screen image and contains a
custom description message
(e.g. to present a name for random images
or to display additional information)
Added option: --desc <DESCRIPTION>
* Adapt description to i3lock date font
* Description font queried like in i3lock-color
* description: force normal upright font style
* added support for dimpixel effect (#16)
* added support for using different images on different displays (#17)
* added support for using different images on different displays
* fixed list creation when passed a single image
* reworked how WALL_LIST is generated
* Fix span output (#19)
* Make output reflect one set of images is processed
* Return only 1 image when spanning
* Correct output in a few spots
* Add fancy output (#20)
* Add echo wrapper to prefix output
* Fix typo
* Update README.md (#21)
* Fixes misspelled fn (#22)
* Escape spaces in path for IM (#24)
* Minor fixes (#26)
* Better parsing --lock args
* Add --pass-media-keys
* Add --pass-screen-keys and --pass-power-keys
* Fix insanely short default timeout
* Make error text transparent
* Call init_config later, update example config (#27)
Reading config file later allows users to define
custom functions in config (prelock, postlock, etc)
Updated docs with example usage
* Fix suspend (#30)
* Fix borked logic in --lock arg that breaks suspend
* Don't check before all arguments read
* Use `dunstctl` to (un)pause the dunst pre/post-lock. (#31)
Please be aware that, the use of dunstctl means that users will be forced to have dunst v1.5.0 or newer installed.
* Update LICENSE
* Disable DPMS after unlocking if it was originally disabled (#32)
* feat[multilockscreen]: Add --show-layout option (#36)
* Only change DPMS timeout if Enabled (#38)
* Fix #40 (#41)
Don't wait for `prelock()` and `postlock()` to complete
* Add bgcolor option to set i3lock --color (#44)
Closes #43
* Update systemd unit (#45)
* Fix options name for i3color-lock release 2.13.c.3 (#49)
With release 2.13.c.3 i3color-lock has added dashes before color, pos, size, etc.
https://github.com/Raymo111/i3lock-color/releases/tag/2.13.c.3
* Add checklist
* Rename script
* Extra files from upstream
* Update README
Keep most of betterlockscreen README. Replaced configuration,
usage, and usage examples.
* Update example config
* Fix branding, paths, etc
* Add wallpaper_cmd and time_format, long arg only
* Fix quoting, remove unused variable
Co-authored-by: Fox Kiester <noct@posteo.net>
Co-authored-by: Richard <fr34q@users.noreply.github.com>
Co-authored-by: Sheeets <31318683+sheeets@users.noreply.github.com>
Co-authored-by: Paul Zeinlinger <paul.zeinlinger@gmail.com>
Co-authored-by: Luc Caspar <casparluc@users.noreply.github.com>
Co-authored-by: R. David Dunphy <rdd.dunphy@gmail.com>
Co-authored-by: Artem Vasenin <vasart169@gmail.com>
Co-authored-by: Nicolas Serafini <serafini.nicolas@gmail.com>
2021-05-30 23:46:01 +00:00
Usage: betterlockscreen [-u < PATH > ] [-l < EFFECT > ] [-w < EFFECT > ]
2017-12-08 06:01:03 +00:00
Prepare to merge (#228)
* Fix loginbox position for vertical arrangements
* Fix tabs everywhere
* 110 Automatically deduce DPI
* 118 Add description for Void Linux installation
* 119 Add Timeout Option
* Update README for multi-monitor
* Keep original directory
* Update README
* Rename project files
* Always use defaults
* Rewrite update() and get_display_list()
* Add lock_timeout to defaults
* Fix ExecStart in systemd unit
* Update README
* Fix bad variable name in wallpaper()
* Remove quoting, it breaks things
* Fix paths and canvas color
* Effects now are optional to speed up updating cache
* Fix fx_dimblur()
* Add shadow to loginbox (#3)
* Add create_loginbox(), add loginshadow option
* Add loginshadow option to example config
* Add solid color background effect (#4)
* Use array and fix quoting
* Add color effect, create solid color backgrounds
* Update README
* Add more arguments and options (#5)
* New arguments and config options
* Update usage more
* Update README
* Minor text edits
* Relocate config and cache (#6)
* Move config and cache directories
* Make sure cache dir exists
* Reorder defaults, clarify options and theme
* Reformat example config
* Moved example config
* Update header info
* Fix quoting in DEFAULT_TIMEOUT
* Rewrite usage()
* Touch up comments and some syntax
* Update README, fix usage
* Fix passing arguments to i3lock
lockargs needs to be an array so that it can expand to multiple
arguments (preferable to using wordsplitting or eval instead).
* Scale loginbox based on DPI
Fixes jeffmhubbard/multilockscreen#7.
* Add failsafe to lock screen when images not found (#13)
* Add optional description box (#10)
* Add optional description box
The box is located in the bottom right corner
of the lock screen image and contains a
custom description message
(e.g. to present a name for random images
or to display additional information)
Added option: --desc <DESCRIPTION>
* Adapt description to i3lock date font
* Description font queried like in i3lock-color
* description: force normal upright font style
* added support for dimpixel effect (#16)
* added support for using different images on different displays (#17)
* added support for using different images on different displays
* fixed list creation when passed a single image
* reworked how WALL_LIST is generated
* Fix span output (#19)
* Make output reflect one set of images is processed
* Return only 1 image when spanning
* Correct output in a few spots
* Add fancy output (#20)
* Add echo wrapper to prefix output
* Fix typo
* Update README.md (#21)
* Fixes misspelled fn (#22)
* Escape spaces in path for IM (#24)
* Minor fixes (#26)
* Better parsing --lock args
* Add --pass-media-keys
* Add --pass-screen-keys and --pass-power-keys
* Fix insanely short default timeout
* Make error text transparent
* Call init_config later, update example config (#27)
Reading config file later allows users to define
custom functions in config (prelock, postlock, etc)
Updated docs with example usage
* Fix suspend (#30)
* Fix borked logic in --lock arg that breaks suspend
* Don't check before all arguments read
* Use `dunstctl` to (un)pause the dunst pre/post-lock. (#31)
Please be aware that, the use of dunstctl means that users will be forced to have dunst v1.5.0 or newer installed.
* Update LICENSE
* Disable DPMS after unlocking if it was originally disabled (#32)
* feat[multilockscreen]: Add --show-layout option (#36)
* Only change DPMS timeout if Enabled (#38)
* Fix #40 (#41)
Don't wait for `prelock()` and `postlock()` to complete
* Add bgcolor option to set i3lock --color (#44)
Closes #43
* Update systemd unit (#45)
* Fix options name for i3color-lock release 2.13.c.3 (#49)
With release 2.13.c.3 i3color-lock has added dashes before color, pos, size, etc.
https://github.com/Raymo111/i3lock-color/releases/tag/2.13.c.3
* Add checklist
* Rename script
* Extra files from upstream
* Update README
Keep most of betterlockscreen README. Replaced configuration,
usage, and usage examples.
* Update example config
* Fix branding, paths, etc
* Add wallpaper_cmd and time_format, long arg only
* Fix quoting, remove unused variable
Co-authored-by: Fox Kiester <noct@posteo.net>
Co-authored-by: Richard <fr34q@users.noreply.github.com>
Co-authored-by: Sheeets <31318683+sheeets@users.noreply.github.com>
Co-authored-by: Paul Zeinlinger <paul.zeinlinger@gmail.com>
Co-authored-by: Luc Caspar <casparluc@users.noreply.github.com>
Co-authored-by: R. David Dunphy <rdd.dunphy@gmail.com>
Co-authored-by: Artem Vasenin <vasart169@gmail.com>
Co-authored-by: Nicolas Serafini <serafini.nicolas@gmail.com>
2021-05-30 23:46:01 +00:00
-u --update < PATH >
Update lock screen image
2017-12-08 06:01:03 +00:00
Prepare to merge (#228)
* Fix loginbox position for vertical arrangements
* Fix tabs everywhere
* 110 Automatically deduce DPI
* 118 Add description for Void Linux installation
* 119 Add Timeout Option
* Update README for multi-monitor
* Keep original directory
* Update README
* Rename project files
* Always use defaults
* Rewrite update() and get_display_list()
* Add lock_timeout to defaults
* Fix ExecStart in systemd unit
* Update README
* Fix bad variable name in wallpaper()
* Remove quoting, it breaks things
* Fix paths and canvas color
* Effects now are optional to speed up updating cache
* Fix fx_dimblur()
* Add shadow to loginbox (#3)
* Add create_loginbox(), add loginshadow option
* Add loginshadow option to example config
* Add solid color background effect (#4)
* Use array and fix quoting
* Add color effect, create solid color backgrounds
* Update README
* Add more arguments and options (#5)
* New arguments and config options
* Update usage more
* Update README
* Minor text edits
* Relocate config and cache (#6)
* Move config and cache directories
* Make sure cache dir exists
* Reorder defaults, clarify options and theme
* Reformat example config
* Moved example config
* Update header info
* Fix quoting in DEFAULT_TIMEOUT
* Rewrite usage()
* Touch up comments and some syntax
* Update README, fix usage
* Fix passing arguments to i3lock
lockargs needs to be an array so that it can expand to multiple
arguments (preferable to using wordsplitting or eval instead).
* Scale loginbox based on DPI
Fixes jeffmhubbard/multilockscreen#7.
* Add failsafe to lock screen when images not found (#13)
* Add optional description box (#10)
* Add optional description box
The box is located in the bottom right corner
of the lock screen image and contains a
custom description message
(e.g. to present a name for random images
or to display additional information)
Added option: --desc <DESCRIPTION>
* Adapt description to i3lock date font
* Description font queried like in i3lock-color
* description: force normal upright font style
* added support for dimpixel effect (#16)
* added support for using different images on different displays (#17)
* added support for using different images on different displays
* fixed list creation when passed a single image
* reworked how WALL_LIST is generated
* Fix span output (#19)
* Make output reflect one set of images is processed
* Return only 1 image when spanning
* Correct output in a few spots
* Add fancy output (#20)
* Add echo wrapper to prefix output
* Fix typo
* Update README.md (#21)
* Fixes misspelled fn (#22)
* Escape spaces in path for IM (#24)
* Minor fixes (#26)
* Better parsing --lock args
* Add --pass-media-keys
* Add --pass-screen-keys and --pass-power-keys
* Fix insanely short default timeout
* Make error text transparent
* Call init_config later, update example config (#27)
Reading config file later allows users to define
custom functions in config (prelock, postlock, etc)
Updated docs with example usage
* Fix suspend (#30)
* Fix borked logic in --lock arg that breaks suspend
* Don't check before all arguments read
* Use `dunstctl` to (un)pause the dunst pre/post-lock. (#31)
Please be aware that, the use of dunstctl means that users will be forced to have dunst v1.5.0 or newer installed.
* Update LICENSE
* Disable DPMS after unlocking if it was originally disabled (#32)
* feat[multilockscreen]: Add --show-layout option (#36)
* Only change DPMS timeout if Enabled (#38)
* Fix #40 (#41)
Don't wait for `prelock()` and `postlock()` to complete
* Add bgcolor option to set i3lock --color (#44)
Closes #43
* Update systemd unit (#45)
* Fix options name for i3color-lock release 2.13.c.3 (#49)
With release 2.13.c.3 i3color-lock has added dashes before color, pos, size, etc.
https://github.com/Raymo111/i3lock-color/releases/tag/2.13.c.3
* Add checklist
* Rename script
* Extra files from upstream
* Update README
Keep most of betterlockscreen README. Replaced configuration,
usage, and usage examples.
* Update example config
* Fix branding, paths, etc
* Add wallpaper_cmd and time_format, long arg only
* Fix quoting, remove unused variable
Co-authored-by: Fox Kiester <noct@posteo.net>
Co-authored-by: Richard <fr34q@users.noreply.github.com>
Co-authored-by: Sheeets <31318683+sheeets@users.noreply.github.com>
Co-authored-by: Paul Zeinlinger <paul.zeinlinger@gmail.com>
Co-authored-by: Luc Caspar <casparluc@users.noreply.github.com>
Co-authored-by: R. David Dunphy <rdd.dunphy@gmail.com>
Co-authored-by: Artem Vasenin <vasart169@gmail.com>
Co-authored-by: Nicolas Serafini <serafini.nicolas@gmail.com>
2021-05-30 23:46:01 +00:00
-l --lock < EFFECT >
Lock screen with cached image
2017-12-07 18:51:34 +00:00
Prepare to merge (#228)
* Fix loginbox position for vertical arrangements
* Fix tabs everywhere
* 110 Automatically deduce DPI
* 118 Add description for Void Linux installation
* 119 Add Timeout Option
* Update README for multi-monitor
* Keep original directory
* Update README
* Rename project files
* Always use defaults
* Rewrite update() and get_display_list()
* Add lock_timeout to defaults
* Fix ExecStart in systemd unit
* Update README
* Fix bad variable name in wallpaper()
* Remove quoting, it breaks things
* Fix paths and canvas color
* Effects now are optional to speed up updating cache
* Fix fx_dimblur()
* Add shadow to loginbox (#3)
* Add create_loginbox(), add loginshadow option
* Add loginshadow option to example config
* Add solid color background effect (#4)
* Use array and fix quoting
* Add color effect, create solid color backgrounds
* Update README
* Add more arguments and options (#5)
* New arguments and config options
* Update usage more
* Update README
* Minor text edits
* Relocate config and cache (#6)
* Move config and cache directories
* Make sure cache dir exists
* Reorder defaults, clarify options and theme
* Reformat example config
* Moved example config
* Update header info
* Fix quoting in DEFAULT_TIMEOUT
* Rewrite usage()
* Touch up comments and some syntax
* Update README, fix usage
* Fix passing arguments to i3lock
lockargs needs to be an array so that it can expand to multiple
arguments (preferable to using wordsplitting or eval instead).
* Scale loginbox based on DPI
Fixes jeffmhubbard/multilockscreen#7.
* Add failsafe to lock screen when images not found (#13)
* Add optional description box (#10)
* Add optional description box
The box is located in the bottom right corner
of the lock screen image and contains a
custom description message
(e.g. to present a name for random images
or to display additional information)
Added option: --desc <DESCRIPTION>
* Adapt description to i3lock date font
* Description font queried like in i3lock-color
* description: force normal upright font style
* added support for dimpixel effect (#16)
* added support for using different images on different displays (#17)
* added support for using different images on different displays
* fixed list creation when passed a single image
* reworked how WALL_LIST is generated
* Fix span output (#19)
* Make output reflect one set of images is processed
* Return only 1 image when spanning
* Correct output in a few spots
* Add fancy output (#20)
* Add echo wrapper to prefix output
* Fix typo
* Update README.md (#21)
* Fixes misspelled fn (#22)
* Escape spaces in path for IM (#24)
* Minor fixes (#26)
* Better parsing --lock args
* Add --pass-media-keys
* Add --pass-screen-keys and --pass-power-keys
* Fix insanely short default timeout
* Make error text transparent
* Call init_config later, update example config (#27)
Reading config file later allows users to define
custom functions in config (prelock, postlock, etc)
Updated docs with example usage
* Fix suspend (#30)
* Fix borked logic in --lock arg that breaks suspend
* Don't check before all arguments read
* Use `dunstctl` to (un)pause the dunst pre/post-lock. (#31)
Please be aware that, the use of dunstctl means that users will be forced to have dunst v1.5.0 or newer installed.
* Update LICENSE
* Disable DPMS after unlocking if it was originally disabled (#32)
* feat[multilockscreen]: Add --show-layout option (#36)
* Only change DPMS timeout if Enabled (#38)
* Fix #40 (#41)
Don't wait for `prelock()` and `postlock()` to complete
* Add bgcolor option to set i3lock --color (#44)
Closes #43
* Update systemd unit (#45)
* Fix options name for i3color-lock release 2.13.c.3 (#49)
With release 2.13.c.3 i3color-lock has added dashes before color, pos, size, etc.
https://github.com/Raymo111/i3lock-color/releases/tag/2.13.c.3
* Add checklist
* Rename script
* Extra files from upstream
* Update README
Keep most of betterlockscreen README. Replaced configuration,
usage, and usage examples.
* Update example config
* Fix branding, paths, etc
* Add wallpaper_cmd and time_format, long arg only
* Fix quoting, remove unused variable
Co-authored-by: Fox Kiester <noct@posteo.net>
Co-authored-by: Richard <fr34q@users.noreply.github.com>
Co-authored-by: Sheeets <31318683+sheeets@users.noreply.github.com>
Co-authored-by: Paul Zeinlinger <paul.zeinlinger@gmail.com>
Co-authored-by: Luc Caspar <casparluc@users.noreply.github.com>
Co-authored-by: R. David Dunphy <rdd.dunphy@gmail.com>
Co-authored-by: Artem Vasenin <vasart169@gmail.com>
Co-authored-by: Nicolas Serafini <serafini.nicolas@gmail.com>
2021-05-30 23:46:01 +00:00
-w --wall < EFFECT >
Set wallpaper with cached image
2019-02-09 23:25:01 +00:00
Prepare to merge (#228)
* Fix loginbox position for vertical arrangements
* Fix tabs everywhere
* 110 Automatically deduce DPI
* 118 Add description for Void Linux installation
* 119 Add Timeout Option
* Update README for multi-monitor
* Keep original directory
* Update README
* Rename project files
* Always use defaults
* Rewrite update() and get_display_list()
* Add lock_timeout to defaults
* Fix ExecStart in systemd unit
* Update README
* Fix bad variable name in wallpaper()
* Remove quoting, it breaks things
* Fix paths and canvas color
* Effects now are optional to speed up updating cache
* Fix fx_dimblur()
* Add shadow to loginbox (#3)
* Add create_loginbox(), add loginshadow option
* Add loginshadow option to example config
* Add solid color background effect (#4)
* Use array and fix quoting
* Add color effect, create solid color backgrounds
* Update README
* Add more arguments and options (#5)
* New arguments and config options
* Update usage more
* Update README
* Minor text edits
* Relocate config and cache (#6)
* Move config and cache directories
* Make sure cache dir exists
* Reorder defaults, clarify options and theme
* Reformat example config
* Moved example config
* Update header info
* Fix quoting in DEFAULT_TIMEOUT
* Rewrite usage()
* Touch up comments and some syntax
* Update README, fix usage
* Fix passing arguments to i3lock
lockargs needs to be an array so that it can expand to multiple
arguments (preferable to using wordsplitting or eval instead).
* Scale loginbox based on DPI
Fixes jeffmhubbard/multilockscreen#7.
* Add failsafe to lock screen when images not found (#13)
* Add optional description box (#10)
* Add optional description box
The box is located in the bottom right corner
of the lock screen image and contains a
custom description message
(e.g. to present a name for random images
or to display additional information)
Added option: --desc <DESCRIPTION>
* Adapt description to i3lock date font
* Description font queried like in i3lock-color
* description: force normal upright font style
* added support for dimpixel effect (#16)
* added support for using different images on different displays (#17)
* added support for using different images on different displays
* fixed list creation when passed a single image
* reworked how WALL_LIST is generated
* Fix span output (#19)
* Make output reflect one set of images is processed
* Return only 1 image when spanning
* Correct output in a few spots
* Add fancy output (#20)
* Add echo wrapper to prefix output
* Fix typo
* Update README.md (#21)
* Fixes misspelled fn (#22)
* Escape spaces in path for IM (#24)
* Minor fixes (#26)
* Better parsing --lock args
* Add --pass-media-keys
* Add --pass-screen-keys and --pass-power-keys
* Fix insanely short default timeout
* Make error text transparent
* Call init_config later, update example config (#27)
Reading config file later allows users to define
custom functions in config (prelock, postlock, etc)
Updated docs with example usage
* Fix suspend (#30)
* Fix borked logic in --lock arg that breaks suspend
* Don't check before all arguments read
* Use `dunstctl` to (un)pause the dunst pre/post-lock. (#31)
Please be aware that, the use of dunstctl means that users will be forced to have dunst v1.5.0 or newer installed.
* Update LICENSE
* Disable DPMS after unlocking if it was originally disabled (#32)
* feat[multilockscreen]: Add --show-layout option (#36)
* Only change DPMS timeout if Enabled (#38)
* Fix #40 (#41)
Don't wait for `prelock()` and `postlock()` to complete
* Add bgcolor option to set i3lock --color (#44)
Closes #43
* Update systemd unit (#45)
* Fix options name for i3color-lock release 2.13.c.3 (#49)
With release 2.13.c.3 i3color-lock has added dashes before color, pos, size, etc.
https://github.com/Raymo111/i3lock-color/releases/tag/2.13.c.3
* Add checklist
* Rename script
* Extra files from upstream
* Update README
Keep most of betterlockscreen README. Replaced configuration,
usage, and usage examples.
* Update example config
* Fix branding, paths, etc
* Add wallpaper_cmd and time_format, long arg only
* Fix quoting, remove unused variable
Co-authored-by: Fox Kiester <noct@posteo.net>
Co-authored-by: Richard <fr34q@users.noreply.github.com>
Co-authored-by: Sheeets <31318683+sheeets@users.noreply.github.com>
Co-authored-by: Paul Zeinlinger <paul.zeinlinger@gmail.com>
Co-authored-by: Luc Caspar <casparluc@users.noreply.github.com>
Co-authored-by: R. David Dunphy <rdd.dunphy@gmail.com>
Co-authored-by: Artem Vasenin <vasart169@gmail.com>
Co-authored-by: Nicolas Serafini <serafini.nicolas@gmail.com>
2021-05-30 23:46:01 +00:00
Additional arguments:
2019-02-09 23:25:01 +00:00
Prepare to merge (#228)
* Fix loginbox position for vertical arrangements
* Fix tabs everywhere
* 110 Automatically deduce DPI
* 118 Add description for Void Linux installation
* 119 Add Timeout Option
* Update README for multi-monitor
* Keep original directory
* Update README
* Rename project files
* Always use defaults
* Rewrite update() and get_display_list()
* Add lock_timeout to defaults
* Fix ExecStart in systemd unit
* Update README
* Fix bad variable name in wallpaper()
* Remove quoting, it breaks things
* Fix paths and canvas color
* Effects now are optional to speed up updating cache
* Fix fx_dimblur()
* Add shadow to loginbox (#3)
* Add create_loginbox(), add loginshadow option
* Add loginshadow option to example config
* Add solid color background effect (#4)
* Use array and fix quoting
* Add color effect, create solid color backgrounds
* Update README
* Add more arguments and options (#5)
* New arguments and config options
* Update usage more
* Update README
* Minor text edits
* Relocate config and cache (#6)
* Move config and cache directories
* Make sure cache dir exists
* Reorder defaults, clarify options and theme
* Reformat example config
* Moved example config
* Update header info
* Fix quoting in DEFAULT_TIMEOUT
* Rewrite usage()
* Touch up comments and some syntax
* Update README, fix usage
* Fix passing arguments to i3lock
lockargs needs to be an array so that it can expand to multiple
arguments (preferable to using wordsplitting or eval instead).
* Scale loginbox based on DPI
Fixes jeffmhubbard/multilockscreen#7.
* Add failsafe to lock screen when images not found (#13)
* Add optional description box (#10)
* Add optional description box
The box is located in the bottom right corner
of the lock screen image and contains a
custom description message
(e.g. to present a name for random images
or to display additional information)
Added option: --desc <DESCRIPTION>
* Adapt description to i3lock date font
* Description font queried like in i3lock-color
* description: force normal upright font style
* added support for dimpixel effect (#16)
* added support for using different images on different displays (#17)
* added support for using different images on different displays
* fixed list creation when passed a single image
* reworked how WALL_LIST is generated
* Fix span output (#19)
* Make output reflect one set of images is processed
* Return only 1 image when spanning
* Correct output in a few spots
* Add fancy output (#20)
* Add echo wrapper to prefix output
* Fix typo
* Update README.md (#21)
* Fixes misspelled fn (#22)
* Escape spaces in path for IM (#24)
* Minor fixes (#26)
* Better parsing --lock args
* Add --pass-media-keys
* Add --pass-screen-keys and --pass-power-keys
* Fix insanely short default timeout
* Make error text transparent
* Call init_config later, update example config (#27)
Reading config file later allows users to define
custom functions in config (prelock, postlock, etc)
Updated docs with example usage
* Fix suspend (#30)
* Fix borked logic in --lock arg that breaks suspend
* Don't check before all arguments read
* Use `dunstctl` to (un)pause the dunst pre/post-lock. (#31)
Please be aware that, the use of dunstctl means that users will be forced to have dunst v1.5.0 or newer installed.
* Update LICENSE
* Disable DPMS after unlocking if it was originally disabled (#32)
* feat[multilockscreen]: Add --show-layout option (#36)
* Only change DPMS timeout if Enabled (#38)
* Fix #40 (#41)
Don't wait for `prelock()` and `postlock()` to complete
* Add bgcolor option to set i3lock --color (#44)
Closes #43
* Update systemd unit (#45)
* Fix options name for i3color-lock release 2.13.c.3 (#49)
With release 2.13.c.3 i3color-lock has added dashes before color, pos, size, etc.
https://github.com/Raymo111/i3lock-color/releases/tag/2.13.c.3
* Add checklist
* Rename script
* Extra files from upstream
* Update README
Keep most of betterlockscreen README. Replaced configuration,
usage, and usage examples.
* Update example config
* Fix branding, paths, etc
* Add wallpaper_cmd and time_format, long arg only
* Fix quoting, remove unused variable
Co-authored-by: Fox Kiester <noct@posteo.net>
Co-authored-by: Richard <fr34q@users.noreply.github.com>
Co-authored-by: Sheeets <31318683+sheeets@users.noreply.github.com>
Co-authored-by: Paul Zeinlinger <paul.zeinlinger@gmail.com>
Co-authored-by: Luc Caspar <casparluc@users.noreply.github.com>
Co-authored-by: R. David Dunphy <rdd.dunphy@gmail.com>
Co-authored-by: Artem Vasenin <vasart169@gmail.com>
Co-authored-by: Nicolas Serafini <serafini.nicolas@gmail.com>
2021-05-30 23:46:01 +00:00
--display < N >
Set display to draw loginbox
2018-05-19 15:16:04 +00:00
Prepare to merge (#228)
* Fix loginbox position for vertical arrangements
* Fix tabs everywhere
* 110 Automatically deduce DPI
* 118 Add description for Void Linux installation
* 119 Add Timeout Option
* Update README for multi-monitor
* Keep original directory
* Update README
* Rename project files
* Always use defaults
* Rewrite update() and get_display_list()
* Add lock_timeout to defaults
* Fix ExecStart in systemd unit
* Update README
* Fix bad variable name in wallpaper()
* Remove quoting, it breaks things
* Fix paths and canvas color
* Effects now are optional to speed up updating cache
* Fix fx_dimblur()
* Add shadow to loginbox (#3)
* Add create_loginbox(), add loginshadow option
* Add loginshadow option to example config
* Add solid color background effect (#4)
* Use array and fix quoting
* Add color effect, create solid color backgrounds
* Update README
* Add more arguments and options (#5)
* New arguments and config options
* Update usage more
* Update README
* Minor text edits
* Relocate config and cache (#6)
* Move config and cache directories
* Make sure cache dir exists
* Reorder defaults, clarify options and theme
* Reformat example config
* Moved example config
* Update header info
* Fix quoting in DEFAULT_TIMEOUT
* Rewrite usage()
* Touch up comments and some syntax
* Update README, fix usage
* Fix passing arguments to i3lock
lockargs needs to be an array so that it can expand to multiple
arguments (preferable to using wordsplitting or eval instead).
* Scale loginbox based on DPI
Fixes jeffmhubbard/multilockscreen#7.
* Add failsafe to lock screen when images not found (#13)
* Add optional description box (#10)
* Add optional description box
The box is located in the bottom right corner
of the lock screen image and contains a
custom description message
(e.g. to present a name for random images
or to display additional information)
Added option: --desc <DESCRIPTION>
* Adapt description to i3lock date font
* Description font queried like in i3lock-color
* description: force normal upright font style
* added support for dimpixel effect (#16)
* added support for using different images on different displays (#17)
* added support for using different images on different displays
* fixed list creation when passed a single image
* reworked how WALL_LIST is generated
* Fix span output (#19)
* Make output reflect one set of images is processed
* Return only 1 image when spanning
* Correct output in a few spots
* Add fancy output (#20)
* Add echo wrapper to prefix output
* Fix typo
* Update README.md (#21)
* Fixes misspelled fn (#22)
* Escape spaces in path for IM (#24)
* Minor fixes (#26)
* Better parsing --lock args
* Add --pass-media-keys
* Add --pass-screen-keys and --pass-power-keys
* Fix insanely short default timeout
* Make error text transparent
* Call init_config later, update example config (#27)
Reading config file later allows users to define
custom functions in config (prelock, postlock, etc)
Updated docs with example usage
* Fix suspend (#30)
* Fix borked logic in --lock arg that breaks suspend
* Don't check before all arguments read
* Use `dunstctl` to (un)pause the dunst pre/post-lock. (#31)
Please be aware that, the use of dunstctl means that users will be forced to have dunst v1.5.0 or newer installed.
* Update LICENSE
* Disable DPMS after unlocking if it was originally disabled (#32)
* feat[multilockscreen]: Add --show-layout option (#36)
* Only change DPMS timeout if Enabled (#38)
* Fix #40 (#41)
Don't wait for `prelock()` and `postlock()` to complete
* Add bgcolor option to set i3lock --color (#44)
Closes #43
* Update systemd unit (#45)
* Fix options name for i3color-lock release 2.13.c.3 (#49)
With release 2.13.c.3 i3color-lock has added dashes before color, pos, size, etc.
https://github.com/Raymo111/i3lock-color/releases/tag/2.13.c.3
* Add checklist
* Rename script
* Extra files from upstream
* Update README
Keep most of betterlockscreen README. Replaced configuration,
usage, and usage examples.
* Update example config
* Fix branding, paths, etc
* Add wallpaper_cmd and time_format, long arg only
* Fix quoting, remove unused variable
Co-authored-by: Fox Kiester <noct@posteo.net>
Co-authored-by: Richard <fr34q@users.noreply.github.com>
Co-authored-by: Sheeets <31318683+sheeets@users.noreply.github.com>
Co-authored-by: Paul Zeinlinger <paul.zeinlinger@gmail.com>
Co-authored-by: Luc Caspar <casparluc@users.noreply.github.com>
Co-authored-by: R. David Dunphy <rdd.dunphy@gmail.com>
Co-authored-by: Artem Vasenin <vasart169@gmail.com>
Co-authored-by: Nicolas Serafini <serafini.nicolas@gmail.com>
2021-05-30 23:46:01 +00:00
--span
Scale image to span multiple displays
2017-12-07 18:51:34 +00:00
Prepare to merge (#228)
* Fix loginbox position for vertical arrangements
* Fix tabs everywhere
* 110 Automatically deduce DPI
* 118 Add description for Void Linux installation
* 119 Add Timeout Option
* Update README for multi-monitor
* Keep original directory
* Update README
* Rename project files
* Always use defaults
* Rewrite update() and get_display_list()
* Add lock_timeout to defaults
* Fix ExecStart in systemd unit
* Update README
* Fix bad variable name in wallpaper()
* Remove quoting, it breaks things
* Fix paths and canvas color
* Effects now are optional to speed up updating cache
* Fix fx_dimblur()
* Add shadow to loginbox (#3)
* Add create_loginbox(), add loginshadow option
* Add loginshadow option to example config
* Add solid color background effect (#4)
* Use array and fix quoting
* Add color effect, create solid color backgrounds
* Update README
* Add more arguments and options (#5)
* New arguments and config options
* Update usage more
* Update README
* Minor text edits
* Relocate config and cache (#6)
* Move config and cache directories
* Make sure cache dir exists
* Reorder defaults, clarify options and theme
* Reformat example config
* Moved example config
* Update header info
* Fix quoting in DEFAULT_TIMEOUT
* Rewrite usage()
* Touch up comments and some syntax
* Update README, fix usage
* Fix passing arguments to i3lock
lockargs needs to be an array so that it can expand to multiple
arguments (preferable to using wordsplitting or eval instead).
* Scale loginbox based on DPI
Fixes jeffmhubbard/multilockscreen#7.
* Add failsafe to lock screen when images not found (#13)
* Add optional description box (#10)
* Add optional description box
The box is located in the bottom right corner
of the lock screen image and contains a
custom description message
(e.g. to present a name for random images
or to display additional information)
Added option: --desc <DESCRIPTION>
* Adapt description to i3lock date font
* Description font queried like in i3lock-color
* description: force normal upright font style
* added support for dimpixel effect (#16)
* added support for using different images on different displays (#17)
* added support for using different images on different displays
* fixed list creation when passed a single image
* reworked how WALL_LIST is generated
* Fix span output (#19)
* Make output reflect one set of images is processed
* Return only 1 image when spanning
* Correct output in a few spots
* Add fancy output (#20)
* Add echo wrapper to prefix output
* Fix typo
* Update README.md (#21)
* Fixes misspelled fn (#22)
* Escape spaces in path for IM (#24)
* Minor fixes (#26)
* Better parsing --lock args
* Add --pass-media-keys
* Add --pass-screen-keys and --pass-power-keys
* Fix insanely short default timeout
* Make error text transparent
* Call init_config later, update example config (#27)
Reading config file later allows users to define
custom functions in config (prelock, postlock, etc)
Updated docs with example usage
* Fix suspend (#30)
* Fix borked logic in --lock arg that breaks suspend
* Don't check before all arguments read
* Use `dunstctl` to (un)pause the dunst pre/post-lock. (#31)
Please be aware that, the use of dunstctl means that users will be forced to have dunst v1.5.0 or newer installed.
* Update LICENSE
* Disable DPMS after unlocking if it was originally disabled (#32)
* feat[multilockscreen]: Add --show-layout option (#36)
* Only change DPMS timeout if Enabled (#38)
* Fix #40 (#41)
Don't wait for `prelock()` and `postlock()` to complete
* Add bgcolor option to set i3lock --color (#44)
Closes #43
* Update systemd unit (#45)
* Fix options name for i3color-lock release 2.13.c.3 (#49)
With release 2.13.c.3 i3color-lock has added dashes before color, pos, size, etc.
https://github.com/Raymo111/i3lock-color/releases/tag/2.13.c.3
* Add checklist
* Rename script
* Extra files from upstream
* Update README
Keep most of betterlockscreen README. Replaced configuration,
usage, and usage examples.
* Update example config
* Fix branding, paths, etc
* Add wallpaper_cmd and time_format, long arg only
* Fix quoting, remove unused variable
Co-authored-by: Fox Kiester <noct@posteo.net>
Co-authored-by: Richard <fr34q@users.noreply.github.com>
Co-authored-by: Sheeets <31318683+sheeets@users.noreply.github.com>
Co-authored-by: Paul Zeinlinger <paul.zeinlinger@gmail.com>
Co-authored-by: Luc Caspar <casparluc@users.noreply.github.com>
Co-authored-by: R. David Dunphy <rdd.dunphy@gmail.com>
Co-authored-by: Artem Vasenin <vasart169@gmail.com>
Co-authored-by: Nicolas Serafini <serafini.nicolas@gmail.com>
2021-05-30 23:46:01 +00:00
--off < N >
2021-08-21 00:15:51 +00:00
Turn display off after N seconds
2017-12-07 18:51:34 +00:00
Prepare to merge (#228)
* Fix loginbox position for vertical arrangements
* Fix tabs everywhere
* 110 Automatically deduce DPI
* 118 Add description for Void Linux installation
* 119 Add Timeout Option
* Update README for multi-monitor
* Keep original directory
* Update README
* Rename project files
* Always use defaults
* Rewrite update() and get_display_list()
* Add lock_timeout to defaults
* Fix ExecStart in systemd unit
* Update README
* Fix bad variable name in wallpaper()
* Remove quoting, it breaks things
* Fix paths and canvas color
* Effects now are optional to speed up updating cache
* Fix fx_dimblur()
* Add shadow to loginbox (#3)
* Add create_loginbox(), add loginshadow option
* Add loginshadow option to example config
* Add solid color background effect (#4)
* Use array and fix quoting
* Add color effect, create solid color backgrounds
* Update README
* Add more arguments and options (#5)
* New arguments and config options
* Update usage more
* Update README
* Minor text edits
* Relocate config and cache (#6)
* Move config and cache directories
* Make sure cache dir exists
* Reorder defaults, clarify options and theme
* Reformat example config
* Moved example config
* Update header info
* Fix quoting in DEFAULT_TIMEOUT
* Rewrite usage()
* Touch up comments and some syntax
* Update README, fix usage
* Fix passing arguments to i3lock
lockargs needs to be an array so that it can expand to multiple
arguments (preferable to using wordsplitting or eval instead).
* Scale loginbox based on DPI
Fixes jeffmhubbard/multilockscreen#7.
* Add failsafe to lock screen when images not found (#13)
* Add optional description box (#10)
* Add optional description box
The box is located in the bottom right corner
of the lock screen image and contains a
custom description message
(e.g. to present a name for random images
or to display additional information)
Added option: --desc <DESCRIPTION>
* Adapt description to i3lock date font
* Description font queried like in i3lock-color
* description: force normal upright font style
* added support for dimpixel effect (#16)
* added support for using different images on different displays (#17)
* added support for using different images on different displays
* fixed list creation when passed a single image
* reworked how WALL_LIST is generated
* Fix span output (#19)
* Make output reflect one set of images is processed
* Return only 1 image when spanning
* Correct output in a few spots
* Add fancy output (#20)
* Add echo wrapper to prefix output
* Fix typo
* Update README.md (#21)
* Fixes misspelled fn (#22)
* Escape spaces in path for IM (#24)
* Minor fixes (#26)
* Better parsing --lock args
* Add --pass-media-keys
* Add --pass-screen-keys and --pass-power-keys
* Fix insanely short default timeout
* Make error text transparent
* Call init_config later, update example config (#27)
Reading config file later allows users to define
custom functions in config (prelock, postlock, etc)
Updated docs with example usage
* Fix suspend (#30)
* Fix borked logic in --lock arg that breaks suspend
* Don't check before all arguments read
* Use `dunstctl` to (un)pause the dunst pre/post-lock. (#31)
Please be aware that, the use of dunstctl means that users will be forced to have dunst v1.5.0 or newer installed.
* Update LICENSE
* Disable DPMS after unlocking if it was originally disabled (#32)
* feat[multilockscreen]: Add --show-layout option (#36)
* Only change DPMS timeout if Enabled (#38)
* Fix #40 (#41)
Don't wait for `prelock()` and `postlock()` to complete
* Add bgcolor option to set i3lock --color (#44)
Closes #43
* Update systemd unit (#45)
* Fix options name for i3color-lock release 2.13.c.3 (#49)
With release 2.13.c.3 i3color-lock has added dashes before color, pos, size, etc.
https://github.com/Raymo111/i3lock-color/releases/tag/2.13.c.3
* Add checklist
* Rename script
* Extra files from upstream
* Update README
Keep most of betterlockscreen README. Replaced configuration,
usage, and usage examples.
* Update example config
* Fix branding, paths, etc
* Add wallpaper_cmd and time_format, long arg only
* Fix quoting, remove unused variable
Co-authored-by: Fox Kiester <noct@posteo.net>
Co-authored-by: Richard <fr34q@users.noreply.github.com>
Co-authored-by: Sheeets <31318683+sheeets@users.noreply.github.com>
Co-authored-by: Paul Zeinlinger <paul.zeinlinger@gmail.com>
Co-authored-by: Luc Caspar <casparluc@users.noreply.github.com>
Co-authored-by: R. David Dunphy <rdd.dunphy@gmail.com>
Co-authored-by: Artem Vasenin <vasart169@gmail.com>
Co-authored-by: Nicolas Serafini <serafini.nicolas@gmail.com>
2021-05-30 23:46:01 +00:00
--fx < EFFECT , EFFECT , EFFECT >
List of effects to apply
2017-12-07 18:51:34 +00:00
Prepare to merge (#228)
* Fix loginbox position for vertical arrangements
* Fix tabs everywhere
* 110 Automatically deduce DPI
* 118 Add description for Void Linux installation
* 119 Add Timeout Option
* Update README for multi-monitor
* Keep original directory
* Update README
* Rename project files
* Always use defaults
* Rewrite update() and get_display_list()
* Add lock_timeout to defaults
* Fix ExecStart in systemd unit
* Update README
* Fix bad variable name in wallpaper()
* Remove quoting, it breaks things
* Fix paths and canvas color
* Effects now are optional to speed up updating cache
* Fix fx_dimblur()
* Add shadow to loginbox (#3)
* Add create_loginbox(), add loginshadow option
* Add loginshadow option to example config
* Add solid color background effect (#4)
* Use array and fix quoting
* Add color effect, create solid color backgrounds
* Update README
* Add more arguments and options (#5)
* New arguments and config options
* Update usage more
* Update README
* Minor text edits
* Relocate config and cache (#6)
* Move config and cache directories
* Make sure cache dir exists
* Reorder defaults, clarify options and theme
* Reformat example config
* Moved example config
* Update header info
* Fix quoting in DEFAULT_TIMEOUT
* Rewrite usage()
* Touch up comments and some syntax
* Update README, fix usage
* Fix passing arguments to i3lock
lockargs needs to be an array so that it can expand to multiple
arguments (preferable to using wordsplitting or eval instead).
* Scale loginbox based on DPI
Fixes jeffmhubbard/multilockscreen#7.
* Add failsafe to lock screen when images not found (#13)
* Add optional description box (#10)
* Add optional description box
The box is located in the bottom right corner
of the lock screen image and contains a
custom description message
(e.g. to present a name for random images
or to display additional information)
Added option: --desc <DESCRIPTION>
* Adapt description to i3lock date font
* Description font queried like in i3lock-color
* description: force normal upright font style
* added support for dimpixel effect (#16)
* added support for using different images on different displays (#17)
* added support for using different images on different displays
* fixed list creation when passed a single image
* reworked how WALL_LIST is generated
* Fix span output (#19)
* Make output reflect one set of images is processed
* Return only 1 image when spanning
* Correct output in a few spots
* Add fancy output (#20)
* Add echo wrapper to prefix output
* Fix typo
* Update README.md (#21)
* Fixes misspelled fn (#22)
* Escape spaces in path for IM (#24)
* Minor fixes (#26)
* Better parsing --lock args
* Add --pass-media-keys
* Add --pass-screen-keys and --pass-power-keys
* Fix insanely short default timeout
* Make error text transparent
* Call init_config later, update example config (#27)
Reading config file later allows users to define
custom functions in config (prelock, postlock, etc)
Updated docs with example usage
* Fix suspend (#30)
* Fix borked logic in --lock arg that breaks suspend
* Don't check before all arguments read
* Use `dunstctl` to (un)pause the dunst pre/post-lock. (#31)
Please be aware that, the use of dunstctl means that users will be forced to have dunst v1.5.0 or newer installed.
* Update LICENSE
* Disable DPMS after unlocking if it was originally disabled (#32)
* feat[multilockscreen]: Add --show-layout option (#36)
* Only change DPMS timeout if Enabled (#38)
* Fix #40 (#41)
Don't wait for `prelock()` and `postlock()` to complete
* Add bgcolor option to set i3lock --color (#44)
Closes #43
* Update systemd unit (#45)
* Fix options name for i3color-lock release 2.13.c.3 (#49)
With release 2.13.c.3 i3color-lock has added dashes before color, pos, size, etc.
https://github.com/Raymo111/i3lock-color/releases/tag/2.13.c.3
* Add checklist
* Rename script
* Extra files from upstream
* Update README
Keep most of betterlockscreen README. Replaced configuration,
usage, and usage examples.
* Update example config
* Fix branding, paths, etc
* Add wallpaper_cmd and time_format, long arg only
* Fix quoting, remove unused variable
Co-authored-by: Fox Kiester <noct@posteo.net>
Co-authored-by: Richard <fr34q@users.noreply.github.com>
Co-authored-by: Sheeets <31318683+sheeets@users.noreply.github.com>
Co-authored-by: Paul Zeinlinger <paul.zeinlinger@gmail.com>
Co-authored-by: Luc Caspar <casparluc@users.noreply.github.com>
Co-authored-by: R. David Dunphy <rdd.dunphy@gmail.com>
Co-authored-by: Artem Vasenin <vasart169@gmail.com>
Co-authored-by: Nicolas Serafini <serafini.nicolas@gmail.com>
2021-05-30 23:46:01 +00:00
-- < ARGS >
Pass following arguments to i3lock
2018-09-18 18:40:52 +00:00
Prepare to merge (#228)
* Fix loginbox position for vertical arrangements
* Fix tabs everywhere
* 110 Automatically deduce DPI
* 118 Add description for Void Linux installation
* 119 Add Timeout Option
* Update README for multi-monitor
* Keep original directory
* Update README
* Rename project files
* Always use defaults
* Rewrite update() and get_display_list()
* Add lock_timeout to defaults
* Fix ExecStart in systemd unit
* Update README
* Fix bad variable name in wallpaper()
* Remove quoting, it breaks things
* Fix paths and canvas color
* Effects now are optional to speed up updating cache
* Fix fx_dimblur()
* Add shadow to loginbox (#3)
* Add create_loginbox(), add loginshadow option
* Add loginshadow option to example config
* Add solid color background effect (#4)
* Use array and fix quoting
* Add color effect, create solid color backgrounds
* Update README
* Add more arguments and options (#5)
* New arguments and config options
* Update usage more
* Update README
* Minor text edits
* Relocate config and cache (#6)
* Move config and cache directories
* Make sure cache dir exists
* Reorder defaults, clarify options and theme
* Reformat example config
* Moved example config
* Update header info
* Fix quoting in DEFAULT_TIMEOUT
* Rewrite usage()
* Touch up comments and some syntax
* Update README, fix usage
* Fix passing arguments to i3lock
lockargs needs to be an array so that it can expand to multiple
arguments (preferable to using wordsplitting or eval instead).
* Scale loginbox based on DPI
Fixes jeffmhubbard/multilockscreen#7.
* Add failsafe to lock screen when images not found (#13)
* Add optional description box (#10)
* Add optional description box
The box is located in the bottom right corner
of the lock screen image and contains a
custom description message
(e.g. to present a name for random images
or to display additional information)
Added option: --desc <DESCRIPTION>
* Adapt description to i3lock date font
* Description font queried like in i3lock-color
* description: force normal upright font style
* added support for dimpixel effect (#16)
* added support for using different images on different displays (#17)
* added support for using different images on different displays
* fixed list creation when passed a single image
* reworked how WALL_LIST is generated
* Fix span output (#19)
* Make output reflect one set of images is processed
* Return only 1 image when spanning
* Correct output in a few spots
* Add fancy output (#20)
* Add echo wrapper to prefix output
* Fix typo
* Update README.md (#21)
* Fixes misspelled fn (#22)
* Escape spaces in path for IM (#24)
* Minor fixes (#26)
* Better parsing --lock args
* Add --pass-media-keys
* Add --pass-screen-keys and --pass-power-keys
* Fix insanely short default timeout
* Make error text transparent
* Call init_config later, update example config (#27)
Reading config file later allows users to define
custom functions in config (prelock, postlock, etc)
Updated docs with example usage
* Fix suspend (#30)
* Fix borked logic in --lock arg that breaks suspend
* Don't check before all arguments read
* Use `dunstctl` to (un)pause the dunst pre/post-lock. (#31)
Please be aware that, the use of dunstctl means that users will be forced to have dunst v1.5.0 or newer installed.
* Update LICENSE
* Disable DPMS after unlocking if it was originally disabled (#32)
* feat[multilockscreen]: Add --show-layout option (#36)
* Only change DPMS timeout if Enabled (#38)
* Fix #40 (#41)
Don't wait for `prelock()` and `postlock()` to complete
* Add bgcolor option to set i3lock --color (#44)
Closes #43
* Update systemd unit (#45)
* Fix options name for i3color-lock release 2.13.c.3 (#49)
With release 2.13.c.3 i3color-lock has added dashes before color, pos, size, etc.
https://github.com/Raymo111/i3lock-color/releases/tag/2.13.c.3
* Add checklist
* Rename script
* Extra files from upstream
* Update README
Keep most of betterlockscreen README. Replaced configuration,
usage, and usage examples.
* Update example config
* Fix branding, paths, etc
* Add wallpaper_cmd and time_format, long arg only
* Fix quoting, remove unused variable
Co-authored-by: Fox Kiester <noct@posteo.net>
Co-authored-by: Richard <fr34q@users.noreply.github.com>
Co-authored-by: Sheeets <31318683+sheeets@users.noreply.github.com>
Co-authored-by: Paul Zeinlinger <paul.zeinlinger@gmail.com>
Co-authored-by: Luc Caspar <casparluc@users.noreply.github.com>
Co-authored-by: R. David Dunphy <rdd.dunphy@gmail.com>
Co-authored-by: Artem Vasenin <vasart169@gmail.com>
Co-authored-by: Nicolas Serafini <serafini.nicolas@gmail.com>
2021-05-30 23:46:01 +00:00
Effects arguments:
2018-09-18 18:40:52 +00:00
Prepare to merge (#228)
* Fix loginbox position for vertical arrangements
* Fix tabs everywhere
* 110 Automatically deduce DPI
* 118 Add description for Void Linux installation
* 119 Add Timeout Option
* Update README for multi-monitor
* Keep original directory
* Update README
* Rename project files
* Always use defaults
* Rewrite update() and get_display_list()
* Add lock_timeout to defaults
* Fix ExecStart in systemd unit
* Update README
* Fix bad variable name in wallpaper()
* Remove quoting, it breaks things
* Fix paths and canvas color
* Effects now are optional to speed up updating cache
* Fix fx_dimblur()
* Add shadow to loginbox (#3)
* Add create_loginbox(), add loginshadow option
* Add loginshadow option to example config
* Add solid color background effect (#4)
* Use array and fix quoting
* Add color effect, create solid color backgrounds
* Update README
* Add more arguments and options (#5)
* New arguments and config options
* Update usage more
* Update README
* Minor text edits
* Relocate config and cache (#6)
* Move config and cache directories
* Make sure cache dir exists
* Reorder defaults, clarify options and theme
* Reformat example config
* Moved example config
* Update header info
* Fix quoting in DEFAULT_TIMEOUT
* Rewrite usage()
* Touch up comments and some syntax
* Update README, fix usage
* Fix passing arguments to i3lock
lockargs needs to be an array so that it can expand to multiple
arguments (preferable to using wordsplitting or eval instead).
* Scale loginbox based on DPI
Fixes jeffmhubbard/multilockscreen#7.
* Add failsafe to lock screen when images not found (#13)
* Add optional description box (#10)
* Add optional description box
The box is located in the bottom right corner
of the lock screen image and contains a
custom description message
(e.g. to present a name for random images
or to display additional information)
Added option: --desc <DESCRIPTION>
* Adapt description to i3lock date font
* Description font queried like in i3lock-color
* description: force normal upright font style
* added support for dimpixel effect (#16)
* added support for using different images on different displays (#17)
* added support for using different images on different displays
* fixed list creation when passed a single image
* reworked how WALL_LIST is generated
* Fix span output (#19)
* Make output reflect one set of images is processed
* Return only 1 image when spanning
* Correct output in a few spots
* Add fancy output (#20)
* Add echo wrapper to prefix output
* Fix typo
* Update README.md (#21)
* Fixes misspelled fn (#22)
* Escape spaces in path for IM (#24)
* Minor fixes (#26)
* Better parsing --lock args
* Add --pass-media-keys
* Add --pass-screen-keys and --pass-power-keys
* Fix insanely short default timeout
* Make error text transparent
* Call init_config later, update example config (#27)
Reading config file later allows users to define
custom functions in config (prelock, postlock, etc)
Updated docs with example usage
* Fix suspend (#30)
* Fix borked logic in --lock arg that breaks suspend
* Don't check before all arguments read
* Use `dunstctl` to (un)pause the dunst pre/post-lock. (#31)
Please be aware that, the use of dunstctl means that users will be forced to have dunst v1.5.0 or newer installed.
* Update LICENSE
* Disable DPMS after unlocking if it was originally disabled (#32)
* feat[multilockscreen]: Add --show-layout option (#36)
* Only change DPMS timeout if Enabled (#38)
* Fix #40 (#41)
Don't wait for `prelock()` and `postlock()` to complete
* Add bgcolor option to set i3lock --color (#44)
Closes #43
* Update systemd unit (#45)
* Fix options name for i3color-lock release 2.13.c.3 (#49)
With release 2.13.c.3 i3color-lock has added dashes before color, pos, size, etc.
https://github.com/Raymo111/i3lock-color/releases/tag/2.13.c.3
* Add checklist
* Rename script
* Extra files from upstream
* Update README
Keep most of betterlockscreen README. Replaced configuration,
usage, and usage examples.
* Update example config
* Fix branding, paths, etc
* Add wallpaper_cmd and time_format, long arg only
* Fix quoting, remove unused variable
Co-authored-by: Fox Kiester <noct@posteo.net>
Co-authored-by: Richard <fr34q@users.noreply.github.com>
Co-authored-by: Sheeets <31318683+sheeets@users.noreply.github.com>
Co-authored-by: Paul Zeinlinger <paul.zeinlinger@gmail.com>
Co-authored-by: Luc Caspar <casparluc@users.noreply.github.com>
Co-authored-by: R. David Dunphy <rdd.dunphy@gmail.com>
Co-authored-by: Artem Vasenin <vasart169@gmail.com>
Co-authored-by: Nicolas Serafini <serafini.nicolas@gmail.com>
2021-05-30 23:46:01 +00:00
--dim < N >
Dim image N percent (0-100)
--blur < N >
Blur image N amount (0.0-1.0)
--pixel < N , N >
Pixelate image with N shrink and N grow (unsupported)
--color < HEX >
Solid color background with HEX
2017-12-11 01:22:40 +00:00
```
2017-12-07 18:59:37 +00:00
Prepare to merge (#228)
* Fix loginbox position for vertical arrangements
* Fix tabs everywhere
* 110 Automatically deduce DPI
* 118 Add description for Void Linux installation
* 119 Add Timeout Option
* Update README for multi-monitor
* Keep original directory
* Update README
* Rename project files
* Always use defaults
* Rewrite update() and get_display_list()
* Add lock_timeout to defaults
* Fix ExecStart in systemd unit
* Update README
* Fix bad variable name in wallpaper()
* Remove quoting, it breaks things
* Fix paths and canvas color
* Effects now are optional to speed up updating cache
* Fix fx_dimblur()
* Add shadow to loginbox (#3)
* Add create_loginbox(), add loginshadow option
* Add loginshadow option to example config
* Add solid color background effect (#4)
* Use array and fix quoting
* Add color effect, create solid color backgrounds
* Update README
* Add more arguments and options (#5)
* New arguments and config options
* Update usage more
* Update README
* Minor text edits
* Relocate config and cache (#6)
* Move config and cache directories
* Make sure cache dir exists
* Reorder defaults, clarify options and theme
* Reformat example config
* Moved example config
* Update header info
* Fix quoting in DEFAULT_TIMEOUT
* Rewrite usage()
* Touch up comments and some syntax
* Update README, fix usage
* Fix passing arguments to i3lock
lockargs needs to be an array so that it can expand to multiple
arguments (preferable to using wordsplitting or eval instead).
* Scale loginbox based on DPI
Fixes jeffmhubbard/multilockscreen#7.
* Add failsafe to lock screen when images not found (#13)
* Add optional description box (#10)
* Add optional description box
The box is located in the bottom right corner
of the lock screen image and contains a
custom description message
(e.g. to present a name for random images
or to display additional information)
Added option: --desc <DESCRIPTION>
* Adapt description to i3lock date font
* Description font queried like in i3lock-color
* description: force normal upright font style
* added support for dimpixel effect (#16)
* added support for using different images on different displays (#17)
* added support for using different images on different displays
* fixed list creation when passed a single image
* reworked how WALL_LIST is generated
* Fix span output (#19)
* Make output reflect one set of images is processed
* Return only 1 image when spanning
* Correct output in a few spots
* Add fancy output (#20)
* Add echo wrapper to prefix output
* Fix typo
* Update README.md (#21)
* Fixes misspelled fn (#22)
* Escape spaces in path for IM (#24)
* Minor fixes (#26)
* Better parsing --lock args
* Add --pass-media-keys
* Add --pass-screen-keys and --pass-power-keys
* Fix insanely short default timeout
* Make error text transparent
* Call init_config later, update example config (#27)
Reading config file later allows users to define
custom functions in config (prelock, postlock, etc)
Updated docs with example usage
* Fix suspend (#30)
* Fix borked logic in --lock arg that breaks suspend
* Don't check before all arguments read
* Use `dunstctl` to (un)pause the dunst pre/post-lock. (#31)
Please be aware that, the use of dunstctl means that users will be forced to have dunst v1.5.0 or newer installed.
* Update LICENSE
* Disable DPMS after unlocking if it was originally disabled (#32)
* feat[multilockscreen]: Add --show-layout option (#36)
* Only change DPMS timeout if Enabled (#38)
* Fix #40 (#41)
Don't wait for `prelock()` and `postlock()` to complete
* Add bgcolor option to set i3lock --color (#44)
Closes #43
* Update systemd unit (#45)
* Fix options name for i3color-lock release 2.13.c.3 (#49)
With release 2.13.c.3 i3color-lock has added dashes before color, pos, size, etc.
https://github.com/Raymo111/i3lock-color/releases/tag/2.13.c.3
* Add checklist
* Rename script
* Extra files from upstream
* Update README
Keep most of betterlockscreen README. Replaced configuration,
usage, and usage examples.
* Update example config
* Fix branding, paths, etc
* Add wallpaper_cmd and time_format, long arg only
* Fix quoting, remove unused variable
Co-authored-by: Fox Kiester <noct@posteo.net>
Co-authored-by: Richard <fr34q@users.noreply.github.com>
Co-authored-by: Sheeets <31318683+sheeets@users.noreply.github.com>
Co-authored-by: Paul Zeinlinger <paul.zeinlinger@gmail.com>
Co-authored-by: Luc Caspar <casparluc@users.noreply.github.com>
Co-authored-by: R. David Dunphy <rdd.dunphy@gmail.com>
Co-authored-by: Artem Vasenin <vasart169@gmail.com>
Co-authored-by: Nicolas Serafini <serafini.nicolas@gmail.com>
2021-05-30 23:46:01 +00:00
2021-06-30 14:35:39 +00:00
#### Examples
Prepare to merge (#228)
* Fix loginbox position for vertical arrangements
* Fix tabs everywhere
* 110 Automatically deduce DPI
* 118 Add description for Void Linux installation
* 119 Add Timeout Option
* Update README for multi-monitor
* Keep original directory
* Update README
* Rename project files
* Always use defaults
* Rewrite update() and get_display_list()
* Add lock_timeout to defaults
* Fix ExecStart in systemd unit
* Update README
* Fix bad variable name in wallpaper()
* Remove quoting, it breaks things
* Fix paths and canvas color
* Effects now are optional to speed up updating cache
* Fix fx_dimblur()
* Add shadow to loginbox (#3)
* Add create_loginbox(), add loginshadow option
* Add loginshadow option to example config
* Add solid color background effect (#4)
* Use array and fix quoting
* Add color effect, create solid color backgrounds
* Update README
* Add more arguments and options (#5)
* New arguments and config options
* Update usage more
* Update README
* Minor text edits
* Relocate config and cache (#6)
* Move config and cache directories
* Make sure cache dir exists
* Reorder defaults, clarify options and theme
* Reformat example config
* Moved example config
* Update header info
* Fix quoting in DEFAULT_TIMEOUT
* Rewrite usage()
* Touch up comments and some syntax
* Update README, fix usage
* Fix passing arguments to i3lock
lockargs needs to be an array so that it can expand to multiple
arguments (preferable to using wordsplitting or eval instead).
* Scale loginbox based on DPI
Fixes jeffmhubbard/multilockscreen#7.
* Add failsafe to lock screen when images not found (#13)
* Add optional description box (#10)
* Add optional description box
The box is located in the bottom right corner
of the lock screen image and contains a
custom description message
(e.g. to present a name for random images
or to display additional information)
Added option: --desc <DESCRIPTION>
* Adapt description to i3lock date font
* Description font queried like in i3lock-color
* description: force normal upright font style
* added support for dimpixel effect (#16)
* added support for using different images on different displays (#17)
* added support for using different images on different displays
* fixed list creation when passed a single image
* reworked how WALL_LIST is generated
* Fix span output (#19)
* Make output reflect one set of images is processed
* Return only 1 image when spanning
* Correct output in a few spots
* Add fancy output (#20)
* Add echo wrapper to prefix output
* Fix typo
* Update README.md (#21)
* Fixes misspelled fn (#22)
* Escape spaces in path for IM (#24)
* Minor fixes (#26)
* Better parsing --lock args
* Add --pass-media-keys
* Add --pass-screen-keys and --pass-power-keys
* Fix insanely short default timeout
* Make error text transparent
* Call init_config later, update example config (#27)
Reading config file later allows users to define
custom functions in config (prelock, postlock, etc)
Updated docs with example usage
* Fix suspend (#30)
* Fix borked logic in --lock arg that breaks suspend
* Don't check before all arguments read
* Use `dunstctl` to (un)pause the dunst pre/post-lock. (#31)
Please be aware that, the use of dunstctl means that users will be forced to have dunst v1.5.0 or newer installed.
* Update LICENSE
* Disable DPMS after unlocking if it was originally disabled (#32)
* feat[multilockscreen]: Add --show-layout option (#36)
* Only change DPMS timeout if Enabled (#38)
* Fix #40 (#41)
Don't wait for `prelock()` and `postlock()` to complete
* Add bgcolor option to set i3lock --color (#44)
Closes #43
* Update systemd unit (#45)
* Fix options name for i3color-lock release 2.13.c.3 (#49)
With release 2.13.c.3 i3color-lock has added dashes before color, pos, size, etc.
https://github.com/Raymo111/i3lock-color/releases/tag/2.13.c.3
* Add checklist
* Rename script
* Extra files from upstream
* Update README
Keep most of betterlockscreen README. Replaced configuration,
usage, and usage examples.
* Update example config
* Fix branding, paths, etc
* Add wallpaper_cmd and time_format, long arg only
* Fix quoting, remove unused variable
Co-authored-by: Fox Kiester <noct@posteo.net>
Co-authored-by: Richard <fr34q@users.noreply.github.com>
Co-authored-by: Sheeets <31318683+sheeets@users.noreply.github.com>
Co-authored-by: Paul Zeinlinger <paul.zeinlinger@gmail.com>
Co-authored-by: Luc Caspar <casparluc@users.noreply.github.com>
Co-authored-by: R. David Dunphy <rdd.dunphy@gmail.com>
Co-authored-by: Artem Vasenin <vasart169@gmail.com>
Co-authored-by: Nicolas Serafini <serafini.nicolas@gmail.com>
2021-05-30 23:46:01 +00:00
1. Update image cache with random image
`betterlockscreen -u ~/Wallpapers`
2. Update image cache with only dim and pixel effects
`betterlockscreen -u ~/Wallpapers/image.png --fx dim,pixel`
3. Update image cache with random image, multiple monitors, login on 1, spanning
`betterlockscreen -u ~/Wallpapers/Dual/ --display 1 --span`
4. Update image cache with solid background only (ignore errors)
`betterlockscreen -u . --fx color --color 5833ff`
5. Update image cache with different background images
`betterlockscreen -u ~/Wallpapers/image1.png -u ~/Wallpapers/image2.png`
6. Lock screen with blur effect
`betterlockscreen --lock blur`
7. Lock screen with multiple monitors, spanning
`betterlockscreen -l dimblur --display 1 --span`
2021-06-30 14:35:39 +00:00
## Background
2018-09-18 18:40:52 +00:00
Add this line to `.xinitrc` .
```sh
# set desktop background with custom effect
betterlockscreen -w dim
# Alternative (set last used background)
source ~/.fehbg
2017-12-11 01:22:40 +00:00
```
2018-09-18 18:40:52 +00:00
2021-06-30 14:35:39 +00:00
### i3wm
2018-09-18 18:40:52 +00:00
Add this line to `~/.config/i3/config`
```sh
# set desktop background with custom effect
exec --no-startup-id betterlockscreen -w dim
# Alternative (set last used background)
exec --no-startup-id source ~/.fehbg
2017-12-07 18:51:34 +00:00
```
2021-06-30 14:35:39 +00:00
## Keybindings
2018-09-20 13:46:15 +00:00
2019-01-23 06:42:01 +00:00
To lockscreen using keyboard shortcut
2021-06-30 14:35:39 +00:00
### i3wm
2018-09-18 18:40:52 +00:00
Add this line to your `~/.config/i3/config`
```sh
2018-09-20 13:46:15 +00:00
bindsym $mod+shift+x exec betterlockscreen -l dim
```
2021-06-30 14:35:39 +00:00
### bspwm
2018-09-20 13:46:15 +00:00
Add this line to your `~/.config/sxhkd/sxhkdrc`
```sh
# lockscreen
alt + shift + x
betterlockscreen -l dim
2017-12-11 01:22:40 +00:00
```
2021-06-30 14:35:39 +00:00
< h2 id = "systemd" > Systemd-Service: Lockscreen after sleep/suspend< / h2 >
2018-09-18 18:40:52 +00:00
```sh
# move service file to proper dir (the aur package does this for you)
Prepare to merge (#228)
* Fix loginbox position for vertical arrangements
* Fix tabs everywhere
* 110 Automatically deduce DPI
* 118 Add description for Void Linux installation
* 119 Add Timeout Option
* Update README for multi-monitor
* Keep original directory
* Update README
* Rename project files
* Always use defaults
* Rewrite update() and get_display_list()
* Add lock_timeout to defaults
* Fix ExecStart in systemd unit
* Update README
* Fix bad variable name in wallpaper()
* Remove quoting, it breaks things
* Fix paths and canvas color
* Effects now are optional to speed up updating cache
* Fix fx_dimblur()
* Add shadow to loginbox (#3)
* Add create_loginbox(), add loginshadow option
* Add loginshadow option to example config
* Add solid color background effect (#4)
* Use array and fix quoting
* Add color effect, create solid color backgrounds
* Update README
* Add more arguments and options (#5)
* New arguments and config options
* Update usage more
* Update README
* Minor text edits
* Relocate config and cache (#6)
* Move config and cache directories
* Make sure cache dir exists
* Reorder defaults, clarify options and theme
* Reformat example config
* Moved example config
* Update header info
* Fix quoting in DEFAULT_TIMEOUT
* Rewrite usage()
* Touch up comments and some syntax
* Update README, fix usage
* Fix passing arguments to i3lock
lockargs needs to be an array so that it can expand to multiple
arguments (preferable to using wordsplitting or eval instead).
* Scale loginbox based on DPI
Fixes jeffmhubbard/multilockscreen#7.
* Add failsafe to lock screen when images not found (#13)
* Add optional description box (#10)
* Add optional description box
The box is located in the bottom right corner
of the lock screen image and contains a
custom description message
(e.g. to present a name for random images
or to display additional information)
Added option: --desc <DESCRIPTION>
* Adapt description to i3lock date font
* Description font queried like in i3lock-color
* description: force normal upright font style
* added support for dimpixel effect (#16)
* added support for using different images on different displays (#17)
* added support for using different images on different displays
* fixed list creation when passed a single image
* reworked how WALL_LIST is generated
* Fix span output (#19)
* Make output reflect one set of images is processed
* Return only 1 image when spanning
* Correct output in a few spots
* Add fancy output (#20)
* Add echo wrapper to prefix output
* Fix typo
* Update README.md (#21)
* Fixes misspelled fn (#22)
* Escape spaces in path for IM (#24)
* Minor fixes (#26)
* Better parsing --lock args
* Add --pass-media-keys
* Add --pass-screen-keys and --pass-power-keys
* Fix insanely short default timeout
* Make error text transparent
* Call init_config later, update example config (#27)
Reading config file later allows users to define
custom functions in config (prelock, postlock, etc)
Updated docs with example usage
* Fix suspend (#30)
* Fix borked logic in --lock arg that breaks suspend
* Don't check before all arguments read
* Use `dunstctl` to (un)pause the dunst pre/post-lock. (#31)
Please be aware that, the use of dunstctl means that users will be forced to have dunst v1.5.0 or newer installed.
* Update LICENSE
* Disable DPMS after unlocking if it was originally disabled (#32)
* feat[multilockscreen]: Add --show-layout option (#36)
* Only change DPMS timeout if Enabled (#38)
* Fix #40 (#41)
Don't wait for `prelock()` and `postlock()` to complete
* Add bgcolor option to set i3lock --color (#44)
Closes #43
* Update systemd unit (#45)
* Fix options name for i3color-lock release 2.13.c.3 (#49)
With release 2.13.c.3 i3color-lock has added dashes before color, pos, size, etc.
https://github.com/Raymo111/i3lock-color/releases/tag/2.13.c.3
* Add checklist
* Rename script
* Extra files from upstream
* Update README
Keep most of betterlockscreen README. Replaced configuration,
usage, and usage examples.
* Update example config
* Fix branding, paths, etc
* Add wallpaper_cmd and time_format, long arg only
* Fix quoting, remove unused variable
Co-authored-by: Fox Kiester <noct@posteo.net>
Co-authored-by: Richard <fr34q@users.noreply.github.com>
Co-authored-by: Sheeets <31318683+sheeets@users.noreply.github.com>
Co-authored-by: Paul Zeinlinger <paul.zeinlinger@gmail.com>
Co-authored-by: Luc Caspar <casparluc@users.noreply.github.com>
Co-authored-by: R. David Dunphy <rdd.dunphy@gmail.com>
Co-authored-by: Artem Vasenin <vasart169@gmail.com>
Co-authored-by: Nicolas Serafini <serafini.nicolas@gmail.com>
2021-05-30 23:46:01 +00:00
cp betterlockscreen@.service /usr/lib/systemd/system/
2018-09-18 18:40:52 +00:00
# enable systemd service
systemctl enable betterlockscreen@$USER
# disable systemd service
systemctl disable betterlockscreen@$USER
# Note: Now you can call systemctl suspend to suspend your system
# and betterlockscreen service will be activated
# so when your system wakes your screen will be locked.
2017-12-11 01:22:40 +00:00
```
Prepare to merge (#228)
* Fix loginbox position for vertical arrangements
* Fix tabs everywhere
* 110 Automatically deduce DPI
* 118 Add description for Void Linux installation
* 119 Add Timeout Option
* Update README for multi-monitor
* Keep original directory
* Update README
* Rename project files
* Always use defaults
* Rewrite update() and get_display_list()
* Add lock_timeout to defaults
* Fix ExecStart in systemd unit
* Update README
* Fix bad variable name in wallpaper()
* Remove quoting, it breaks things
* Fix paths and canvas color
* Effects now are optional to speed up updating cache
* Fix fx_dimblur()
* Add shadow to loginbox (#3)
* Add create_loginbox(), add loginshadow option
* Add loginshadow option to example config
* Add solid color background effect (#4)
* Use array and fix quoting
* Add color effect, create solid color backgrounds
* Update README
* Add more arguments and options (#5)
* New arguments and config options
* Update usage more
* Update README
* Minor text edits
* Relocate config and cache (#6)
* Move config and cache directories
* Make sure cache dir exists
* Reorder defaults, clarify options and theme
* Reformat example config
* Moved example config
* Update header info
* Fix quoting in DEFAULT_TIMEOUT
* Rewrite usage()
* Touch up comments and some syntax
* Update README, fix usage
* Fix passing arguments to i3lock
lockargs needs to be an array so that it can expand to multiple
arguments (preferable to using wordsplitting or eval instead).
* Scale loginbox based on DPI
Fixes jeffmhubbard/multilockscreen#7.
* Add failsafe to lock screen when images not found (#13)
* Add optional description box (#10)
* Add optional description box
The box is located in the bottom right corner
of the lock screen image and contains a
custom description message
(e.g. to present a name for random images
or to display additional information)
Added option: --desc <DESCRIPTION>
* Adapt description to i3lock date font
* Description font queried like in i3lock-color
* description: force normal upright font style
* added support for dimpixel effect (#16)
* added support for using different images on different displays (#17)
* added support for using different images on different displays
* fixed list creation when passed a single image
* reworked how WALL_LIST is generated
* Fix span output (#19)
* Make output reflect one set of images is processed
* Return only 1 image when spanning
* Correct output in a few spots
* Add fancy output (#20)
* Add echo wrapper to prefix output
* Fix typo
* Update README.md (#21)
* Fixes misspelled fn (#22)
* Escape spaces in path for IM (#24)
* Minor fixes (#26)
* Better parsing --lock args
* Add --pass-media-keys
* Add --pass-screen-keys and --pass-power-keys
* Fix insanely short default timeout
* Make error text transparent
* Call init_config later, update example config (#27)
Reading config file later allows users to define
custom functions in config (prelock, postlock, etc)
Updated docs with example usage
* Fix suspend (#30)
* Fix borked logic in --lock arg that breaks suspend
* Don't check before all arguments read
* Use `dunstctl` to (un)pause the dunst pre/post-lock. (#31)
Please be aware that, the use of dunstctl means that users will be forced to have dunst v1.5.0 or newer installed.
* Update LICENSE
* Disable DPMS after unlocking if it was originally disabled (#32)
* feat[multilockscreen]: Add --show-layout option (#36)
* Only change DPMS timeout if Enabled (#38)
* Fix #40 (#41)
Don't wait for `prelock()` and `postlock()` to complete
* Add bgcolor option to set i3lock --color (#44)
Closes #43
* Update systemd unit (#45)
* Fix options name for i3color-lock release 2.13.c.3 (#49)
With release 2.13.c.3 i3color-lock has added dashes before color, pos, size, etc.
https://github.com/Raymo111/i3lock-color/releases/tag/2.13.c.3
* Add checklist
* Rename script
* Extra files from upstream
* Update README
Keep most of betterlockscreen README. Replaced configuration,
usage, and usage examples.
* Update example config
* Fix branding, paths, etc
* Add wallpaper_cmd and time_format, long arg only
* Fix quoting, remove unused variable
Co-authored-by: Fox Kiester <noct@posteo.net>
Co-authored-by: Richard <fr34q@users.noreply.github.com>
Co-authored-by: Sheeets <31318683+sheeets@users.noreply.github.com>
Co-authored-by: Paul Zeinlinger <paul.zeinlinger@gmail.com>
Co-authored-by: Luc Caspar <casparluc@users.noreply.github.com>
Co-authored-by: R. David Dunphy <rdd.dunphy@gmail.com>
Co-authored-by: Artem Vasenin <vasart169@gmail.com>
Co-authored-by: Nicolas Serafini <serafini.nicolas@gmail.com>
2021-05-30 23:46:01 +00:00
**Hint:** The systemd-unit expects betterlockscreen to be installed in "/usr/local/bin", so maybe you want to check or change this!
Resources and more informations:
* https://gist.github.com/Raymo111/91ffd256b7aca6a85e8a99d6331d3b7b
* https://github.com/Raymo111/i3lock-color/issues/174#issuecomment-687149213
2017-12-08 06:01:03 +00:00
---
2021-06-30 14:35:39 +00:00
## Countributing
2018-11-19 14:56:55 +00:00
2021-07-20 23:57:08 +00:00
Please see [CONTRIBUTING.md ](CONTRIBUTING.md ).
2018-11-19 14:56:55 +00:00
## License
2018-11-22 20:45:28 +00:00
Betterlockscreen is under [MIT ](https://github.com/pavanjadhaw/betterlockscreen/blob/master/LICENSE ) license.
2018-11-19 14:56:55 +00:00
2021-06-30 14:35:39 +00:00
### Feel free to use and distribute
2017-12-07 18:51:34 +00:00
2018-11-19 14:56:55 +00:00
- Hat tip to anyone who's code was used
- Thanks to those who contributed to make it better
Prepare to merge (#228)
* Fix loginbox position for vertical arrangements
* Fix tabs everywhere
* 110 Automatically deduce DPI
* 118 Add description for Void Linux installation
* 119 Add Timeout Option
* Update README for multi-monitor
* Keep original directory
* Update README
* Rename project files
* Always use defaults
* Rewrite update() and get_display_list()
* Add lock_timeout to defaults
* Fix ExecStart in systemd unit
* Update README
* Fix bad variable name in wallpaper()
* Remove quoting, it breaks things
* Fix paths and canvas color
* Effects now are optional to speed up updating cache
* Fix fx_dimblur()
* Add shadow to loginbox (#3)
* Add create_loginbox(), add loginshadow option
* Add loginshadow option to example config
* Add solid color background effect (#4)
* Use array and fix quoting
* Add color effect, create solid color backgrounds
* Update README
* Add more arguments and options (#5)
* New arguments and config options
* Update usage more
* Update README
* Minor text edits
* Relocate config and cache (#6)
* Move config and cache directories
* Make sure cache dir exists
* Reorder defaults, clarify options and theme
* Reformat example config
* Moved example config
* Update header info
* Fix quoting in DEFAULT_TIMEOUT
* Rewrite usage()
* Touch up comments and some syntax
* Update README, fix usage
* Fix passing arguments to i3lock
lockargs needs to be an array so that it can expand to multiple
arguments (preferable to using wordsplitting or eval instead).
* Scale loginbox based on DPI
Fixes jeffmhubbard/multilockscreen#7.
* Add failsafe to lock screen when images not found (#13)
* Add optional description box (#10)
* Add optional description box
The box is located in the bottom right corner
of the lock screen image and contains a
custom description message
(e.g. to present a name for random images
or to display additional information)
Added option: --desc <DESCRIPTION>
* Adapt description to i3lock date font
* Description font queried like in i3lock-color
* description: force normal upright font style
* added support for dimpixel effect (#16)
* added support for using different images on different displays (#17)
* added support for using different images on different displays
* fixed list creation when passed a single image
* reworked how WALL_LIST is generated
* Fix span output (#19)
* Make output reflect one set of images is processed
* Return only 1 image when spanning
* Correct output in a few spots
* Add fancy output (#20)
* Add echo wrapper to prefix output
* Fix typo
* Update README.md (#21)
* Fixes misspelled fn (#22)
* Escape spaces in path for IM (#24)
* Minor fixes (#26)
* Better parsing --lock args
* Add --pass-media-keys
* Add --pass-screen-keys and --pass-power-keys
* Fix insanely short default timeout
* Make error text transparent
* Call init_config later, update example config (#27)
Reading config file later allows users to define
custom functions in config (prelock, postlock, etc)
Updated docs with example usage
* Fix suspend (#30)
* Fix borked logic in --lock arg that breaks suspend
* Don't check before all arguments read
* Use `dunstctl` to (un)pause the dunst pre/post-lock. (#31)
Please be aware that, the use of dunstctl means that users will be forced to have dunst v1.5.0 or newer installed.
* Update LICENSE
* Disable DPMS after unlocking if it was originally disabled (#32)
* feat[multilockscreen]: Add --show-layout option (#36)
* Only change DPMS timeout if Enabled (#38)
* Fix #40 (#41)
Don't wait for `prelock()` and `postlock()` to complete
* Add bgcolor option to set i3lock --color (#44)
Closes #43
* Update systemd unit (#45)
* Fix options name for i3color-lock release 2.13.c.3 (#49)
With release 2.13.c.3 i3color-lock has added dashes before color, pos, size, etc.
https://github.com/Raymo111/i3lock-color/releases/tag/2.13.c.3
* Add checklist
* Rename script
* Extra files from upstream
* Update README
Keep most of betterlockscreen README. Replaced configuration,
usage, and usage examples.
* Update example config
* Fix branding, paths, etc
* Add wallpaper_cmd and time_format, long arg only
* Fix quoting, remove unused variable
Co-authored-by: Fox Kiester <noct@posteo.net>
Co-authored-by: Richard <fr34q@users.noreply.github.com>
Co-authored-by: Sheeets <31318683+sheeets@users.noreply.github.com>
Co-authored-by: Paul Zeinlinger <paul.zeinlinger@gmail.com>
Co-authored-by: Luc Caspar <casparluc@users.noreply.github.com>
Co-authored-by: R. David Dunphy <rdd.dunphy@gmail.com>
Co-authored-by: Artem Vasenin <vasart169@gmail.com>
Co-authored-by: Nicolas Serafini <serafini.nicolas@gmail.com>
2021-05-30 23:46:01 +00:00
- Inspiration - [r/unixporn ](https://www.reddit.com/r/unixporn )