Skip to content
HiFiveJazzPublic

About

Jerc is a batteries-included terminal mail app, acting as a successor to aerc!

Topics

Resources

Contributing

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

Jerc Logo

Jerc

A keyboard-driven terminal email client, written in Rust, inspired by aerc.

Getting Started · Install · Keybindings · Configuration · Contributing


Jerc mail browser showing Vim-style navigation and multiple mail accounts

Features

Features Highlights
Online and Offline Mail IMAP and Maildir accounts, multiple mailboxes, background refresh, and local-first cached reading.
Attachment Previews Preview attachments like PDFs, images, and more!
Keyboard First Vim motions and relative line numbers, smooth scrolling, searchable ? help, and mouse support.
Bulk Actions Visual selection, persistent marks, bulk actions, archive, spam handling, and in-mailbox filtering.
Rich Reading HTML and plain-text views, tables, links, attachments, Git mailing list integrations, and optional inline images.
Natural Composing Modal editing, reply options, recipient auto-suggestions, attachment picker, drafts, and send preview.
Customization Multiple accounts, hot-swappable themes, adjustable panels, and rounded or square borders!

See configuration for the relevant controls.

Getting Started

Installation

Jerc is available for Linux, macOS, Windows, or Universal. We also offer multiple prebuilt binaries and package-manager options. See Installation Guide.

Essential Keys

Key Action
j / k Move through messages
J / K Change mailbox
Alt n / Alt p Next/Previous Account
Enter Open message
/ Search/filter
Space Mark message
v / V Visual selection
a / d Archive / confirm deletion
c / r / f Compose / reply / forward
? Search keybindings for current view

The full reference lives in Keybindings. Press ? inside Jerc for a searchable, context-aware shortcut palette.

Documentation

  • Keybindings — mail, reader, Compose, Contacts, attachments, and picker.
  • Configuration — accounts, privacy defaults, themes, layouts, and storage paths.
  • Contacts — contacts management and recipient autocomplete.
  • Architecture — rendering, backend workers, state, and performance invariants.
  • Contributing — development workflow and tests.

Project Status

Warning

Jerc is under active development. IMAP and Maildir reading, SMTP sending, drafts, and the UI are implemented and somewhat finalized. IMAP IDLE synchronization is supported with polling fallback; full conversation threading and server-backed search are planned. Expect breaking changes before 1.0.

License

Copyright (C) 2026 Jerc contributors.

Jerc's original source code is licensed under the GNU General Public License, version 3 only (GPL-3.0-only). The bundled COSMIC notification sound is separately licensed under Creative Commons Attribution-ShareAlike 4.0. Other third-party material retains its respective license and notices.

About

Jerc is a batteries-included terminal mail app, acting as a successor to aerc!

Topics

Resources

Contributing

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages