|
2 | 2 |
|
3 | 3 | Distort a screenshot and run `i3lock`. |
4 | 4 |
|
5 | | -## Quick Start [[Documentation]](USAGE.md) |
| 5 | +## Quick start [[Documentation]](USAGE.md) |
6 | 6 |
|
7 | | -Signed binary releases are availible [here](https://github.com/owenthewizard/i3lockr/releases). |
| 7 | +Signed binary releases are availible on the [releases page](https://github.com/owenthewizard/i3lockr/releases). |
8 | 8 |
|
| 9 | +Or build it yourself: |
9 | 10 | ```bash |
10 | 11 | git clone --depth=1 git://github.com/owenthewizard/i3lockr.git && cd i3lockr |
11 | | -cargo build --release |
12 | | -sudo strip -s target/release/i3lockr /usr/local/bin/i3lockr |
13 | | -i3lockr --invert -- --nofork --noempty # or your favorite args |
| 12 | +cargo build --release # you may adjust features here |
| 13 | +sudo strip -s target/release/i3lockr -o /usr/local/bin/i3lockr |
| 14 | +i3lockr --blur 25 -- --nofork --ignore-empty-password # use your favorite args |
14 | 15 | ``` |
15 | 16 |
|
16 | 17 | ## Screenshots |
17 | 18 |
|
18 | | -Without `--invert` |
19 | | - |
| 19 | +Without `--blur` |
| 20 | + |
20 | 21 |
|
21 | | -With `--invert` |
22 | | - |
| 22 | +With `--blur=10` |
| 23 | + |
23 | 24 |
|
24 | | -With the default options on a 1080p monitor, `i3lockr` takes less than half a second to run! |
| 25 | +With `--blur=25` |
| 26 | + |
| 27 | + |
| 28 | +`i3lockr` (since v1.0.0) is incredibly fast at all blur levels, try timing it yourself with `time`. |
25 | 29 |
|
26 | 30 | ## Important Notes |
27 | 31 |
|
28 | | -The exit status of `i3lockr` is not reliable! |
29 | | -That means that `i3lockr && systemctl suspend` may not lock the screen if there was an error. |
| 32 | +`i3lockr` always exits with `EXIT_SUCCESS`. This means that commands such as `i3lockr && systemctl suspend` may not lock the screen if there was an error. |
30 | 33 |
|
31 | 34 | ### Coding Style |
32 | 35 |
|
33 | 36 | Obey `rustfmt` and Rust 2018 conventions. |
34 | 37 |
|
35 | 38 | ## Contributing |
36 | 39 |
|
37 | | -Pull requests are always welcome. See [TODO](TODO.md). |
| 40 | +Pull requests are always welcome. |
| 41 | + |
| 42 | +Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed under the terms of both the MIT License and the Apache License (Version 2.0). |
38 | 43 |
|
39 | 44 | ## Versioning |
40 | 45 |
|
41 | 46 | This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). |
42 | 47 |
|
43 | 48 | Changes are documented in the [Changelog](CHANGELOG.md). |
44 | 49 |
|
45 | | -See the [tags on this repository](https://github.com/owenthewizard/i3lockr/tags) for available releases. |
| 50 | +See the [tags](https://github.com/owenthewizard/i3lockr/tags) for available releases. |
46 | 51 |
|
47 | 52 | ## Authors |
48 | 53 |
|
49 | 54 | See [the list of contributors](https://github.com/owenthewizard/i3lockr/contributors). |
50 | 55 |
|
51 | 56 | ## License |
52 | 57 |
|
53 | | -`i3lockr` is primarily distributed under the terms of both the MIT license and the Apache License (Version 2.0). |
54 | | - |
55 | 58 | See [LICENSE-APACHE](LICENSE-APACHE.md) and [LICENSE-MIT](LICENSE-MIT.md) for details. |
56 | 59 |
|
57 | 60 | ## Acknowledgments |
58 | 61 |
|
59 | | -* [i3lock-fancy](https://github.com/meskarune/i3lock-fancy) by Dolores Portalatin for inspiration. |
60 | | -* [Padlock Icon](padlock.svg) made by [Chanut](https://www.flaticon.com/authors/chanut) from [Flaticon](https://www.flaticon.com) is licensed by [CC 3.0 BY](https://creativecommons.org/licenses/by/3.0/). |
| 62 | +* [i3lock](https://github.com/i3/i3lock) by [Michael Stapelberg](https://github.com/stapelberg) and [contributers](https://github.com/i3/i3lock/graphs/contributors) |
| 63 | +* [i3lock-fancy](https://github.com/meskarune/i3lock-fancy) by [Dolores Portalatin](https://github.com/meskarune) for inspiration. |
| 64 | +* [Martin DΓΈrum](https://github.com/mortie) for contributions to `i3lock` that made this possible. |
0 commit comments