A new image from Unsplash everytime you lock the screen
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Ceda EI 5ae739d307 Update username to $USER 2 years ago
screenshots Updated README.md and added Screenshots. 3 years ago
LICENSE Added License GPL3 3 years ago
README.md Update README.md 2 years ago
box_config Fixed the config section in install script. 3 years ago
config Added download_daemon which needs to be running in background. Added downloader.php - the part of program that interacts with Unsplash API. Added lock which locks the screen. Added configs. 3 years ago
download_daemon (almost?) finish bash port 2 years ago
downloader.sh Make curl silent 2 years ago
install Update install script. 2 years ago
lock Update username to $USER 2 years ago


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.


  • jq - Needed for parsing JSON.
  • curl - Available in most software repositories. Also, most probably installed already.
  • Imagemagick - Specifically, the convert command.
  • 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.





Run the following commands

git clone https://github.com/Ceda-EI/i3lock-delta
cd i3lock-delta

Save your Unsplash applicationId in ~/i3lock-delta/api_key. You can get the applicationId from registering at Unsplash Developer.


  • 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.


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