Chat v2.0

A self-contained, embed-ready real-time web chat built with PHP, JavaScript, HTML5, and SQLite. No external dependencies beyond PHP 8.0+.

---

Features

• Register on the fly — pick a callsign (username) and passphrase, start chatting instantly
• Session-locked — one login per user enforced by IP + cookie; no multi-location sessions
• Daily chat rooms — each day starts fresh; yesterday's messages are automatically archived
• SQLite archives — stored per archive/{year}/{month}/{day}.sqlite; browseable via archive-viewer.php
• Neon cyberpunk UI — dark by default, light mode toggle per user (saved to localStorage)
• Embed-ready — drop into any <div> container; auto-adapts to any size
• Fully configurable — config.json controls all limits, intervals, and theming
• Voice clips — record, review, send, and queue WAV/WebM clips one at a time using normal PHP polling
• No Node.js or WebSockets — voice uses browser recording, HTTP uploads, and the existing poll loop

---

Requirements

• PHP 8.0+ with PDO SQLite extension enabled
• Any web server (Apache, Nginx, Caddy, PHP built-in)
• Write permissions on db/, archive/, and uploads/voice/ directories
• PHP/web-server upload limits at or above voice.max_upload_bytes

---

Quick Start

# 1. Copy files to your web root (or a subdirectory)
cp -r cyberchat/ /var/www/html/chat/

# 2. Make sure database, archive, and voice storage are writable
chmod 755 /var/www/html/chat/db/
chmod 755 /var/www/html/chat/archive/
chmod 755 /var/www/html/chat/uploads/voice/

# 3. Visit in browser
# http://yourdomain.com/chat/

The SQLite database is created automatically on first visit.

---

Embed in Your Own Page

<!-- Fonts -->
<link href="https://fonts.googleapis.com/css2?family=Share+Tech+Mono&family=Rajdhani:wght@400;600;700&family=Orbitron:wght@700;900&display=swap" rel="stylesheet">

<!-- Stylesheet -->
<link rel="stylesheet" href="/chat/assets/css/cyberchat.css">

<!-- Container — set any size -->
<div id="my-chat" style="width:100%; height:600px;"></div>

<!-- Script -->
<script src="/chat/assets/js/cyberchat.js"></script>
<script>
  window.CYBERCHAT_BASE = '/chat'; // path to your cyberchat install
  CyberChat.init('#my-chat');
</script>

See embed-example.html for a live demo.

---

Configuration — config.json

Key	Default	Description
chat.max_message_length	500	Max characters per message
chat.max_username_length	12	Max callsign length
chat.poll_interval_ms	2000	How often client polls for new messages (ms)
chat.messages_per_page	100	Messages loaded on initial connect
chat.session_lock_ip	true	Enforce single login per IP
chat.session_lock_cookie	true	Enforce single login per cookie
voice.enabled	true	Enable voice clip controls and uploads
voice.max_duration_seconds	60	Maximum voice clip duration
voice.max_upload_bytes	12582912	Maximum voice upload size
voice.auto_play_default	true	Queue and play new incoming clips one at a time by default
voice.upload_dir	"uploads/voice"	Voice recording storage path
security.min_password_length	4	Minimum passphrase length
security.session_timeout_hours	24	Session expiry
security.bcrypt_cost	10	bcrypt work factor for passwords
ui.default_theme	"dark"	Default theme (dark or light)
ui.app_title	"CYBERCHAT"	Title shown in header
ui.app_subtitle	"v3.0 // SECURE CHANNEL"	Subtitle shown in header
colors.user_palette	[...]	Array of hex colors assigned randomly to users

---

File Structure

cyberchat/
├── index.html              ← Main chat page
├── embed-example.html      ← Embed usage example
├── archive-viewer.php      ← Browse archived days
├── bootstrap.php           ← DB init, helpers, session auth
├── config.json             ← All configuration
├── api/
│   ├── auth.php            ← Register / Login / Logout / Check
│   ├── messages.php        ← Send / Poll / History
│   └── config.php          ← Serves safe config to frontend
├── assets/
│   ├── css/cyberchat.css   ← Full cyberpunk stylesheet
│   └── js/cyberchat.js     ← Chat client (no framework)
├── db/
│   └── chat.sqlite         ← Created automatically; today's messages
├── uploads/
│   └── voice/              ← WAV/WebM voice recordings
└── archive/
    └── {year}/{month}/     ← Auto-archived per day as .sqlite files
        └── {day}.sqlite

---

Archive Viewer

Visit archive-viewer.php to browse historical chat logs. Select a day from the sidebar to read its messages.

---

Nginx Config Example

See nginx-example.conf for a ready-to-use virtual host config.

---

Security Notes

• Passwords are hashed with bcrypt (configurable cost factor)
• Session tokens are 64-char cryptographically random hex strings
• Session cookies are HttpOnly, SameSite=Strict, and Secure when served over HTTPS
• All user input is escaped on output; no raw HTML accepted
• Single-login enforcement via IP + cookie prevents session sharing