🚀 PixVault Service Documentation

1) Setup & Installation

# Clone the repository https://github.com/ApeDevOne/PixVault # Create virtual environment python -m venv venv # Activate (Windows) venv\Scripts\activate # Install dependencies pip install -r requirements.txt # Run server uvicorn main:app --host 0.0.0.0 --port 7979 --reload

Server runs at:

http://localhost:7979

2) Authentication

Most endpoints require:

?key=Your_Secret_Key

Change key inside main.py

3) Thumbnail Generation

GET /api/thumbnails/generate?key=Your_Secret_Key GET /api/thumbnails/progress/view

📁 Folder Metadata

GET /api/folders/generate?key=Your_Secret_Key

Skips folders with only videos

{ "status": "generated", "folders": 1, "file": "\\data\\folders.json" }

⚠️ After editing, rebuild cache:

POST /api/cache/rebuild?key=Your_Secret_Key

🏷️ Tag Generation

GET /api/tags/generate?key=Your_Secret_Key { "status": "updated", "total_folders": 1, "file": "\\data\\tags.json" }

⚠️ Rebuild cache after editing

📊 Statistics

GET /api/stats

🌍 Visit Logging

GET /api/visitlog?key=Your_Secret_Key { "countries": {"XX": 1}, "paths": {"/": 2}, "recent": [...] }

Uses Cloudflare headers:

CF-IPCountry CF-Connecting-IP

🛠️ Debug Headers

GET /api/debug/headers?key=Your_Secret_Key

🔄 Cache Rebuild

Required after editing:

POST /api/cache/rebuild?key=Your_Secret_Key

⚠️ Notes