CYBERCHAT v3.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

5.2 KiB Raw Blame History