---
## ๐ Quick Start
### Local Development
```bash
# 1. Clone repository
git clone https://github.com/Hana19951208/DailyWallpaperHub.git
cd DailyWallpaperHub
# 2. Install dependencies (using conda env)
conda activate base
pip install -r requirements.txt
# 3. Configure Environment Variables
cp .env.example .env
# Edit .env file with your configurations:
# WEWORK_WEBHOOK=your_webhook_url
# LLM_API_KEY=your_api_key
# LLM_BASE_URL=https://api.openai.com/v1
# LLM_MODEL_NAME=gpt-4o
# UNSPLASH_ACCESS_KEY=your_unsplash_key
# 4. Fast Fetch (Skip Story)
python fetch_bing_wallpaper.py --skip-story
python fetch_unsplash_wallpaper.py --skip-story
# 5. Async Story Generation (Background)
python scripts/generate_missing_stories.py
# 6. Batch Fetch History
python batch_fetch.py bing 2025-12 # Fetch Bing whole month
python batch_fetch.py unsplash 2025-12-10 # Fetch Unsplash specific date
```
### GitHub Actions Deployment
1. **Fork this repository**
2. **Configure GitHub Secrets** (Settings โ Secrets and variables โ Actions):
- `WEWORK_WEBHOOK`: Enterprise WeChat Robot Webhook URL
- `LLM_API_KEY`: LLM API Key
- `LLM_BASE_URL`: LLM API Base URL
- `LLM_MODEL_NAME`: LLM Model Name
- `UNSPLASH_ACCESS_KEY`: Unsplash API Access Key
3. **Enable GitHub Pages**:
- Settings โ Pages
- Source: Deploy from a branch
- Branch: `main` / `docs`
4. **Trigger manually or wait for schedule**:
- Actions โ Daily Wallpaper Fetch โ Run workflow
---
## ๐ Project Structure
```
DailyWallpaperHub/
โโโ config/
โ โโโ sources.yaml # Data Source Config
โโโ prompts/
โ โโโ story_prompt.txt # AI Prompt Template
โโโ scripts/
โ โโโ fill_unsplash_dec.py # Unsplash Data Fill Script
โ โโโ generate_missing_stories.py # Async Story Gen Script
โโโ src/
โ โโโ config_loader.py # Config Loader
โ โโโ utils.py # WeChat Push Utils
โ โโโ update_readme.py # README Updater
โ โโโ update_gallery.py # Gallery Updater
โโโ docs/
โ โโโ index.html # GitHub Pages Gallery
โ โโโ wallpapers/ # 404 Fix: Wallpapers must be here for Pages
โ โโโ bing/
โ โ โโโ YYYY-MM-DD/
โ โ โโโ image.jpg
โ โ โโโ thumb.jpg
โ โ โโโ meta.json
โ โ โโโ story.md
โ โโโ unsplash/
โ โโโ YYYY-MM-DD/
โ โโโ image.jpg
โ โโโ thumb.jpg
โ โโโ meta.json
โ โโโ story.md
โโโ .github/workflows/
โ โโโ daily.yml # Automation Workflow
โโโ fetch_bing_wallpaper.py # Bing Fetcher
โโโ fetch_unsplash_wallpaper.py # Unsplash Fetcher
โโโ batch_fetch.py # Batch Tool
โโโ requirements.txt # Python Dependencies
โโโ README.md # Documentation
```
---
## ๐ฏ Usage Guide
### Async Story Generation
To improve user experience, this project uses an asynchronous architecture:
1. **Fast Mode** (Default/Recommended):
```bash
python fetch_bing_wallpaper.py --skip-story
```
- Downloads images and metadata only
- Immediately updates README and Gallery
- Images viewable instantly
2. **Background Story Generation**:
```bash
python scripts/generate_missing_stories.py
```
- Scans for wallpapers missing stories
- Batch calls LLM to generate stories
- Auto-updates metadata and pages
### Batch Fetching
```bash
# Fetch Bing Wallpapers
python batch_fetch.py bing 2025-12 # Whole Month
python batch_fetch.py bing 2025-12-10 # Specific Date
# Fetch Unsplash Wallpapers
python batch_fetch.py unsplash 2025-12 # Whole Month (Multiple Featured)
python batch_fetch.py unsplash 2025-12-10 # Specific Date
# Source Case Insensitive
python batch_fetch.py BING 2025-12
python batch_fetch.py Unsplash 2025-12-10
```
### Adding New Sources
1. Edit `config/sources.yaml`:
```yaml
sources:
- name: new_source
display_name: "New Source ๐จ"
enabled: true
api_key_env: "NEW_SOURCE_API_KEY"
fetcher_script: "fetch_new_source.py"
```
2. Create `fetch_new_source.py` fetcher script
3. Run tests and commit
---
## ๐ค Follow Me
> Scan to follow "Knowledge into System" (ๆ็ฅ่ฏๅๆ็ณป็ป)
## โ๏ธ License
MIT License. For learning and exchange only. Wallpaper copyrights belong to Bing and Unsplash.