# yapcc Yet another PictoChat clone

A modernized web-based clone inspired by the classic DS PictoChat. This updated version features a beautiful glassmorphism UI, persistent database storage, live long-polling syncing, and a suite of powerful quality-of-life tools built directly into the client.

## 🌟 Key Features

### Beautiful & Responsive UI
* **Glassmorphism Design**: Sleek, transparent UI panels over dynamic background gradients.
* **Light / Dark Mode**: Instantly toggle between a crisp, paper-esque light theme and a sleek dark theme (`☀`/`🌙`).
* **Responsive Layouts**: Smart layouts that adapt to your device. On mobile/portrait displays, the color palette tucks away into a clean `🎨` dropdown submenu to save space. On desktop, tools sit seamlessly beside your canvas.
* **Expandable View (`⤢`)**: Bring the drawing surface and tools into a massive, centered fullscreen overlay for serious sketching.

### Advanced Canvas & Drawing Tools
* **Expandable Canvas (`↕`)**: Need more vertical space to draw? Click the extend button to instantly double or triple your canvas height (capped at 3x) without losing any existing strokes!
* **Auto-Cropping**: When you hit send, the app intelligently scans your canvas and crops out unused whitespace from the top and bottom to maximize space in the chat log. 
* **Custom Color Swatches**: Includes 8 standard colors, a custom hex picker, and a **Randomize (`🎲`)** button that instantly generates a unique theme color for your strokes and chat name.
* **Anti-Spam Cooldown**: 60-second cooldown timer.

### Streaming & Archives
* **OBS Stream Mode**: Add `?stream=1` to the URL to instantly convert the page into a pure, UI-free, transparent scrolling chat feed—perfect for overlaying on Twitch/OBS streams!
* **Image Archive Download (`💾`)**: Click the floppy disk icon to instantly generate and download a ZIP file containing every single drawing currently stored in the room's database.

### Authentication & Moderation
* **Persistent Sessions**: Usernames are tied to secure session cookies. If a name is used, it is reserved exclusively for that user until 1 hour of inactivity passes.
* **Admin Accounts**: Launch the server with the `--admin` flag to register an administrator. The frontend will dynamically prompt for a password when attempting to join with an admin name.
* **Moderation Commands**: Logged-in admins can simply type `/kick [username]` into the chat box and hit send to permanently disconnect a user, wipe their session, and broadcast a global kick notification to the room.

## 🚀 Setup & Usage

### Requirements
* Python 3.x
* Flask (`pip install Flask`)
* Waitress (`pip install waitress`)

### Running the Server

Start the server using standard options:
```bash
python main.py --port 2004
```

**Registering an Administrator:**
Append the `--admin` flag followed by `Username:Password` to lock a name and grant it moderation abilities. You can specify this multiple times for multiple admins:
```bash
python main.py --admin Owner:supersecret
```

### Accessing the Room
1. Open your browser and navigate to `http://localhost:2004` (or whatever port you configured).
2. Enter your desired handle.
3. Draw, type, and chat! All history is permanently stored in a local SQLite database (`chat.db`) and pruned down to the 500 most recent messages automatically.


## Screenshots

<img src="https://lain.lives.moe/lainlives/pictoclone/raw/master/screenshots/colors.png" />
<img src="https://lain.lives.moe/lainlives/pictoclone/raw/master/screenshots/beeg.png" />
<img src="https://lain.lives.moe/lainlives/pictoclone/raw/master/screenshots/mobile.png" />
<img src="https://lain.lives.moe/lainlives/pictoclone/raw/master/screenshots/expand.png" />
<img src="https://lain.lives.moe/lainlives/pictoclone/raw/master/screenshots/light.png" />
<img src="https://lain.lives.moe/lainlives/pictoclone/raw/master/screenshots/overlay.png" />