i3lock-delta/README.md

60 lines
2.6 KiB
Markdown
Raw Permalink Normal View History

2017-12-28 11:49:09 +01:00
# i3lock Delta
This prorgam downloads a new image from [Unsplash][1]. It checks whether the screen was locked every 5 minutes. In case of no Internet, it retries every 1 minute and displays the previous picture untill a new one is downloaded. The script allows to filter random images based on your choices.
2017-12-28 11:49:09 +01:00
## Dependencies
2018-04-01 22:07:34 +02:00
+ [jq][2] - Needed for parsing JSON.
+ [curl][3] - Available in most software repositories. Also, most probably installed already.
2017-12-28 12:33:35 +01:00
+ [Imagemagick][4] - Specifically, the `convert` command.
+ [i3lock-color][5] - Available in AUR (For Arch users). Fork of i3lock with more features. Do not use i3lock since this program utilizes the features of i3lock-color.
+ [bash][6] - Most probably will be installed already.
2017-12-28 11:49:09 +01:00
## Screenshots
![Screenshot](screenshots/one.png)
![Screenshot](screenshots/two.png)
## Installation
Run the following commands
```bash
cd
git clone https://github.com/Ceda-EI/i3lock-delta
cd i3lock-delta
./install
```
Save your Unsplash `applicationId` in `~/i3lock-delta/api_key`. You can get the `applicationId` from registering at [Unsplash Developer.][7]
## Usage
+ Check that the `applicationId` in ``~/i3lock-delta/api_key`` is correct.
+ Add `~/i3lock-delta/download_daemon &` to your startup applications. Also, run `~/i3lock-delta/download_daemon &` to avoid rebooting.
+ To lock the screen, run `~/i3lock-delta/lock`. You can map this to your lock key combination.
## Configuration
The lock screen customization has been made easier using `~/.config/lock_preferences`,`api_key`, `config` and `box_config` files.
+ If the random background should be selected from certain topics, enter the topics in `~/.config/lock_preferences` with one topic per line i.e. each line should contain only one topic.
+ To insert your own Unsplash API Key, type/paste it in the `~/i3lock-delta/api_key` file.
+ To change the ring color/size or date/time color/style/size/font uncomment (remove the # at start) the corresponding line in `~/i3lock-delta/config` and set the value after the `=` sign.
+ To change the position of box drawn for the clock or the position of the text for photographer, edit `~/i3lock-delta/box_config`.
## Fonts Used
+ Font used for date: [Space Age][8]
+ Font used for time: [Neuropolitical][9]
2017-12-28 11:49:09 +01:00
<!--Links-->
[1]: https://unsplash.com
2018-04-01 22:07:34 +02:00
[2]: https://stedolan.github.io/jq/
[3]: https://curl.haxx.se
2017-12-28 11:49:09 +01:00
[4]: https://imagemagick.org
[5]: https://github.com/PandorasFox/i3lock-color
[6]: https://www.gnu.org/software/bash/
[7]: https://unsplash.com/developers
[8]: https://dl.dafont.com/dl/?f=space_age
[9]: https://dl.dafont.com/dl/?f=neuropolitical