Skip to content
trufaePublic

About

Native Gnome DeltaChat client

Topics

Resources

Accessibility

Stars

68 stars

Watchers

2 watching

Forks

Repository files navigation

Parla logo

Parla

A native Delta Chat client for GNOME — decentralized, encrypted chat over email.

Website · Download · Haiku native preview

CI Downloads License GTK4 + libadwaita Vala


Parla is a lightweight, native Vala + GTK4 + libadwaita app that talks to deltachat-rpc-server over JSON-RPC. It is designed for GNOME and follows its desktop conventions, while also running on Linux, Windows, and macOS.

Parla's welcome screen, showing the chat list and an adaptive split-view conversation area

Get Parla and start chatting

Download a package from the Parla releases page. It provides Linux packages (.deb, Flatpak, and AppImage), macOS .dmg images, and a Windows .zip archive. On Windows, extract the archive and start parla.exe; on macOS, open the disk image and move Parla to Applications.

On first launch, follow the profile setup to choose a display name and a chatmail relay. The relay creates an email address and password for you, while Parla generates your encryption keys on your device. You can also redeem an invitation code or import a second device instead. Then use New chat or New group to start talking and share an invite link or QR code with others.

Want to build it yourself? See Build below.

Explore the Parla website for screenshots, features and platform downloads. A separate native Haiku client is available as a development preview. The website's source and deployment instructions are in docs/website.md.

Highlights

  • Stickers that are yours to keep — send stickers, collect received stickers, and organize them in local packs. Download the starter packs and follow the installation guide. Animated stickers can be paused or disabled when you want to save resources.
  • A useful media gallery — each chat has a browsable gallery for images, stickers, files, audio, video, and shared Webxdc apps, with quick access back to the original message.
  • Webxdc mini-apps — run and manage offline web apps shared in chats. This is experimental and available on supported Linux, macOS, and Windows builds; see Webxdc apps for security and platform details.
  • Choose the conversation layout — use familiar bubbles, compact IRC-style lines, or workspace rows. The split view adapts to narrow and phone-sized windows, where the sidebar becomes a single-pane navigation view.
  • Keyboard-first when you want it — quickly switch chats, create conversations, search, navigate, and focus the composer without leaving the keyboard.
  • Encrypted account backups — create, check, and restore password-protected ZIP backups from Settings. Restore keeps the previous accounts folder. See backup behavior and current limits.
  • Desktop-aware — configurable notifications, a tray icon for keeping Parla available in the background, and support for multiple accounts.
  • Screen-reader support — works with Orca on Linux; Windows and macOS builds ship GTK with the AccessKit backend so NVDA, JAWS and VoiceOver can read the interface. See docs/accessibility.md.

More features

Messaging

  • Rich compose bar — multi-line text, file attachments via picker or drag-and-drop, paste images or files straight from the clipboard. Drag downloaded pictures or attachments onto a contact in the sidebar to forward them immediately, including their caption. Drop onto the composer to prepare an attachment, or into Finder/Files to copy it.
  • Reply, edit, delete, forward — full message actions via right-click; Delete for Me syncs to linked devices, while Delete for Everyone requests deletion of eligible sent messages from other participants too. Leave Group keeps the history; Leave and Delete removes it for your profile.
  • Emoji reactions — quick-pick 👍 ❤️ 😂 😮 😢 👎 shown as badges on the message. Select your emoji again or choose Remove reaction in the message menu to un-react.
  • Pinned messages — pin any message in a chat; a pinned-messages bar at the top of the conversation lets you jump back to them.
  • Reply previews — quoted sender and text preview (capped at 3 lines) above the compose entry and inside bubbles.
  • Inline image previews with a full-screen viewer (click to open, right-click to save, Escape to close).
  • Sticker packs — send stickers, collect received ones, and manage your own local packs.
  • Voice-message transcription — transcribe downloaded voice messages locally with the Whisper command-line tool when it is installed; results stay in memory and are not sent or saved with the message.
  • Optional Markdown rendering — bold, italic, strikethrough, inline code, fenced code blocks, headings, tables, and auto-linkified URLs.
  • In-chat search (Ctrl+F, Command+F on macOS) across the full history, with previous/next matches and scroll restoration.
  • Sidebar search finds chats and messages together, including archived conversations, in the selected profile.
  • Save attachments to disk from the message context menu.
  • Contact cards (VCF) — share contacts from the attachment menu, a contact's details, or your profile. Preview names and avatars in messages, the composer, and the Files gallery. Open a VCF with Parla or choose New Chat → Open vCard… to review, save, or share it. Standard vCards without email addresses are supported; cards with email addresses also offer import and chat actions. Right-click a card in a conversation or the Files gallery to save it or open it with the system app. Delta Chat handles contact identity and public encryption keys; previewing a card does not import it. Files may contain multiple contacts (up to 4 MiB per file).

Chats

  • Adaptive split-view sidebar + conversation, collapsing to a single pane on narrow windows with a back button. Swipe right anywhere in the conversation, or use a two-finger touchpad swipe, to return to chats (including Phosh and Android).
  • Chat list with avatars, unread dots and badges, last-message preview, smart timestamps (time / weekday / date), pinned indicator and muted styling.
  • Pin, mute, delete chats from the sidebar context menu; view chat info (members, avatar, type) in a dedicated dialog.
  • Contact requests surfaced with their own badge.
  • Sidebar search to filter chats by name.
  • Quick switcher fuzzy chat search, Enter to open the top match.
  • New 1:1 chat via contact picker, and new group with name, avatar and member selection.
  • Per-chat media gallery for images, stickers, files, audio, video, and Webxdc attachments.

Accounts & profile

  • Private Parla account store in Parla's XDG data directory.
  • Auto-discovery of standalone deltachat-rpc-server from the Parla bundle, distro packages, $PATH, ~/.local/bin, and ~/.cargo/bin.
  • Multi-account switching from the settings dialog.
  • Profile dialog to edit the display name, bio, and profile picture.
  • End-to-end encryption via Autocrypt, handled by the Delta Chat core.

Settings

  • Double-click or Enter on a focused message: Reply / React ❤️ / React 👍 / Show Contact Details / Show Message Menu / Do Nothing, configured by the double-click action in Settings.
  • Choose whether Markdown is rendered, stripped, or shown as-is.
  • Toggle Shift+Enter vs Enter to send.
  • Toggle desktop notifications for incoming messages when the window is unfocused.
  • Choose bubble, compact IRC, or workspace message layouts, and configure the tray icon for background use. On macOS, closing the window keeps Parla running with its Dock icon always visible, with or without the menu bar icon.
  • Choose the JSON-RPC server source: Parla/system auto-discovery or a custom binary.

Keyboard shortcuts

Action Other platforms macOS
New chat Ctrl+N Command+N
New group Ctrl+G Command+G
New channel Ctrl+Shift+G Command+Shift+G
Quick chat switcher Ctrl+K Command+K
Account menu Ctrl+Shift+A Command+Shift+A
Focus next chat (Enter to open) Ctrl+Page Down Command+Page Down
Focus previous chat (Enter to open) Ctrl+Page Up Command+Page Up
Search in conversation Ctrl+F Command+F
Search chats and messages Ctrl+Shift+F Command+Shift+F
Open chat info Ctrl+I Command+I
Open the chat focused in the list Enter Enter
Run the configured message action (Reply by default) Enter Enter
Menu for the focused message Shift+F10 or Menu Shift+F10
Select or deselect the focused message Space Space
Focus selection actions while selecting messages Ctrl+Tab Ctrl+Tab
Focus compose entry Esc Esc
Refresh Ctrl+R Command+R
Toggle sidebar Ctrl+S Command+S
Compact sidebar Ctrl+Shift+S Command+Shift+S
Settings Ctrl+, Command+,
Close window Ctrl+W Command+W
Quit Ctrl+Q Command+Q
Close dialog / viewer / search Esc Esc

To select multiple messages using the keyboard:

  1. Open a conversation, focus its message list, and use Up / Down to reach the first message you want to select.
  2. Press Space. Selection mode opens and that message's checkbox is focused and checked. Alternatively, press Shift+F10 (or Menu), choose Select Messages with the arrow keys, and press Enter.
  3. Use Up / Down to move between message checkboxes. Press Space to select or deselect each message; moving alone does not change selection. Screen readers announce the message and its checked state.
  4. Press Ctrl+Tab to reach Delete…, then Tab for Forward or Cancel, and Enter to activate the chosen action. With no messages selected, only Cancel is enabled. Delete still asks for confirmation.
  5. Press Esc or activate Cancel to clear selection and return to the composer (or the message list for an unaccepted contact request). If a menu, dialog, or conversation search is open, Esc closes it first.

Build

# Install dependencies (Ubuntu; Webxdc is enabled by default)
sudo apt install valac meson libgtk-4-dev libadwaita-1-dev libjson-glib-dev \
  libwebkitgtk-6.0-dev libseccomp-dev bubblewrap

# Install the RPC backend for source builds
pip install deltachat-rpc-server
# Or: cargo install --git https://github.com/chatmail/core/ deltachat-rpc-server

# Build & run
make run

On GNOME, install the desktop entry with sudo make install so the app switcher can resolve Parla's name and icon, especially on Wayland.

The desktop build also produces parla-cli, with a line-oriented REPL and a styled, tabbed terminal interface on Linux and macOS. For a CLI-only build, install Vala, Meson, a C compiler, GLib/GIO and JSON-GLib development files, then run:

meson setup builddir-cli -Dgui=false
meson compile -C builddir-cli
./builddir-cli/parla-cli

This build does not require GTK, libadwaita or WebKit. On macOS it also uses the system Foundation framework. Use -Dcli=false for a GUI-only build. Interactive terminals open the TUI with a welcome in the Parla tab, connection activity, notifications, and a summary of unread conversations. Type /help for commands and keyboard shortcuts. Click contacts or tabs to select them, use the wheel to scroll, or press Ctrl-G and navigate contacts with j/k or arrows. Contacts has its own permanent tab, with aligned pin, unread, time and grey message-preview columns. Use g to group chats, a to sort alphabetically or by activity, and p to pin/unpin. Its badge counts unread messages from chats without open tabs. Esc+number selects a tab; Esc+x or middle-click closes it. Ctrl-W deletes a word, Ctrl-B/F pages through messages, and Ctrl-P/N recalls shared input history. Tab completes /commands and @members. Command output goes to the Parla tab. /account switches profiles, /query name|address opens or starts a direct chat; /query alone closes the current tab. /invite displays a QR/link. Click a message for /reply, /react or /unreact; /reply alone opens a keyboard selector. /reply text defaults to the latest incoming message, and /reply @user text chooses that user's latest message. Image/file attachments provide clickable terminal hyperlinks to local files. /theme lists default, ocean, forest, ember, ansi, and mono; /theme ocean selects one. /color ROLE=COLOR saves an override, and /color ROLE=inherit clears it. /theme reset removes saved colors and restores the shipped defaults. Layout preferences live in parla/terminal.ini and colors in parla/colors.ini under the user config directory; both persist across runs. Piped input uses the line-oriented REPL. The REPL supports accounts, account ID, chats, messages CHAT_ID, send CHAT_ID TEXT, settings, updates, rpc METHOD [JSON_ARRAY], and quit. Type help for details; EOF also exits.

Both frontends link the same backend and use the same settings, account store, core discovery and update policy. Close the GUI before starting parla-cli over SSH; the core's account lock prevents concurrent access. No import or copy is needed. Configure new profiles in the GUI for now. The plain REPL checks for updates but does not install them, and its conversation refreshes are explicit commands. The TUI refreshes on core events and provides a Contacts tab, tabs, Markdown history, a status line and multiline drafts. It uses the independent Vala terminal library, which caches layout and writes only changed terminal cells. See the shared backend API.

AES-256 backups optionally use libzip 1.7+: install its development package before building to enable the adapter, and its runtime library to use backups. Parla builds and starts without it. Ordinary zip/unzip only support the separate legacy ZipCrypto store format.

Other distros

Fedora: sudo dnf install vala meson gtk4-devel libadwaita-devel json-glib-devel

Arch: sudo pacman -S vala meson gtk4 libadwaita json-glib

Flatpak: flatpak install io.github.trufae.Parla.flatpak

AppImage: make appimage

Android (12+, arm64, experimental): CI builds an APK using the native GTK Android backend. See Android build and release instructions for installation, signing setup and current foreground-client limitations.

Sailfish OS (5.1.0.11 / aarch64, experimental): harbour-parla RPMs use the shared GTK4/libadwaita runtime from sailfishos-gnome. Install the runtime alongside Parla; see dist/sailfishos/README.md.

macOS
brew install meson ninja vala pkgconf gtk4 libadwaita json-glib librsvg webp-pixbuf-loader glib-networking adwaita-icon-theme

# Install the RPC backend for source builds.
pip install deltachat-rpc-server
# Or: cargo install --git https://github.com/chatmail/core/ deltachat-rpc-server

make run   # builds and runs dist/macos/Parla.app
make app   # creates dist/macos/Parla.app
make macos # creates parla-<arch>-<version>.zip

make app bundles Homebrew GTK/libadwaita libraries. The RPC backend is not bundled by default; set PARLA_BUNDLE_RPC_SERVER=/absolute/path/to/deltachat-rpc-server only for a local bundle that should include a specific backend binary.

Windows

Build inside an MSYS2 UCRT64 shell:

pacman -S zip mingw-w64-ucrt-x86_64-gcc mingw-w64-ucrt-x86_64-meson \
  mingw-w64-ucrt-x86_64-vala mingw-w64-ucrt-x86_64-gtk4 \
  mingw-w64-ucrt-x86_64-libadwaita mingw-w64-ucrt-x86_64-json-glib \
  mingw-w64-ucrt-x86_64-glib-networking mingw-w64-ucrt-x86_64-adwaita-icon-theme \
  mingw-w64-ucrt-x86_64-librsvg mingw-w64-ucrt-x86_64-webp-pixbuf-loader \
  mingw-w64-ucrt-x86_64-ntldd

bash scripts/windows/bundle.sh   # default build, system Edge WebView2 backend
WITH_WEBXDC=0 bash scripts/windows/bundle.sh  # build without Webxdc

The Webxdc build fetches a pinned official Microsoft WebView2 SDK package for its C/C++ headers and small loader DLL. It does not download or bundle Edge: at runtime it uses the installed Evergreen WebView2 Runtime.

The script builds with meson and bundles the GTK/libadwaita runtime (DLLs, GSettings schemas, icon themes, pixbuf loaders, TLS module) into a self-contained folder, then zips it. CI publishes this zip for every release.

See docs/rpc-server.md for how Parla finds the JSON-RPC server and how to package it for Flatpak or distro packages.

Package maintainers can disable startup update checks with -Dupdate_checks=false in Meson. At runtime, PARLA_CHECK_UPDATES=0 parla disables both checks; PARLA_CHECK_UPDATES=1 parla enables them for that launch. See startup update checks for precedence and fixed Core binaries.

Parla is being localized with GNU gettext. See docs/locales.md for how to run Parla in another language and how to contribute translations.

Run ./version.sh to print Parla's current version, or ./version.sh X.Y.Z to update Meson and the RPM spec, then open data/io.github.trufae.Parla.appdata.xml in $EDITOR (default: vi) to edit the release version, notes, and date.

Webxdc apps (experimental)

Webxdc apps are small offline web apps attached to Delta Chat messages. Support is experimental and enabled at build time by default. Embedding a browser engine adds a large dependency and a significant attack surface, so it can be disabled at runtime under Settings → Advanced → In-Chat Apps.

That settings section also controls Internet access, WebAssembly, WebGL, web developer tools, and WebKitGTK hardware acceleration for mini-apps. These capabilities are disabled by default, and a Restrict button restores all safe defaults. The Internet Access setting explains that apps can reveal an IP address or app data to websites; standard Webxdc apps are expected to remain offline; the macOS WebGL restriction is best-effort because WKWebView offers no public hard-disable API.

Platform support currently is:

  • Linux: WebKitGTK 6.0. Supported by native and Flatpak builds. The AppImage does not bundle WebKitGTK and therefore has no Webxdc support.
  • macOS: the system WebKit framework; no extra web-engine package is needed.
  • Windows: the installed Evergreen WebView2 Runtime, through the native Win32 API. The Parla ZIP carries Microsoft's small SDK loader but no browser runtime. Windows 11 includes the Evergreen Runtime; Windows 10 systems without it must install Microsoft's Evergreen Runtime once.

To build and run it from the source tree:

# Ubuntu/Debian build dependency
sudo apt install libwebkitgtk-6.0-dev libseccomp-dev bubblewrap

make run
# Or with Meson directly:
meson setup builddir
meson compile -C builddir

To build without Webxdc, explicitly pass WITH_WEBXDC=0 to Make or -Dwebxdc=false to Meson.

Screen-reader support is on by default; meson setup builddir -Da11y=false produces a build that starts GTK without an assistive-technology backend and leaves out Parla's own accessible labels and states (see docs/accessibility.md).

Parla's stock symbolic icons come from adwaita-icon-theme (a GTK4 dependency). On desktops whose icon theme does not inherit Adwaita (XFCE, LXQt, ...) Parla adds it at runtime as the last fallback after the active theme and hicolor, so Breeze, Papirus, etc. still take precedence. For builds that cannot rely on an installed Adwaita, make BUNDLE_ICONS=1 or meson setup builddir -Dbundle_icons=true compiles the needed SVGs into the binary instead.

On Windows, use the bundle command above. For a direct Meson build, extract the official Microsoft.Web.WebView2 NuGet package and pass its root as -Dwebview2_sdk=/path/to/package.

Each Webxdc runs in a separate native helper behind a bounded IPC interface. The helper has no account/core connection. Linux uses bubblewrap namespaces and seccomp, macOS uses a signed App Sandbox XPC service, and Windows uses a fresh AppContainer plus a Job Object. A failed sandbox launch closes the app. Linux requires Wayland: directly exposing X11 would let a compromised helper inspect or control other applications. Flatpak uses a restricted flatpak-spawn --sandbox child. On native Linux, both the helper sandbox and WebKitGTK's renderer sandbox require unprivileged user namespaces. Ubuntu 24.04 and newer may restrict those namespaces through AppArmor; without an application policy WebKitGTK can fail with bwrap: setting up uid map: Permission denied.

A native Webxdc install handles this automatically. The generated policy is attached to the actual installed binary path, is installed only when AppArmor is active, and is loaded as part of the install:

sudo make install

Staged native package installs include the profile without loading it on the build host; package lifecycle scripts load it only where the Ubuntu restriction is active. Direct installs on systems without that restriction do not install the policy. Running make run directly from a build directory is not covered by the installed-binary policy on restricted Ubuntu systems; install the binary first and run the installed parla executable. Failed helper startup is reported without an unsandboxed fallback. Flatpak uses its own sandbox and does not install a host AppArmor profile.

On macOS, run the signed .app produced by make run or the bundle scripts; the build-directory executable has no embedded XPC service. WKWebView requires the network-client entitlement even for local HTML, so macOS offline mode uses browser request policies rather than native network denial. See the documented platform boundaries.

See docs/webxdc.md for the implementation, security boundaries, and currently exposed JavaScript API.

Parla is single-instance and can run as a background service on Linux: parla --background starts it without a window (e.g. for session autostart) and parla --show presents the window of the running instance. See docs/background.md.

Contributing

Early-stage project — contributions welcome! Open areas: Flatpak packaging, theming, richer notifications, accessibility polish, and more message types.

License

GPLv3 — see LICENSE.

Built on Delta Chat, GNOME and libadwaita.

About

Native Gnome DeltaChat client

Topics

Resources

Accessibility

Stars

68 stars

Watchers

2 watching

Forks

Releases

Packages

Contributors

Languages