Configuration

Make conversations comfortable to read, choose how you share files, and move your network configuration between devices.

Appearance

Appearance settings are grouped by what they change. Settings search can jump straight to a control.

Theme

Choose a curated editor or terminal palette in Theme, or choose System default and enable Use wallpaper colors for Material You colors from your phone wallpaper on Android 12 and newer. This is separate from your chat wallpaper. Match device light/dark mode switches between a theme's light and dark variants when both are available.

Theme families include Ayu, Catppuccin, Dracula, Everforest, Gruvbox, Kanagawa, Modus, Monokai, Nord, One Dark, Rosé Pine, Solarized, Tokyo Night, and Zenburn. See the full palette variants and attribution table.

Every dark palette can use True black backgrounds. This keeps the palette's accents while making the canvas black and using subtly palette-tinted near-black surfaces. The choice is remembered when you switch to a light theme and takes effect again when you return to a dark theme.

Match text to theme uses the theme's text colors throughout the app and chats instead of near-black or near-white text. Palette colors are adapted to Material 3 roles and adjusted where needed for readable contrast.

Text & font

Font chooses the typeface. App text size changes menus, settings, navigation, and controls; Chat text size changes messages, message input, replies, and suggestions.

Chat list

Chat list folders chooses expandable inline folders or tabs. With tabs selected, Include folder chats in All controls whether chats assigned to folders also appear in the All tab.

Messages & input

Choose Message layout and Message input layout, then adjust Show message times, Time format, and Message spacing. The inline preview reflects the selected message layout.

Message background opacity and Message background blur are beside each other inside Message layout, and work in Comfortable, Compact, and Two-line, with or without nickname backgrounds. Opacity defaults to 100%; 0% removes ordinary tint without fading text, avatars, or media. Blur is independent: it defaults to Off (0), and its 0–100 intensity maps linearly to 0–32dp. Lower opacity reveals more blur; zero tint still blurs the wallpaper, while opaque tint covers it. Only wallpaper is blurred, never foreground content. Native blur requires Android 12 or newer; Android 8–11 keep the existing unblurred tint. Incoming opaque mention highlights and semantic rails remain visible, and arbitrary wallpaper contrast is not guaranteed. A chat's overflow Message layout menu can override opacity and blur independently of layout and each other; Use global opacity and Use global blur restore their own inheritance without resetting the other choices.

Nicknames & avatars

Colored nicknames controls sender-name colors. Choose a Nickname color palette, assign Custom nickname colors to individual people, or change Avatar style. Palette selection requires Colored nicknames to be enabled.

Nickname backgrounds is on by default and adds a faint sender-colored wash to Compact and Two-line message rows. Turn it off for the normal chat backing; nickname and avatar colors, friend and mention highlights, ACTION messages, and Comfortable bubbles are unchanged. Wallpaper contrast and dimming still apply.

Message bubbles

Bubble shape and Chat shadows apply to the Comfortable message layout, shown in this section's preview. Message and input colors sets sent and received backgrounds for Comfortable messages; the message input uses the received color in every layout.

Chat wallpaper

Choose a chat background or import an image, then adjust the available wallpaper options. Chat wallpaper does not change the phone wallpaper colors used by the Theme section.

App icon

Choose the icon shown in your device's app launcher.

Chat and uploads

Choose a conversation layout and adjust chat behavior, previews, and replies. The chat view includes a unified chat list, grouped bubbles, day separators, event pills, inline images, and link previews. The composer supports nick autocomplete, replies, reactions, typing indicators, and slash commands; IRCv3 features depend on what your server supports.

The attachment chooser can share a photo, a file, your current draft as a link, or a new text paste. Review the destination and its privacy and expiry information before uploading. Public uploads must not contain sensitive information; even a secret link can be opened by anyone who has it. A Soju file host uses the connected chat's authenticated network file service, with retention set by that server.

See the documented chat features. Chat preferences and upload backend configuration are included in configuration exports, but uploaded files and upload history are not transferred by a configuration backup.

Configuration backups

Configuration backups do not include messages, drafts, or chat history. A .motdconfig file moves configuration between devices; it is not a backup of your conversations.

Exports include direct networks, bouncer roots and children, their relationships and ordering, connection and identity settings, TLS and proxy configuration, and user-facing preferences such as appearance, chat behavior, replies, upload backends, avatars, and delivery mode.

Choose an export mode

• Without credentials: excludes passwords and private connection links. This configuration-only JSON export is not encrypted.
• Encrypted with credentials: includes saved passwords and private connection links in a password-encrypted file. The payload uses AES-256-GCM encryption with a key derived from the export password. You need that password to import it.

Neither mode transfers Android KeyChain client certificates. Messages, buffers, read markers, drafts, cached previews, upload history and deletion tokens, generated push endpoints and keypairs, certificate pins, STS policy state, diagnostics, history cursors, and other runtime or cache state are excluded.

Choose an import mode carefully

• Merge updates matching networks in place and keeps networks that exist only on the destination device.
• Replace updates matching networks, adds missing networks, and deletes local-only network trees together with their local history. The configuration file does not contain that history to restore later.

The complete document is validated before local state changes. Unsupported versions, invalid configuration, wrong passwords, damaged files, or tampered encrypted data fail without applying the backup.

A credentials-excluded import keeps existing local credentials on matching networks. New networks that need an omitted SASL password, server password, or VLESS link remain disconnected until you provide it. A network that used a client certificate is also imported disconnected: select a certificate on the destination device before connecting.

Read the full configuration backup format specification for the exact included fields, encryption format, exclusions, and import rules.