GitHub - jeremyckahn/chitchatter: Secure peer-to-peer chat that is serverless, decentralized, and ephemeral

Summary (AI generated)

Archived original version »

Chitchatter is an open-source, decentralized web application designed for real-time communication using peer-to-peer technology (WebRTC/WebTorrent). It allows users to connect via room names or IDs, emphasizing privacy by avoiding centralized servers that store data. Key features include cross-browser compatibility and self-hosting capabilities.

Functionality:

  • Real-time text/audio/video communication with encryption.

  • No central server storage; connections rely on peer-to-peer networking.

  • Supports room-based interactions accessible via unique identifiers.

Technical Details:

  • Uses STUN/TURN servers for network traversal, though free relays may face service issues.

  • Requires HTTPS (secure context) for operation across platforms like iOS Safari and desktop browsers.

Self-Hosting Guide:

  1. Modify package.json with your GitHub Pages URL (e.g., https://username.github.io/repo).

  2. Configure deployment via GitHub Actions, setting a deploy key for SSH access.

  3. Adjust STUN/TURN servers in src/config if needed.

Troubleshooting:

  • Ad Blockers: Extensions like uBlock Origin may block WebTorrent peers; disable or self-host.

  • iOS Safari: Peers may need to refresh pages to reconnect after closing browsers.

  • Firefox: Ensure media.peerconnection.enabled is activated in about:config.

Disclaimer: Users assume full responsibility for their actions, and developers disclaim liability for misuse or illegal activities. Contributors are acknowledged, with the project hosted on GitHub under an open-source license.

Chitchatter prioritizes privacy but requires users to navigate potential platform-specific issues and carefully configure self-hosted instances. Its decentralized nature ensures no third-party data storage but relies on user vigilance for reliability and compliance.