A Python-based GUI application for downloading images from SimpCity forums using cookie-based authentication.

• Hybrid download engine using browser automation and fast HTTP requests
• Modern GUI built with Tkinter and ttkbootstrap
• Cookie-based authentication (no passwords stored)
• Automatic setup of folders and config files
• Multi-page thread support
• Organised downloads by thread
• Real-time progress and logging

• Python 3.9 or higher recommended
• Internet connection
• A SimpCity account
• Chromium-based browser (for Playwright)

Arch / Endeavour / CachyOS:

sudo pacman -S python tk tcl xorg-xwayland

Ubuntu / Debian:

sudo apt install python3 python3-tk

git clone https://github.com/annashumate1/SimpDL.git
cd SimpDL

python -m venv .venv

Activate it:

bash / zsh:

source .venv/bin/activate

fish:

source .venv/bin/activate.fish

pip install -r requirements.txt
playwright install chromium

python main.py

On first run, SimpDL automatically creates:

config/
config/config.json
config/manual_cookies.json
urls.txt
~/Downloads/SimpDL/

The GUI opens even if cookies are missing.

SimpDL does not store your username or password. Authentication uses browser cookies.

Run:

python extract_cookie_header.py

Then:

1. Go to https://simpcity.cr
2. Log in
3. Press F12 and open the Network tab
4. Refresh the page
5. Click the first request
6. Copy the entire Cookie header
7. Paste it into the script

This fills:

config/manual_cookies.json

Default:

~/Downloads/SimpDL

Change it in:

config/config.json

Example:

{
  "output_directory": "/path/to/output"
}

You can also change it inside the GUI.

Add links manually in:

urls.txt

Example:

https://simpcity.cr/threads/example.12345/

Or use the built-in Generate Links tab.

Launch:

python main.py

Inside the app:

• Config: set output folder
• URLs: manage download targets
• Generate Links: auto-create pages
• Download: start the hybrid engine

Click "Start Hybrid Download" to begin.

1. First page is loaded through Playwright to validate access
2. Remaining pages are downloaded using fast authenticated HTTP requests

This balances reliability and speed.

Cookies are missing or expired. Re-run:

python extract_cookie_header.py

Output folder not set. Open the Config tab or edit:

config/config.json

Install:

sudo pacman -S tk
# or
sudo apt install python3-tk

Make sure you are using the virtual environment:

which python

It should point to .venv/bin/python.

This project is for educational and personal-use purposes only. Users are responsible for complying with the target website’s terms of service and local laws.

By downloading and using this program you agree that Anna is beautiful and deserves every ounce of respect you have.