Getting Started
Get up and running with Pisscord in three simple steps. No account creation, no email verification, no phone number required.
Download & install
Grab the latest Windows installer from GitHub releases. Run the setup wizard - it takes about 30 seconds. Pisscord installs to your AppData folder and creates a desktop shortcut.
Set your display name
On first launch, you'll be prompted to enter a display name. Pick something your friends will recognize. You can also choose a profile color and set a status message.
You're connected!
That's it. Pisscord automatically connects you to the presence server. Everyone online appears in the user list on the right. Jump into a voice channel or start chatting - voice and video go directly P2P, no relay servers involved.
Pisscord checks for updates automatically. When a new version is available, you'll be prompted to restart and install it.
Interface Overview
Pisscord's layout will feel familiar if you've used Discord. Here's a breakdown of each area.
Channel sidebar
Left side - lists all text and voice channels. Click to switch views. Voice controls appear here when connected.
Main content area
Center - shows the current channel. Chat messages, voice stage, or AI conversation depending on selection.
User list
Right side - shows everyone online. Click a user to view their profile or start a direct call.
Voice controls
Bottom left (when connected) - mute, camera, volume slider, and disconnect. Always accessible from any channel.
Channel Types
Pisscord has several channel types, each serving a different purpose.
#general Text Channel
The main chat room. Supports full markdown formatting, image uploads, file sharing, video embeds, and voice messages. Messages are retained for 14 days.
Chillin' Voice Channel
Open voice/video room for casual hangouts. Click to join — you start muted with camera off by default. Multiple people can be in the same voice channel with true mesh networking.
Gaming Voice Channel (Approval Required)
Same as Chillin', but requires approval to join when others are already in the channel. A lock icon indicates this. Users inside will see approve/deny buttons when someone requests to join.
#pissbot AI Channel
Chat with Pissbot, our built-in AI assistant powered by Google Gemini. Ask questions, get recommendations, or just have a conversation. Pissbot knows everything about Pisscord.
#dev-updates Development Feed
Live feed of GitHub commits and development activity. See what's being worked on in real-time. Read-only channel - just for keeping up with the project.
#issues Bug Reports
Report bugs directly from the app. Your reports are sent to Firebase and reviewed by the development team. Include steps to reproduce for faster fixes.
Voice & Video
Crystal-clear pee-to-pee voice and video with no relay servers. Here's how to use it effectively.
A green ring appears around avatars when someone is speaking. This uses Web Audio API for real-time voice activity detection.
Video spotlight
Click any video tile to pin and maximize it. Perfect for presentations or focusing on one person. Click again to unpin.
Volume boost
Volume slider goes up to 200%, letting you boost quiet participants. Great for people with soft mics.
Browse while talking
Switch to text channels while in a voice call. Audio persists - you won't get disconnected.
ML noise cancellation
RNNoise WASM-powered pipeline kills keyboard clicks, fans, and background chatter. Enable in Settings > Voice & Video.
Text Messaging
Full-featured chat with markdown support, video embeds, voice messages, and file sharing.
**bold**
*italic*
~~strike~~
`code`
```code```
[text](url)
# Header
- item
Messages are automatically deleted after 14 days. This keeps the system lightweight and respects privacy. Save important info elsewhere.
Pissbot AI
Your built-in AI assistant. Powered by Google Gemini 2.0 Flash. Ask anything — it remembers your last 20 messages per session.
Ask questions
Pissbot knows everything about Pisscord - features, troubleshooting, release notes. Just ask in natural language.
Entertainment
Ask for jokes, stories, or random facts. Pissbot has personality and isn't afraid to use it.
General knowledge
Programming help, writing assistance, research questions - Gemini handles it all.
Pissbot's knowledge is updated via Firebase - no app rebuild required when we add new features or fix bugs.
File Sharing
Share images and files directly in chat. Drag, drop, done.
Drag & drop
Drag any image or file into the chat area. Or click the attachment button in the message input.
Automatic upload
Files are uploaded to Firebase Storage. Images are automatically optimized for faster loading.
Preview & download
Images display inline. Click to view full size. Other files show a download link.
Your Profile
Customize your presence. Stand out in the void.
Display name
Choose any name you want. Change it anytime in Settings → Profile.
Avatar color
Pick a color for your avatar circle. Your initial is displayed in the chosen color.
Profile picture
Upload a custom avatar image. Synced to Firebase so everyone sees it.
Status message
Set a custom status that appears under your name. "Gaming", "AFK", whatever you want.
App Settings
Configure your devices, check for updates, and view debug logs.
info (green), error (red), webrtc (blue). Helpful for troubleshooting connection issues. Shows last 50 entries.
Keyboard Shortcuts
Power-user shortcuts to navigate faster.
Troubleshooting
Common issues and how to fix them.
Check Settings → Voice & video → Output device. Make sure the correct speakers/headphones are selected. Also check your system volume and that Pisscord isn't muted in Windows Volume Mixer.
Check that you're not muted (microphone icon in voice controls). Verify the correct microphone is selected in Settings. Some browsers block mic access by default - check the address bar for permission icons.
Pee-to-pee connections can be blocked by strict firewalls or certain network configurations (corporate networks, some college dorms). Try a different network or contact your IT department about WebRTC/STUN/TURN firewall rules.
Video quality depends on your internet connection. Try closing other bandwidth-heavy apps. If issues persist, disable video and use voice-only. Pee-to-pee connections are sensitive to packet loss.
Try deleting the app data folder at %APPDATA%/pisscord and reinstalling. If issues persist, check the Debug Log in Settings or report the bug in #issues.
Pissbot requires a valid Gemini API key. Self-hosted builds need VITE_GEMINI_API_KEY in environment variables. If you're using the official release, this might be a temporary API outage - try again in a few minutes or file a bug report in #issues if it persists.
Report bugs in the #issues channel or open an issue on GitHub. Include your Pisscord version and steps to reproduce.