Symptoms: Connection timeout, "Unable to connect"

Solutions:

• Check your internet connection
• Verify server address is correct
• Try different port (6667 for non-SSL, 6697 for SSL)
• Disable VPN/proxy temporarily
• Check if firewall is blocking IRC ports
• Try connecting via mobile data instead of WiFi

Symptoms: Random disconnections, "Connection lost"

Solutions:

• Enable auto-reconnect: Settings > Connection & Network > Auto-Reconnect
• Adjust auto-reconnect delays: Settings > Connection & Network > Auto-Reconnect
• Check network stability
• Try different server in same network
• Review lag settings: Settings > Connection & Network > Connection Quality

Symptoms: "SSL handshake failed", "Certificate error"

Solutions:

• Verify server supports SSL on that port (usually 6697)
• Try disabling "Verify SSL Certificate" in network settings
• Update to latest app version
• Check server certificate validity

Symptoms: "Nickname is already in use"

Solutions:

• Try alternate nickname
• Wait a few minutes (old session timeout)
• Use /msg NickServ GHOST YourNick password
• Change nickname: dropdown (menu) > Choose Network > Edit > Nickname

Symptoms: "Password incorrect", Not identified

Solutions:

• Verify password is correct
• Wait for NickServ notice before identifying
• Manually identify: /msg NickServ IDENTIFY password
• Check if account is suspended

Symptoms: "SASL authentication failed"

Solutions:

• Verify SASL username and password
• Check if SASL is enabled on server
• Try plain authentication method
• Ensure nickname matches SASL account

Symptoms: Message appears locally but others don't see it

Solutions:

• Check if you're still connected
• Verify you're not banned/quieted
• Check channel modes (+m moderated)
• Ensure you have voice (+v) if channel is moderated

Symptoms: Keyboard overlaps the message input

Solutions:

• Go to Settings > Display & UI > Keyboard Avoiding
• Android: try Behavior = Height (default) or Padding
• iOS: try Behavior = Padding or Position
• Adjust Keyboard Vertical Offset (for example 16-48)
• Android: toggle "Android Bottom Safe Area" for fullscreen vs. inset

Symptoms: Channel appears empty, no messages visible

Solutions:

• Check Settings > Display & UI > Show Raw Commands
• Verify filters in Settings > Messages & History
• Restart app to reload message history
• Check if user is ignored

Symptoms: Messages display as random characters

Solutions:

• Exchange encryption keys with sender
• Request key: /requestkey TheirNick
• Verify E2EE is enabled
• Check Key Management in Settings

Symptoms: "Cannot join channel", Error 473-475

Solutions:

• +i (Invite-only): Ask operator for invite
• +k (Key required): Join with password: /join #channel password
• +l (User limit): Wait for space
• +b (Banned): Ask operator to unban you

Symptoms: Message rejected, channel is quiet

Solutions:

• Check if channel is moderated (+m)
• Ask operator for voice (+v)
• Check if you're banned or quieted
• Verify you're still in the channel

Symptoms: Channel tab closes automatically

Solutions:

• Add it to auto-join: dropdown (menu) > Choose Network > Edit > Auto-Join Channels
• Rejoin channel manually
• Check network connection

Solutions:

• Clear message history cache
• Reduce message batch size: Settings > Performance
• Disable animated emojis/GIFs
• Close unused tabs
• Restart app

Solutions:

• Disable background service
• Reduce notification frequency
• Use WiFi instead of mobile data
• Enable battery optimization

Solutions:

• Update to latest version
• Clear app cache and data
• Restart device
• Report crash with logs to developers

Solutions:

• Check notification permissions
• Verify Settings > Notifications > Enabled
• Disable battery optimization for app
• Check Do Not Disturb is off
• Re-enable background service

Solutions:

• Adjust notification filters
• Enable "Highlights only" mode
• Mute specific channels
• Set quiet hours

Symptoms: Attachment button missing/disabled

Solutions:

• Verify E2EE is enabled for channel/DM
• Enable media feature in Settings
• Exchange encryption keys first
• Check file size (max 50MB)

Solutions:

• Check internet connection
• Enable auto-download: Settings > Media > Auto-Download Media
• Verify storage permission
• Clear media cache

Solutions:

• Request decryption key from sender
• Verify E2EE key exchange
• Check Settings > Security > Manage Encryption Keys

Solutions:

• Use biometric unlock if enabled
• Settings > Security > Reset PIN
• Backup/restore may help
• Last resort: Clear app data (loses all data)

Solutions:

• Check storage permission
• Verify storage space available
• Restart app
• Clear app cache

Solutions:

• Verify file integrity
• Check storage permission
• Use latest backup file
• Try export/import individually

• Join #AndroidIRCX on irc.dbase.in.rs
• Email: [email protected]
• GitHub Issues: github.com/yourrepo/issues

Before reporting, collect:

• App version
• Android version
• Device model
• Error message/screenshot
• Steps to reproduce

Enable Debug Logging: Settings > Development > Enable Console Logging (debug builds only) Send logs with your report.