Skip to content

README.md

Latest commit

 

History

History
124 lines (85 loc) · 3.29 KB

README.md

File metadata and controls

124 lines (85 loc) · 3.29 KB
Raw

ChatGPT Library Archiver

This is a Python-based toolset for downloading, archiving, and browsing images generated via ChatGPT (4o Image Generator). It stores all images in versioned folders and generates static HTML galleries for easy viewing.

📦 Folder Structure

gallery/
├── v1/
│   ├── images/
│   ├── metadata_v1.json
│   ├── page_1.html, page_2.html, ...
├── v2/
│   └── ...
├── index.html  ← main entry point
auth.txt        ← credentials for API access

⚙️ 1. Setup Instructions

🔹 Requirements

🔹 Install Dependencies

None required beyond standard requests, concurrent.futures, tqdm and json.

🛠 2. auth.txt — Setup Your Authentication

This file is required for authenticated API access. Here's what it must contain:

url=https://chat.openai.com/backend-api/my/recent/image_gen?limit=100
authorization=Bearer <your_token_here>
cookie=__Secure-next-auth.session-token=<your_cookie_here>
referer=https://chat.openai.com/library
user_agent=Mozilla/5.0 (...)
oai_client_version=...
oai_device_id=...
oai_language=...

How to Get These:

  1. Log into https://chat.openai.com/library
  2. Open Developer Tools (in Chrome, by pressing F12) → Network tab → Fetch/XHR
  3. Scroll down the page to load new images in the library
  4. Find any request to image_gen : they should look like image_gen?limit=6&after.... Click on one of them
  5. Scroll down the Headers section until you find the required Headers, as in the auth.txt
  6. Copy the headers exactly as they are; note that for the cookie key, you only need the part starting with __Secure-next-auth.session-token=...
  7. Paste values into auth.txt

🚀 3. Script Usage

🧭 Full Flow (Recommended):

  1. run main.py
python main.py
  • Downloads only new images, creates gallery/vN/, images/, metadata_vN.json, page_1.html etc., creates/updates gallery/index.html with links to all pages

🧭 Single Steps:

  1. Download New Images
python incremental_downloader.py
  • Scans all existing v*/metadata_v*.json
  • Downloads only new images
  • Creates gallery/vN/, images/, and metadata_vN.json
  1. Generate HTML Gallery
python generate_gallery_batch.py
  • Detects the latest batch (e.g. v3)
  • Generates page_1.html, page_2.html, etc. inside v3
  1. Update the Main Index Page
python generate_index.py
  • Scans all gallery/v* folders
  • Creates/updates gallery/index.html with links to all pages

💡 Notes

  • No old data is overwritten. Every batch is saved in its own versioned folder (v1, v2, etc.).
  • Each gallery version is fully static and self-contained.
  • The index.html provides a quick navigation hub.

❓ Troubleshooting

  • If you get a 403 or 401, your token or cookie may have expired. Refresh auth.txt by copying headers again from your browser.
  • If a version is created with no new images, it will be cleaned up automatically.

✅ You're All Set

Once configured, just rerun the three scripts above any time you generate new images in ChatGPT.

Happy archiving!