Modern IRC client for Android and iOS built with React Native, inspired by the classic AndroIRC client. This project aims to provide a full-featured, IRCv3-compliant IRC client with a clean and intuitive user interface.

🎉 AndroidIRCX is now publicly available!

• Google Play Store: https://play.google.com/store/apps/details?id=com.androidircx

• Direct APK Download (Official Website): https://androidircx.com/app-release.apk

AndroidIRCX is a cross-platform IRC (Internet Relay Chat) client that brings the classic IRC experience to mobile devices. Built with React Native 0.83, it supports multiple networks, secure connections (SSL/TLS), end-to-end encryption for DMs and channels, and modern IRC features while maintaining full compatibility with IRCv3 standards.

• Multi-Network Support

  • Configure and manage multiple IRC networks
  • Multiple servers per network with failover support
  • Persistent network and server configurations
  • Background service for persistent connections

• Secure Connections

  • SSL/TLS encryption support
  • Certificate validation options
  • Server password authentication
  • Proxy/Tor support

• Encryption & Trust

  • Encrypted DMs and encrypted channels
  • Key verification with fingerprints and QR codes
  • Offline key exchange via file and NFC
  • TOFU + key pinning with change warnings

• IRCv3 Full Compliance 🎉

  • Complete Implementation: All 18 IRCv3 capabilities supported (Standard + Draft)

  • Full CAP Negotiation: Multi-line capability negotiation (CAP LS 302) with 27 total capabilities requested

  • SASL Authentication: Full SASL PLAIN mechanism with proper CAP integration

  • IRCv3.2 Standard Capabilities (10):

    • BATCH: Message grouping for efficient processing (netsplit, netjoin, chathistory batches)
    • LABELED-RESPONSE: Command/response correlation with unique labels (30s timeout)
    • CAP-NOTIFY: Dynamic capability notifications (CAP NEW/DEL handling)
    • ACCOUNT-TAG: Messages tagged with sender's account name
    • SETNAME: Change realname without reconnecting (/setname command)
    • STANDARD-REPLIES: Standardized FAIL/WARN/NOTE server responses
    • MESSAGE-IDS: Unique message identifiers with deduplication (1000 msgid cache)
    • BOT: Mark user account as bot (/bot on|off command)
    • UTF8ONLY: UTF-8 encoding enforcement
    • EXTENDED-MONITOR: Enhanced MONITOR with online/offline tracking

  • Draft IRCv3 Capabilities (8):

    • CHATHISTORY: Request message history from server (/chathistory command, up to 100 messages)
    • MULTILINE: Send/receive multi-line messages (5s assembly timeout)
    • READ-MARKER: Mark messages as read (/markread command)
    • MESSAGE-REDACTION: Delete/redact messages (/redact command)
    • REPLY: Reply to specific messages (threaded conversations)
    • REACT: Emoji reactions to messages (MessageReactionsService integration)
    • TYPING: Real-time typing indicators (see below for details)
    • CHANNEL-CONTEXT: PM channel context tracking

  • IRCv3.1/3.2 Base Extensions:

    • Message Tags: Complete @tag=value parsing and client-only tags (+tag)
    • Server-Time: Accurate server-provided timestamps for all messages
    • Account Notify: Automatic tracking of account login/logout events
    • Extended Join: Enhanced JOIN messages with account information
    • Userhost in Names: Support for userhost information in NAMES replies
    • Away Notify: Real-time away status notifications
    • CHGHOST: Support for hostname changes
    • Echo Message: Support for echo-message capability
    • Multi-Prefix: Multiple user mode prefixes display
    • Invite Notify: Real-time invite notifications
    • Monitor: Track user online/offline status

• User Interface

  • Clean, modern UI inspired by AndroIRC
  • Configurable channel tabs (top/bottom/left/right) for navigation
  • Real-time typing indicators: "nick is typing..." with auto-hide (5s timeout)
    • Multi-user support: "Alice and Bob are typing..." / "Alice, Bob, and 2 others are typing..."
    • Fade animations for smooth display
    • Protocol: +typing=active|paused|done tags via TAGMSG
    • Debounced typing detection (active, paused after 3s, done on submit)
  • Smart command autocomplete: Dropdown with up to 8 suggestions
    • Built-in commands (21): /join, /msg, /setname, /bot, /chathistory, /markread, /redact, etc.
    • Aliases (70+): IRC shortcuts, ZNC commands, IRCop helpers, NickServ/ChanServ
    • Command history (last 30 with deduplication)
    • Context-aware scoring (prefers channel commands in channels, query commands in PMs)
    • Touch to autocomplete with auto-space insertion
  • Real-time message display with server-accurate timestamps
  • User list for channels
  • User list dockable to left/right/top/bottom
  • RAW command logging (toggleable) with category filters
  • Grouped, scrollable user list context menu
  • Connection/identity profile management with scrollable lists
  • Header lock button for quick app lock/unlock
  • Picture-in-Picture mode (Android)
  • Smart message routing (RAW messages to server tab only)
  • Landscape and portrait mode support

• IRC Protocol Features

  • Full IRC protocol implementation
  • Automatic nickname fallback (altnick support)
  • Channel joining and leaving
  • Private messaging (queries)
  • Message sending and receiving
  • Server status messages
  • Topic display
  • Mode changes tracking
  • Proper message routing (prevents self-query windows)

• Network Configuration

  • Network settings (name, nickname, altnick, realname, ident)
  • Server settings (hostname, port, SSL/TLS, password)
  • SASL authentication support (fully implemented)
  • Auto-join channels configuration
  • Identity profiles with on-connect commands
  • Persistent storage using AsyncStorage

• Connection Management

  • Automatic reconnection handling
  • Auto-connect favorite servers on startup (multi-network)
  • Connection status indicators
  • Ping measurement display
  • Error handling and reporting
  • Proper CAP negotiation before registration

• Power Features

  • Backup/restore with file export and clipboard copy
  • Connection quality monitoring (lag, rate limiting, flood protection)
  • Bouncer detection and ZNC compatibility
  • Extended command aliases (ZNC + IRCop helpers)
  • DCC file transfers
  • Notifications
  • Firebase Crashlytics integration
  • Google Mobile Ads (with premium ad removal options)
  • In-App Purchases: Remove Ads, Pro Unlimited, Supporter Pro tiers
  • Scripting system with time-based access (watch ads for time or purchase unlimited)

• Framework: React Native 0.83.1
• Language: TypeScript 5.9.3
• Networking: react-native-tcp-socket 6.3.0
• Storage: @react-native-async-storage/async-storage 2.2.0
• UI: React Native components with custom styling
• Encryption: libsodium
• Analytics/Crash: Firebase (Crashlytics, App Check)

AndroidIRCX/
├── src/
│   ├── components/          # UI components
│   │   ├── HeaderBar.tsx    # Top navigation bar
│   │   ├── ChannelTabs.tsx  # Channel/query tabs
│   │   ├── MessageArea.tsx  # Message display area
│   │   ├── MessageInput.tsx # Message input (autocomplete + typing sender)
│   │   ├── TypingIndicator.tsx # Real-time typing display (NEW v1.4.4)
│   │   └── UserList.tsx     # Channel user list
│   ├── services/            # Business logic
│   │   ├── IRCService.ts    # IRC protocol (Full IRCv3 - 18 capabilities)
│   │   ├── MessageReactionsService.ts # Reaction tracking (NEW v1.4.4)
│   │   ├── CommandService.ts # Command aliases (70+) and history
│   │   └── SettingsService.ts # Network/server configuration
│   ├── screens/             # Full-screen views
│   │   ├── NetworksListScreen.tsx
│   │   ├── NetworkSettingsScreen.tsx
│   │   └── ServerSettingsScreen.tsx
│   └── types/               # TypeScript type definitions
├── android/                 # Android native code
├── ios/                     # iOS native code
├── App.tsx                  # Main application component
└── package.json

When disconnected, you can quickly connect by:

• Tapping the network name in the header → connects to that network
• Tapping the dropdown (▼) → "Connect to Default" → connects using default configuration

1. Open Networks List:

   • Tap the dropdown button (▼) in the header
   • Select "Choose Network" (when disconnected) or "Connect Another Network" (when connected)

2. Create New Network:

   • In the Networks List screen, tap the [+] button in the header
   • This opens the Network Settings screen

3. Configure Network Details:

   • Network Name (e.g., "dbase.in.rs") - required
   • Nickname (e.g., "MyNick") - required, set per network
   • Alternative Nickname - fallback if primary nick is taken
   • Real Name (e.g., "John Doe") - required
   • Ident/Username - optional
   • Auto-Join Channels - comma-separated (e.g., "#lobby, #help")
   • SASL PLAIN - account and password for authentication
   • Proxy Settings - Tor/SOCKS5/HTTP support
   • Client Certificate - for SASL EXTERNAL

4. Save the Network:

   • Tap [Save] in the header

1. In the Networks List, find your network

2. Tap [+ Add Server] under that network

3. Configure Server Settings:

   • Hostname (e.g., "irc.example.com") - required
   • Port (default: 6697 for SSL, 6667 for plain) - required
   • Display Name - optional friendly name
   • Use SSL/TLS - recommended, enabled by default
   • Reject Unauthorized Certificates - disabled by default (allows self-signed certs)
   • Server Password - if required by server
   • Favorite Server - mark as preferred server for this network

4. Save the Server:

   • Tap [Save]

Method 1 - Quick Connect (when disconnected):

• Tap the network name in the header

Method 2 - Via Dropdown Menu:

1. Tap the dropdown button (▼) in the header
2. Select:
   • "Connect to Default" - uses default network
   • "Choose Network" - opens Networks List to select a network

Method 3 - From Networks List:

1. Open Networks List (dropdown → "Choose Network")
2. Tap the network name to connect to that network
3. Or tap a specific server under that network to connect to that exact server

When already connected to one network:

• Use dropdown (▼) → "Connect Another Network" to connect to additional networks simultaneously

Setting Initial Nickname (per network):

1. Open Networks List (dropdown → "Choose Network")
2. Find your network and tap [Edit]
3. Edit the "Nickname" field
4. Optionally set "Alternative Nickname" (used if primary is taken)
5. Tap [Save]

Changing Nickname While Connected:

• Type in the message input:

  /nick NewNickname
  

  or use the alias:

  /n NewNickname
  

• This changes your nickname for the current session only
• To make it permanent, edit the network settings as described above

• Hamburger Menu (☰): Opens Settings screen for app configuration (theme, notifications, etc.)
• Dropdown Menu (▼): Access connection menu and Networks List for network/server configuration

Note: Network and server configuration is done through the Dropdown Menu (▼) → Networks List, NOT through the Hamburger Menu (☰).

Connection Sequence (IRCv3 Compliant):

1. TCP Connection: Establish connection via TcpSocketModule (with SSL/TLS if configured)
2. CAP Negotiation Start: Send CAP LS 302 (multi-line capability listing)
3. Server Capabilities: Receive list of available capabilities from server
4. Request Capabilities: Send CAP REQ with 27 supported capabilities
5. Capability Acknowledgment: Receive CAP ACK for enabled capabilities
6. SASL Authentication (if configured):
   • Send AUTHENTICATE PLAIN
   • Exchange SASL credentials
   • Wait for authentication success (903)
7. End CAP Negotiation: Send CAP END
8. IRC Registration: Send NICK and USER commands
9. Connection Complete: Receive 001 (RPL_WELCOME) - registered event
10. Post-Connection:
    • Load saved tabs for network
    • Auto-join configured channels
    • Enable server-time timestamps
    • Activate all negotiated IRCv3 features

• TLS/SSL: Full support for encrypted connections
• App Lock: Biometric/PIN lock with a quick lock action
  • Biometric unlock with improved error handling and retry mechanism
  • PIN unlock with error messages and retry support
  • Auto-lock on background/launch options
• SASL: Complete SASL PLAIN authentication support with proper CAP integration
• Certificate Validation: Configurable certificate checking
• Password Storage: Secure storage for secrets with biometric/PIN support (fallback to AsyncStorage when unavailable)

This client implements the IRC protocol according to:

• RFC 1459 (Internet Relay Chat Protocol) - Full compliance

• RFC 2812 (IRC Client Protocol) - Extended numeric support

• IRCv3 Specifications (Complete implementation - 18 capabilities)

  IRCv3.2 Standard Capabilities (10):

  • CAP Negotiation (Multi-line LS 302 support)
  • SASL Authentication (RFC 4422 - PLAIN mechanism)
  • Message Tags (IRCv3.2)
  • Server-Time (IRCv3.2)
    • BATCH (IRCv3.2) - Message grouping
    • LABELED-RESPONSE (IRCv3.2) - Command correlation
    • CAP-NOTIFY (IRCv3.2) - Dynamic capabilities
    • ACCOUNT-TAG (IRCv3.2) - Account identification
    • SETNAME (IRCv3.2) - Realname changes
    • STANDARD-REPLIES (IRCv3.2) - FAIL/WARN/NOTE

  IRCv3.3 Standard Capabilities (1):

  • MESSAGE-IDS (IRCv3.3) - Unique message identifiers with deduplication

  IRCv3 Additional Standards:

  • BOT (IRCv3.2) - Bot mode marking
  • UTF8ONLY (IRCv3.2) - UTF-8 enforcement
  • EXTENDED-MONITOR (IRCv3.2) - Enhanced user monitoring
  • Account Notify (IRCv3.1)
  • Extended Join (IRCv3.1)
  • Away Notify (IRCv3.1)
  • CHGHOST (IRCv3.2)
  • Echo Message (IRCv3.2)
    • Multi-Prefix (IRCv3.1)
    • Invite Notify (IRCv3.2)

  Draft IRCv3 Capabilities (8):

  • draft/chathistory - Message history retrieval
  • draft/multiline - Multi-line message support
  • draft/read-marker - Read status tracking
  • draft/message-redaction - Message deletion
  • +draft/reply - Threaded conversations
  • +draft/react - Emoji reactions
  • +typing - Real-time typing indicators
  • +draft/channel-context - PM context tracking

Total: 27 capabilities requested, 18 major features implemented with graceful fallbacks

• IRC Setup Guide - Detailed IRC connection setup
• Debug Notes - Troubleshooting guide
• PROJECT - Project explained

Current Version: 1.5.2

Note: This project is in active development. Some features may be incomplete or subject to change.