How m66b/fairemail works
FairEmail is an Android email client: people configure accounts, synchronize and read messages, then compose and send replies through standard mail protocols. The README also describes offline use, push, search, filtering, privacy protections, encryption and convenience features. The excerpts show EmailService configuring mail protocols and JavaMail’s session/provider model, but do not show the app’s activity-to-service routing or most feature implementations; those relationships are therefore documented only where the README supports them.
Main entry points: EmailService.java Email service · ActivityMain.java Mailbox UI · ActivityView.java Message view · IMAPStore.java IMAP client
Components 25
App experience
- Mailbox UI
app/src/main/java/eu/faircode/email/ActivityMain.java - Message view
app/src/main/java/eu/faircode/email/ActivityView.java - Compose message
app/src/main/java/eu/faircode/email/ActivityCompose.java - Account setup
app/src/main/java/eu/faircode/email/ActivitySetup.java
Mail synchronization
- Email service
app/src/main/java/eu/faircode/email/EmailService.java - Offline operations
app/src/main/java/eu/faircode/email - IMAP IDLE
app/src/main/java/com/sun/mail/imap/IdleManager.java
Mail protocols
- Mail session
app/src/main/java/javax/mail/Session.java - Mail service API
app/src/main/java/javax/mail/Service.java - Mail store API
app/src/main/java/javax/mail/Store.java - Mail folders
app/src/main/java/javax/mail/Folder.java - Mail messages
app/src/main/java/javax/mail/Message.java - IMAP client
app/src/main/java/com/sun/mail/imap/IMAPStore.java - IMAP folders
app/src/main/java/com/sun/mail/imap/IMAPFolder.java - IMAP protocol
app/src/main/java/com/sun/mail/imap/protocol/IMAPProtocol.java - SMTP transport
app/src/main/java/com/sun/mail/smtp/SMTPTransport.java
Mail features
- Search and indexing
app/src/main/java/eu/faircode/email/ActivitySearch.java - Filter rules
app/src/main/java/eu/faircode/email/AdapterRule.java - Safe message display
app/src/main/java/eu/faircode/email/ActivityView.java - OpenPGP support
openpgp-api/src/main/java/org/openintents/openpgp/util/OpenPgpApi.java - S/MIME support
app/src/main/java/eu/faircode/email - Push notifications
app/src/main/java/eu/faircode/email - Message list widget
app/src/main/java/eu/faircode/email/ActivityWidget.java
Other components
- Email user
- Email provider
Connections 24
- Email user → Account setup: configures account
- Email user → Mailbox UI: reads mail
- Email user → Compose message: writes mail
- Account setup → Email service: configures mail
- Email service → Mail session: configures session
app/src/main/java/eu/faircode/email/EmailService.java - Mail session → Mail service API: selects providers
app/src/main/java/javax/mail/Session.java - Mail service API → Mail store API: provides store
- Email service → IMAP client: uses IMAP
app/src/main/java/eu/faircode/email/EmailService.java - Email service → SMTP transport: uses SMTP
app/src/main/java/eu/faircode/email/EmailService.java - IMAP client → IMAP folders: opens folders
app/src/main/java/com/sun/mail/imap/IMAPFolder.java - IMAP folders → IMAP protocol: issues commands
app/src/main/java/com/sun/mail/imap/IMAPFolder.java - IMAP client → Email provider: synchronizes mail
- SMTP transport → Email provider: sends mail
- Email service → IMAP IDLE: supports push
- Mailbox UI → Message view: opens messages
- Message view → Safe message display: displays safely
- Compose message → SMTP transport: sends message
- Email service → Offline operations: supports offline use
app/src/main/java/eu/faircode/email/EmailService.java - Mailbox UI → Search and indexing: supports search
- Email service → Filter rules: supports filtering
- Message view → OpenPGP support: decrypts messages
- Message view → S/MIME support: supports encryption
- Mailbox UI → Push notifications: receives alerts
- Mailbox UI → Message list widget: offers widget