Documentation

1. Installation

The installer handles everything automatically, including missing dependencies.

• Download AVSecureSessionSetup.bat from the home page.
• Right-click it and select Run as administrator.
• Press 1 to select "Install Plugin" and let it finish.
• Restart Discord when prompted. The lock icon should appear in your chat bar.

2. Create Your Session

Create a secure session with a shared passphrase.

• Go to Discord Settings → Vencord: Plugins.
• Find AV Secure Session and open its settings (gear icon).
• Enter a session name and passphrase (minimum 8 characters).
• Click Create / Unlock Session. Status should show ACTIVE & UNLOCKED.
• The lock icon in the chat bar should now turn yellow (ready but not encrypting).

3. Invite Others

Bring others into your encrypted session using invite codes.

• Make sure your session is active (lock icon is yellow or green).
• Click Copy Invite Code in plugin settings, or use the Copy Invite button inside Secure Room.
• Share the invite code with your peer through any channel. It starts with AVSEC_INVITE::.
• Your peer must have the plugin installed and create a session with the same passphrase.
• The invite code does NOT contain the passphrase — it only carries connection metadata.

4. Channel Encryption

Encrypt messages in any Discord channel.

• Right-click the lock icon in the chat bar to toggle encryption on/off.
• When green, all your messages are encrypted before sending.
• Other users with matching passphrase see decrypted plaintext. Everyone else sees AVSEC::... blobs.
• Encryption works across all channels simultaneously.

5. Secure Room (P2P Chat)

For maximum privacy, use the Secure Room. Messages travel peer-to-peer and never touch Discord.

• Left-click the lock icon to open the Secure Room modal.
• One user clicks Host Room. The other opens Secure Room in the same channel and waits.
• Optionally set a Room Password (same on both sides) for extra security.
• Wait for status to show Connected.
• Send text messages, files (up to 200KB), and see typing indicators in real time.
• Use Copy Invite in the footer to share the room with someone else.
• Click Leave to disconnect without closing the modal.

6. Validation Checklist

• Lock icon turns green when encryption is active.
• Channel messages show AVSEC::... format in transit, decrypted plaintext for matching users.
• Secure Room transitions through host/join signaling and reaches Connected.
• Typing indicators appear when your peer is typing in Secure Room.
• System messages confirm join/leave events in the room.

7. Common Issues

• Not encrypting: Right-click the lock icon to enable encryption. Session must be active.
• Failed to decrypt: Passphrase mismatch. Both users must re-unlock with the same passphrase.
• Secure Room stuck: Both users must be in the same Discord channel with active sessions. Try hosting again.
• Invite not working: Receiver needs the plugin installed + same passphrase. The invite code only carries connection info.
• Bad install state: Run AVSecureSessionSetup.bat with the Remove option, then reinstall.

Limitations & Safety

Please be aware of the following:

• Passphrases are in-memory only. You must unlock again after every Discord restart.
• Regular channel attachments (images, files) are NOT encrypted. Use Secure Room for file sharing.
• Not affiliated with Discord. Client mods may violate Discord ToS. Use at your own risk.
• Discord can see that encrypted data is being sent, but not its contents.
• Invite codes do not contain passphrases and are safe to share publicly.