ceda_ei
/
i3lock-delta
mirror of https://gitlab.com/ceda_ei/i3lock-delta
1
1
Fork 0
Code Issues Releases Wiki Activity
A new image from Unsplash everytime you lock the screen
9 Commits 2 Branches 0 Tags 2.7 MiB
Shell 100%
Go to file
Ceda EI 8a7b5b414d Updated README.md and added Screenshots. 2017-12-29 10:58:08 +05:30
screenshots Updated README.md and added Screenshots. 2017-12-29 10:58:08 +05:30
.gitignore Added .gitignore to ensure the libraries don't get added to the repo. 2017-12-28 15:45:10 +05:30
README.md Updated README.md and added Screenshots. 2017-12-29 10:58:08 +05:30
box_config Changed the font size of photographer's name. 2017-12-29 10:19:02 +05:30
composer.json Updated README.md. Added composer.json 2017-12-28 16:19:09 +05:30
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. 2017-12-28 20:29:42 +05:30
download_daemon Changed the font size of photographer's name. 2017-12-29 10:19:02 +05:30
downloader.php 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. 2017-12-28 20:29:42 +05:30
install Update install to update box_config upon install. 2017-12-28 22:34:17 +05:30
lock 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. 2017-12-28 20:29:42 +05:30

README.md

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

  • PHP - Available in repositories of most popular distributions.
  • Composer - Available in repositories of most popular distributions.
  • 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.

Screenshots

Screenshot

Screenshot

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