c88b75f30d
Rewrite README.md and all setup guides to reflect the current native GraphQL WebSocket architecture (replacing stale headless Chrome/WebSocket interception descriptions). Add new docs/IRC.md with complete IRC command reference, vote syntax, and ticker symbol table. Archive pre-edit docs to docs/archive/setup-backup-2026-05-10/ and move historical development notes from docs/ root into docs/archive/. Co-authored-by: Cursor <cursoragent@cursor.com>
2.9 KiB
2.9 KiB
Message Relay Testing Instructions
Current Configuration
- Kosmi Room: Configured via
RoomURLinmatterbridge.toml - IRC Server: Configured via
Serverinmatterbridge.toml - IRC Channel: Configured via gateway
[[gateway.inout]]
Test 1: Kosmi --> IRC
Steps
- Open your Kosmi room in a browser
- Type a test message (e.g., "Test message from Kosmi")
- Press Enter to send
Expected Logs
INFO Received message from Kosmi: [<timestamp>] username: message text
DEBUG Forwarding to Matterbridge channel=main account=kosmi.hyperspaceout
Verification
The message should appear in your IRC channel with the configured RemoteNickFormat, typically:
[kosmi] <username> Test message from Kosmi
Test 2: IRC --> Kosmi
Steps
- Connect to your IRC server and join the configured channel
- Send a test message (e.g., "Test message from IRC")
Expected Logs
DEBUG <= Sending message from #channel on irc.account to gateway
DEBUG => Sending message to Kosmi
Verification
The message should appear in the Kosmi room with the configured format, typically:
[irc] <username> Test message from IRC
Test 3: Jackbox Vote Detection (if enabled)
Steps
- In IRC or Kosmi, type:
thisgame++ - Check bot logs
Expected Logs
DEBUG Detected vote from username: up (ticker="")
Test 4: IRC Commands
Steps
- In IRC, type:
!votes - Check for broadcast response
Expected Response (if active session)
🗳️ Game Title • Today: X👍 Y👎 (Score: Z) • All-time: X👍 Y👎 (Score: Z)
Watching Logs
# All logs
docker-compose logs -f
# Message-related logs only
docker-compose logs -f | grep -E "(Received|Sending|Forwarding|Detected)"
# Last 50 lines
docker-compose logs --tail=50
Success Criteria
- Messages sent in Kosmi appear in IRC
- Messages sent in IRC appear in Kosmi
- Usernames are displayed correctly with bridge prefix
- Messages appear within 1-2 seconds
- No errors in logs during normal relay
Troubleshooting
No Messages Appearing
- Check the container is running:
docker-compose ps - Check for errors:
docker-compose logs --tail=100 - Verify both bridges are connected (look for success messages)
- Restart if needed:
docker-compose restart
Messages Only Going One Direction
- Kosmi --> IRC works, IRC --> Kosmi doesn't: Check Kosmi WebSocket is connected
- IRC --> Kosmi works, Kosmi --> IRC doesn't: Check IRC connection status
Message Formatting Issues
Message format is controlled by RemoteNickFormat in each bridge's config section. Default: [{PROTOCOL}] <{NICK}>
Quick Commands
docker-compose up -d # Start
docker-compose logs -f # Follow logs
docker-compose down # Stop
docker-compose restart # Restart
docker-compose ps # Status
docker stats kosmi-irc-relay # Resource usage