<p align="center">
<h1 align="center">✨ AI Wallpaper</h1>
</p>
<p align="center">
<a href="https://github.com/khoj-ai/khoj"><img src="https://badgen.net/badge/powered by/%E2%9C%A8khoj%20ai/27c2d8/" /></a>
<a href="LICENSE"><img src="https://badgen.net/github/license/debanjum/ai-wallpaper" /></a>
<a href="https://pypi.org/project/ai-wallpaper/"><img src="https://badge.fury.io/py/ai-wallpaper.svg" /></a>
</p>
<p align="center">
Get fresh, personal AI painted wallpapers daily
</p>
## 💎 Features
- Get fresh, personal wallpapers painted for you by [khoj ai](https://github.com/khoj-ai/khoj)
- 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](https://app.khoj.dev/config#clients) or [setup a self-hosted Khoj](https://docs.khoj.dev/get-started/setup/)
- Install [Termux](https://f-droid.org/en/packages/com.termux/) to use on Android
- Requires a Mac or Android Operating System. *Windows, Linux support if enough demand*
## ⚡️ Quickstart
```shell
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
```shell
KHOJ_API_KEY=<YOUR_KHOJ_API_KEY> aiwall
```
### Uze Custom Prompt
```shell
KHOJ_API_KEY=<YOUR_KHOJ_API_KEY> aiwall "Generate a wallpaper based on the latest news here"
```
### Use Custom Wallpaper Path
```shell
KHOJ_API_KEY=<YOUR_KHOJ_API_KEY> WALLPAPER_PATH="~/Pictures/wallpaper.png" aiwall
```
### Use Self-Hosted Khoj
```shell
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
```shell
echo "#!/bin/sh\nKHOJ_API_KEY=<YOUR_KHOJ_API_KEY> aiwall" > wallpaper.sh
chmod +x wallpaper.sh
```
- On Android: Use [termux-job-scheduler](https://wiki.termux.com/wiki/Termux:API#:~:text=termux-job-scheduler) on Termux to get yourself a fresh and personal wallpaper painted every 12 hours
```shell
# 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](https://play.google.com/store/apps/details?id=net.dinglisch.android.taskerm&hl=en&gl=US) + [Termux:Tasker](https://wiki.termux.com/wiki/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
```shell
# 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
```shell
# 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
```shell
# 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](LICENSE) © debanjum
Raw data
{
"_id": null,
"home_page": null,
"name": "ai-wallpaper",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "AI, images, khoj",
"author": "Debanjum Singh Solanky",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/9b/db/2e820d11930c56710bd5d5e5f5f878fd131eefa766d52234f60cca938b5f/ai_wallpaper-0.1.dev19.tar.gz",
"platform": null,
"description": "<p align=\"center\">\n <h1 align=\"center\">\u2728 AI Wallpaper</h1>\n</p>\n<p align=\"center\">\n <a href=\"https://github.com/khoj-ai/khoj\"><img src=\"https://badgen.net/badge/powered by/%E2%9C%A8khoj%20ai/27c2d8/\" /></a>\n <a href=\"LICENSE\"><img src=\"https://badgen.net/github/license/debanjum/ai-wallpaper\" /></a>\n <a href=\"https://pypi.org/project/ai-wallpaper/\"><img src=\"https://badge.fury.io/py/ai-wallpaper.svg\" /></a>\n</p>\n\n<p align=\"center\">\n Get fresh, personal AI painted wallpapers daily\n</p>\n\n## \ud83d\udc8e Features\n- Get fresh, personal wallpapers painted for you by [khoj ai](https://github.com/khoj-ai/khoj)\n- Automatically weaves your current city, moon phase, weather and (even recent experiences!) into the painting\n- Updates your Android or Mac wallpaper automatically\n- Schedule it to run every day and night\n- Customize the wallpapers by telling khoj what styles and information to use\n\n## \u2705 Prequisites\n\n- Generate a (free) [Khoj API Key](https://app.khoj.dev/config#clients) or [setup a self-hosted Khoj](https://docs.khoj.dev/get-started/setup/)\n- Install [Termux](https://f-droid.org/en/packages/com.termux/) to use on Android\n- Requires a Mac or Android Operating System. *Windows, Linux support if enough demand*\n\n## \u26a1\ufe0f Quickstart\n```shell\npip install ai-wallpaper && KHOJ_API_KEY=<YOU_KHOJ_API_KEY> aiwall\n```\n\n## \ud83c\udf81 Showcase\n| Day | Night |\n|-----|-------|\n|  |  |\n|  |  |\n|  |  |\n\nhttps://github.com/debanjum/ai-wallpaper/assets/6413477/823c1624-6452-472e-8786-4cb79bcfa029\n\n\n## \ud83e\udea2 Customize\n### Minimal\n ```shell\n KHOJ_API_KEY=<YOUR_KHOJ_API_KEY> aiwall\n ```\n\n### Uze Custom Prompt\n ```shell\n KHOJ_API_KEY=<YOUR_KHOJ_API_KEY> aiwall \"Generate a wallpaper based on the latest news here\"\n ```\n\n### Use Custom Wallpaper Path\n ```shell\n KHOJ_API_KEY=<YOUR_KHOJ_API_KEY> WALLPAPER_PATH=\"~/Pictures/wallpaper.png\" aiwall\n ```\n\n### Use Self-Hosted Khoj\n ```shell\n KHOJ_HOST=\"http://localhost:42100\" aiwall\n ```\n\n## \ud83d\ude80 Upgrade\n### Automatically get a fresh and personal wallpaper painted for you every day and night\n - Create a simple shell script to call the AI wallpaper creation command\n ```shell\n echo \"#!/bin/sh\\nKHOJ_API_KEY=<YOUR_KHOJ_API_KEY> aiwall\" > wallpaper.sh\n chmod +x wallpaper.sh\n ```\n - On Android: Use [termux-job-scheduler](https://wiki.termux.com/wiki/Termux:API#:~:text=termux-job-scheduler) on Termux to get yourself a fresh and personal wallpaper painted every 12 hours\n ```shell\n # Install termux-job-scheduler to trigger script at a regular interval\n pkg install termux-job-scheduler\n # Make Khoj paint you a new wallpaper every 12 hours\n termux-job-scheduler -s aiwall --period-ms 43200000 --persisted true\n # Optional, check that the script is active\n # termux-job-scheduler -p\n ```\n Note: *You can use [Tasker](https://play.google.com/store/apps/details?id=net.dinglisch.android.taskerm&hl=en&gl=US) + [Termux:Tasker](https://wiki.termux.com/wiki/Termux:Tasker) or other automations apps to trigger the Wallpaper script as well*\n - On Mac: Use Cron to get yourself a fresh and personal wallpaper painted every 12 hours\n ```shell\n # Open crontab in edit mode\n crontab -e\n\n # Add below snippet to your crontab\n # 0 */12 * * /path/to/ai/wallpaper/folder/wallpaper.sh\n\n # Optional, check that the script is active\n # crontab -l\n ```\n\n### Weave experiences from your notes into the Wallpapers\nThe 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.\n\n\n## \ud83d\udda5\ufe0f Develop\n\n1. Download and Install\n ```shell\n # Clone the repository\n git clone https://github.com/debajum/ai-wallpaper\n\n # Install dependencies\n cd ai-wallpaper && pip install .\n ```\n\n2. Edit application\n\n3. Run any of the following commands to paint using your updated application\n ```shell\n # Minimal\n KHOJ_API_KEY=<YOUR_KHOJ_API_KEY> python src/aiwall/paper.py\n\n # With Custom Prompt\n KHOJ_API_KEY=<YOUR_KHOJ_API_KEY> python src/aiwall/paper.py \"Generate a wallpaper based on the latest news here\"\n\n # With Custom Wallpaper File Path\n KHOJ_API_KEY=<YOUR_KHOJ_API_KEY> WALLPAPER_PATH=\"~/Pictures/wallpaper.png\" python src/aiwall/paper.py\n\n # With Self-hosted Khoj\n KHOJ_HOST=\"http://localhost:42100\" python src/aiwall/paper.py\n ```\n\n## \ud83d\udd16 LICENSE\nThis program is free software; it is distributed under the GNU General Public License v3.\n\n[GPLv3](LICENSE) \u00a9 debanjum\n",
"bugtrack_url": null,
"license": null,
"summary": "Create fresh, personal AI painted wallpapers",
"version": "0.1.dev19",
"project_urls": {
"Homepage": "https://github.com/debanjum/ai-wallpaper"
},
"split_keywords": [
"ai",
" images",
" khoj"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "bea9c7b7bcdf689a6b9d574c8bcc0ece94c7b8511752fd82346cc6d1d4369031",
"md5": "2b4348444533b1ac768f2ad2fb56f9fb",
"sha256": "48461df4ebeb2bc78d325804c344d16f00151a0874c9061334e5f1eb42fdf9e0"
},
"downloads": -1,
"filename": "ai_wallpaper-0.1.dev19-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2b4348444533b1ac768f2ad2fb56f9fb",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 21133,
"upload_time": "2024-12-18T01:54:18",
"upload_time_iso_8601": "2024-12-18T01:54:18.228562Z",
"url": "https://files.pythonhosted.org/packages/be/a9/c7b7bcdf689a6b9d574c8bcc0ece94c7b8511752fd82346cc6d1d4369031/ai_wallpaper-0.1.dev19-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9bdb2e820d11930c56710bd5d5e5f5f878fd131eefa766d52234f60cca938b5f",
"md5": "d7d15620b1eb347987bc42f0a8d0f358",
"sha256": "0c068c825946eb711c05efb0ae6e46c2f1d9fb2037e938dc584f0ae67f0e1d85"
},
"downloads": -1,
"filename": "ai_wallpaper-0.1.dev19.tar.gz",
"has_sig": false,
"md5_digest": "d7d15620b1eb347987bc42f0a8d0f358",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 20681,
"upload_time": "2024-12-18T01:54:20",
"upload_time_iso_8601": "2024-12-18T01:54:20.513050Z",
"url": "https://files.pythonhosted.org/packages/9b/db/2e820d11930c56710bd5d5e5f5f878fd131eefa766d52234f60cca938b5f/ai_wallpaper-0.1.dev19.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-18 01:54:20",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "debanjum",
"github_project": "ai-wallpaper",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "ai-wallpaper"
}
JSON
