✨ AI Wallpaper

Get fresh, personal AI painted wallpapers daily

💎 Features

• Get fresh, personal wallpapers painted for you by khoj ai
• Automatically weaves your current city, moon phase, weather and (even recent experiences!) into the painting
• Updates your Android or Mac wallpaper automatically
• Schedule it to run every day and night
• Customize the wallpapers by telling khoj what styles and information to use

✅ Prequisites

• Generate a (free) Khoj API Key or setup a self-hosted Khoj
• Install Termux to use on Android
• Requires a Mac or Android Operating System. Windows, Linux support if enough demand

⚡️ Quickstart

pip install ai-wallpaper && KHOJ_API_KEY=<YOU_KHOJ_API_KEY> aiwall

🎁 Showcase

Day	Night

https://github.com/debanjum/ai-wallpaper/assets/6413477/823c1624-6452-472e-8786-4cb79bcfa029

🪢 Customize

Minimal

 KHOJ_API_KEY=<YOUR_KHOJ_API_KEY> aiwall

Uze Custom Prompt

 KHOJ_API_KEY=<YOUR_KHOJ_API_KEY> aiwall "Generate a wallpaper based on the latest news here"

Use Custom Wallpaper Path

 KHOJ_API_KEY=<YOUR_KHOJ_API_KEY> WALLPAPER_PATH="~/Pictures/wallpaper.png" aiwall

Use Self-Hosted Khoj

 KHOJ_HOST="http://localhost:42100" aiwall

🚀 Upgrade

Automatically get a fresh and personal wallpaper painted for you every day and night

• Create a simple shell script to call the AI wallpaper creation command

   echo "#!/bin/sh\nKHOJ_API_KEY=<YOUR_KHOJ_API_KEY> aiwall" > wallpaper.sh
   chmod +x wallpaper.sh
  

• On Android: Use termux-job-scheduler on Termux to get yourself a fresh and personal wallpaper painted every 12 hours

   # Install termux-job-scheduler to trigger script at a regular interval
   pkg install termux-job-scheduler
   # Make Khoj paint you a new wallpaper every 12 hours
   termux-job-scheduler -s aiwall --period-ms 43200000 --persisted true
   # Optional, check that the script is active
   # termux-job-scheduler -p
  

  Note: You can use Tasker + Termux:Tasker or other automations apps to trigger the Wallpaper script as well
• On Mac: Use Cron to get yourself a fresh and personal wallpaper painted every 12 hours

   # Open crontab in edit mode
   crontab -e
  
   # Add below snippet to your crontab
   # 0 */12 * * /path/to/ai/wallpaper/folder/wallpaper.sh
  
   # Optional, check that the script is active
   # crontab -l
  

Weave experiences from your notes into the Wallpapers

The AI wallpaper script can automatically incorporate any recent experiences from your notes into it's paintings. To use this you will need to sync your notes with Khoj.

🖥️ Develop

1. Download and Install

    # Clone the repository
    git clone https://github.com/debajum/ai-wallpaper
   
    # Install dependencies
    cd ai-wallpaper && pip install .
   

2. Edit application

3. Run any of the following commands to paint using your updated application

   # Minimal
   KHOJ_API_KEY=<YOUR_KHOJ_API_KEY> python src/aiwall/paper.py
   
   # With Custom Prompt
   KHOJ_API_KEY=<YOUR_KHOJ_API_KEY> python src/aiwall/paper.py "Generate a wallpaper based on the latest news here"
   
   # With Custom Wallpaper File Path
   KHOJ_API_KEY=<YOUR_KHOJ_API_KEY> WALLPAPER_PATH="~/Pictures/wallpaper.png" python src/aiwall/paper.py
   
   # With Self-hosted Khoj
   KHOJ_HOST="http://localhost:42100" python src/aiwall/paper.py
   

🔖 LICENSE

This program is free software; it is distributed under the GNU General Public License v3.

GPLv3 © debanjum