mirror of
https://gitlab.com/ceda_ei/i3lock-delta
synced 2025-10-29 22:00:04 +01:00
master
i3lock Delta
This prorgam downloads a new image from Unsplash. 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.
Dependencies
- jq - Needed for parsing JSON.
- curl - Available in most software repositories. Also, most probably installed already.
- Imagemagick - Specifically, the
convertcommand. - i3lock-color - 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 - Most probably will be installed already.
Screenshots
Installation
Run the following commands
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.
Usage
- Check that the
applicationIdin~/i3lock-delta/api_keyis 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_preferenceswith 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_keyfile. - To change the ring color/size or date/time color/style/size/font uncomment (remove the # at start) the corresponding line in
~/i3lock-delta/configand 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
- Font used for time: Neuropolitical
Languages
Shell
100%

