https://github.com/bad-antics/p2p-chatter-lite
https://github.com/bad-antics/p2p-chatter-lite
Last synced: 6 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/bad-antics/p2p-chatter-lite
- Owner: bad-antics
- License: mit
- Created: 2025-12-30T01:35:46.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-12-30T13:41:07.000Z (6 months ago)
- Last Synced: 2026-01-02T14:23:33.906Z (6 months ago)
- Language: JavaScript
- Size: 302 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG_LATEST.md
- License: LICENSE
Awesome Lists containing this project
README
# P2P Chatter Lite π΄ββ οΈ
**Privacy-Focused β’ Decentralized β’ Lightweight Peer-to-Peer Messaging**
A minimal, fast, and secure peer-to-peer messaging application with end-to-end encryption, Tor support, and multiple hacker themes.
## π― Features
### π Security & Privacy
- π **AES-256-GCM End-to-End Encryption** - Military-grade encryption
- π§
**Tor Integration** - Route through Tor network for anonymity
- π΅οΈ **OPSEC Features** - Anonymous mode, screenshot detection, text scrambling
- πΈ **Screenshot Detection** - Alerts when PrintScreen is pressed
- π¬ **Text Scrambling** - Blur effect when copying sensitive text
### β‘ Performance
- **Fast Startup**: Launches in under 2 seconds
- **Lightweight**: ~50MB portable executable
- **Low Memory**: Minimal RAM footprint
- **Optimized Code**: Streamlined for speed
### π¨ Themes & UI
- **6 Color Themes**: Matrix Green, Cyberpunk, Terminal Amber, Hacker Red, Dark Web, Neon Void
- **Discord-Like Interface**: Compact, modern design
- **Clean Aesthetics**: Professional hacker aesthetic
- **Smooth Animations**: Theme switching animations
### π¬ Messaging
- π€ **Auto-Generated Usernames** - Funny names like P2P-LaughingLlama
- π **Password Authentication** - Secure peer connection
- β
**Read Receipts** - Know when messages are seen
- βοΈ **Typing Indicators** - See when peer is typing
- π **Reactions** - React with emojis
- π **Pin Messages** - Important message management
- π **Sound Notifications** - Audio alerts
## π Getting Started
### Installation
#### Windows (Fastest)
1. Download: `P2P-Chatter-Lite-v1.0.0.zip`
2. Extract files
3. Run: `P2P Chatter Lite 1.0.0.exe`
4. Or use desktop shortcut (skull π΄ββ οΈ icon)
git clone https://github.com/bad-antics/p2p-chatter-lite.git
cd p2p-chatter-lite
npm install
npm start
```
### System Requirements
- **OS:** Windows 10/11 (64-bit) or later
- **RAM:** 500MB minimum
- **Storage:** ~70MB for installation
## π Setup Guide
### 1. Generate Username
- **Auto-generated** with format `P2P-[FunnyName]`
- Examples: `P2P-LaughingLlama`, `P2P-SpeedyTiger`, `P2P-CrazyWombat`
- Click π to regenerate, π to copy
### 2. Connection Setup
- **Your Username:** Auto-generated
- **Peer Username:** Enter who you want to chat with
- **Connection Password:** Share outside the app with peer
### 3. Enable Security
- **π Encryption Toggle** - Enable AES-256-GCM encryption
- Flashing red = OFF
- Flashing blue = ON
- **π§
Tor Toggle** - Route through Tor network
- Purple glow = Active
### 4. Themes & Options
Click **"π¨ Themes & Options βΌ"** to:
- **Switch Themes:**
- Matrix Green (default)
- Cyberpunk (pink/cyan)
- Terminal Amber (retro)
- Hacker Red (intense)
- Dark Web (purple/orange)
- Neon Void (cyan/blue)
- **Chat Options:**
- β Read Receipts
- β Typing Indicators
- β Message Reactions
- β Pin Messages
- β Sound Notifications
## π¨ Themes Gallery
| Theme | Colors | Vibe |
|-------|--------|------|
| **Matrix Green** | Green/Black | Classic hacker |
| **Cyberpunk** | Pink/Cyan | Neon future |
| **Terminal Amber** | Amber/Orange | Retro computing |
| **Hacker Red** | Red/Black | Intense & bold |
| **Dark Web** | Purple/Orange | Mysterious |
| **Neon Void** | Cyan/Blue | Digital void |
## π Security & Privacy
### End-to-End Encryption
- **AES-256-GCM** military-grade encryption
- **No servers** - Messages never leave your device
- **No accounts** - No registration required
- **No tracking** - Complete anonymity
### OPSEC Status Indicator
Real-time display showing:
- **Encryption:** ON (blue) / OFF (red)
- **Tor:** ON (blue) / OFF (red)
- **Security Level:** LOW / MEDIUM / HIGH
### Privacy Features
- **Screenshot Detection** - Alerts on PrintScreen
- **Text Scrambling** - Blur effect when copying
- **No Logs** - Ephemeral message mode available
- **Local Storage Only** - Messages stay on device
## ποΈ Project Structure
```
p2p-chatter-lite/
βββ main.js # Electron main process
βββ preload.js # IPC security layer
βββ package.json # Dependencies
βββ src/
β βββ index.html # Main UI
β βββ app.js # 675+ lines of logic
β βββ styles.css # 1000+ lines, 6 themes
β βββ app.ico # Skull & crossbones icon
βββ dist/
βββ P2P Chatter Lite 1.0.0.exe (67.9 MB)
```
## π Building from Source
### Prerequisites
```bash
- Node.js 16+
- npm 8+
- Windows 10/11 (64-bit)
```
### Build Steps
```bash
git clone https://github.com/bad-antics/p2p-chatter-lite.git
cd p2p-chatter-lite
npm install
npm run build-win # Create Windows executable
npm start # Development mode
```
## π οΈ Development
### Dev Mode
```bash
npm install
npm start
```
### Build Executable
```bash
npm run build-win
```
Output: `dist/P2P Chatter Lite 1.0.0.exe`
## π Features Checklist
### Security β
- β
AES-256-GCM Encryption
- β
Tor Integration
- β
Screenshot Detection
- β
Text Scrambling
- β
OPSEC Indicators
### Messaging β
- β
P2P Direct Connection
- β
Auto-Generated Usernames
- β
Password Authentication
- β
Read Receipts
- β
Typing Indicators
- β
Message Reactions
- β
Pin Messages
- β
Sound Notifications
### UI β
- β
6 Color Themes
- β
Discord-Like Compact Design
- β
Dark Mode Only
- β
Modern Fonts (Segoe UI)
- β
Smooth Animations
- β
Dropdown Menu System
### Installation β
- β
Portable Executable
- β
Desktop Shortcut (with skull icon)
- β
Custom Branding
- β
Open Source
## π Getting Started
### Quick Launch
1. Download `P2P-Chatter-Lite-v1.0.0.zip`
2. Extract ZIP
3. Double-click `P2P Chatter Lite 1.0.0.exe`
4. Or use Desktop shortcut
### First Chat
1. Copy your username (π button)
2. Share with peer via secure channel
3. Peer enters their username
4. Exchange connection password (outside app)
5. Enable encryption (π)
6. Start chatting!
## π Troubleshooting
### App won't start
```
- Windows Defender may be blocking (add exception)
- Try --disable-gpu flag
- Ensure 500MB+ RAM available
```
### Can't connect to peer
```
- Verify same connection password
- Both users must have app running
- Check Firewall settings
```
### Tor not working
```
- Ensure internet connection
- Tor may take 10-15 seconds
- Check Windows Firewall
- Restart app and try again
```
## π Support & Issues
Found a bug? Have a feature request?
- **Issues:** [GitHub Issues](https://github.com/bad-antics/p2p-chatter-lite/issues)
- **Discussions:** [GitHub Discussions](https://github.com/bad-antics/p2p-chatter-lite/discussions)
## β οΈ Disclaimer
- Not audited by security experts
- Hobby project for learning
- For non-critical communications
- Always verify peer identity separately
- Use established messengers for sensitive operations
## π License
**MIT License** - Free to use, modify, distribute
See [LICENSE](LICENSE) for full text
## π€ Authors
**bad-antics / antX** - Privacy advocate, open-source developer
## π cr3dz
Special recognition to:
- **FairyRos3** - UI/UX design & user experience
- **sleep** - Inspiration & security guidance
- **no.login** - P2P architecture & decentralization principles
## οΏ½πΊοΈ Roadmap
- [ ] Linux/macOS support
- [ ] Mobile apps (iOS/Android)
- [ ] Group messaging
- [ ] File transfer
- [ ] Voice/video calls
- [ ] Message search/history
- [ ] Backup & restore
- [ ] Hardware security key support
---
**P2P Chatter Lite**
*Privacy β’ Anonymity β’ Freedom* π΄ββ οΈ
Made with β€οΈ for those who value privacy
Privacy. Anonymity. Freedom.