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

Summary (AI generated)

Archived original version »

Chitchatter is a decentralized real-time communication tool leveraging peer-to-peer (P2P) technology via WebTorrent and WebRTC for secure, ad-free interactions. It emphasizes privacy by avoiding reliance on centralized servers but requires proper configuration to ensure functionality.

Deployment & Configuration:

To self-host Chitchatter on GitHub Pages:

  1. Modify package.json’s homepage field to your repository URL (e.g., https://username.github.io/repo).

  2. Set up a DEPLOY_KEY secret in GitHub Actions for deployment via SSH.

Runtime settings, including STUN/TURN relay servers and pairing configurations, are managed in the src/config directory. For non-GitHub hosting, build with PUBLIC_URL="your-domain" and serve the build folder securely.

Troubleshooting:

  • Peer Connection Issues: Often stem from network restrictions; ensure configured STUN/TURN relays (default servers may be unreliable).

  • Ad Blockers: uBlock Origin can block WebTorrent connections—disable or self-host to bypass.

  • iOS Safari: Users may need to refresh the page after reopening the app due to browser limitations.

  • Firefox: Enable media.peerconnection.enabled in about:config (issue #36).

Legal Notice: Users assume full responsibility for their actions, and contributors disclaim liability for any misuse or consequences of using Chitchatter.

In summary, Chitchatter offers a privacy-focused communication platform requiring careful setup for optimal performance. Its success depends on proper configuration across hosting, network settings, and browser compatibility, with ongoing troubleshooting needed to address potential connectivity issues.