mirror of
				https://gitlab.com/ceda_ei/i3lock-delta
				synced 2025-11-04 08:40:05 +01:00 
			
		
		
		
	
			
				
					
						
					
					d6bcb8f531fbf9497095add3350df7efaa7efa73
				
			
			
		
	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%
							
						
					
