Basic Navigation
Index View (Mailbox List)
- j or ↓ - Next message
- k or ↑ - Previous message
- Enter - Open message
- q - Quit
- Q - Quit and save
- ? - Help
- : - Command prompt
Message View
- j or ↓ - Next line
- k or ↑ - Previous line
- Space - Next page
- - - Previous page
- q - Return to index
- Enter - Return to index
- i - Return to index
Message Operations
Reading Messages
- Enter - View message
- o - Sort messages
- O - Reverse sort
- s - Save message to mailbox
- S - Save message (with prompt)
- c - Copy message to mailbox
- C - Copy message (with prompt)
- $ - Save message to file
- | - Pipe message to command
- e - Edit message
- v - View attachment
- V - View attachment (with prompt)
Marking Messages
- d - Delete message
- u - Undelete message
- D - Delete tagged messages
- U - Undelete all messages
- * - Tag message
- t - Tag message (alternative)
- T - Tag pattern
- ~ - Invert tags
- ; - Tag prefix
- ^T - Tag thread
- ^U - Untag thread
- ^N - Tag new messages
- ^O - Tag old messages
- ^A - Tag all messages
- ^D - Tag deleted messages
- ^F - Tag flagged messages
- ^L - Tag messages matching pattern
- ^R - Tag read messages
- ^S - Tag subscribed messages
- ^T - Tag thread
- ^U - Tag unread messages
Message Flags
- F - Flag message
- W - Toggle word wrap
- P - Print message
- @ - Toggle subscribed flag
- ! - Toggle important flag
Composing Messages
Starting Composition
- m - Compose new message
- r - Reply to sender
- R - Reply to all
- g - Group reply
- G - Group reply to all
- f - Forward message
- b - Bounce message
- Esc e - Edit message
Composition Mode
- y - Send message
- a - Attach file
- A - Attach file (with prompt)
- r - Edit recipients
- s - Edit subject
- c - Edit CC
- b - Edit BCC
- Esc k - Edit message
- Esc t - Edit To field
- Esc s - Edit Subject field
- Esc c - Edit CC field
- Esc b - Edit BCC field
- Esc a - Attach file
- Esc d - Detach file
- Esc i - Include message
- Esc p - PGP menu
- Esc e - Edit message
- Esc v - View message
- Esc h - Edit headers
- Esc l - Edit list of headers
- Esc q - Abort composition
- Esc y - Send message
Mailbox Operations
Opening Mailboxes
- c - Change mailbox
- o - Open mailbox
- y - Synchronize mailbox
- $ - Save to mailbox
- s - Save to mailbox (with prompt)
Mailbox List
- c - Change mailbox
- o - Open mailbox
- C - Copy mailbox
- d - Delete mailbox
- r - Rename mailbox
- s - Subscribe/Unsubscribe
- u - Unsubscribe
- ^N - Create mailbox
- ^D - Delete mailbox
- ^R - Rename mailbox
Search and Filter
Search
- / - Search forward
- ? - Search backward
- n - Next match
- N - Previous match
- \ - Clear search
- Esc l - Limit to pattern
- Esc L - Show limit
- Esc u - Remove limit
- Esc t - Toggle limit
- ^K - Search for pattern
- ^W - Clear pattern
Patterns
- ~A - All messages
- ~b - Search in body
- ~B - Search in entire message
- ~c - Search in CC
- ~C - Search in entire message
- ~d - Search in date
- ~e - Search in sender
- ~f - Search in from
- ~g - Search in message flags
- ~h - Search in header
- ~l - Search in label
- ~m - Search in message number
- ~n - Search in score
- ~r - Search in date range
- ~s - Search in subject
- ~t - Search in To
- ~u - Search in user
- ~v - Search in variable
- ~x - Search in references
- ~y - Search in X-Label
- ~z - Search in size
- ~= - Search in pattern
- ~! - Negate pattern
- ~| - OR pattern
- ~& - AND pattern
Threading
- ^T - Toggle thread display
- ^U - Toggle thread display (alternative)
- Esc u - Unthread
- Esc t - Thread
- ^N - Collapse thread
- ^E - Expand thread
- ^O - Collapse all threads
- ^P - Expand all threads
PGP Operations
- Esc p - PGP menu
- ^K - Check for PGP keys
- ^E - Encrypt message
- ^S - Sign message
- ^V - Verify signature
- ^D - Decrypt message
Configuration
Config File Location
- ~/.config/neomutt/neomuttrc - Main config
- ~/.config/neomutt/muttrc - Alternative config
- ~/.muttrc - Legacy config location
Example Key Bindings
Customize key bindings in your config:
# Custom navigation bindings
bind index <down> next-entry
bind index <up> previous-entry
bind pager <down> next-line
bind pager <up> previous-line
bind pager <space> next-page
bind pager - previous-page
# Custom message operations
bind index d delete-message
bind index u undelete-message
bind index * tag-message
bind index t tag-message
Common Settings
# Accounts
set from = "user@example.com"
set realname = "Your Name"
set imap_user = "user@example.com"
set imap_pass = "password"
# IMAP
set folder = "imaps://imap.example.com:993"
set spoolfile = "+INBOX"
set postponed = "+Drafts"
set record = "+Sent"
# Mailboxes
mailboxes = +INBOX
set mbox_type = Maildir
# Display
set sort = date
set sort_aux = date
set sort_re = date
set pager_index_lines = 10
set pager_context = 3
set pager_stop = yes
# Composition
set editor = "nvim"
set sendmail = "/usr/bin/msmtp"
set sendmail_wait = 0
set copy = yes
set include = yes
set forward_format = "Fwd: %s"
# Headers
ignore *
unignore from date subject to cc
hdr_order from to cc date subject
# Colors
color normal white black
color hdrdefault brightgreen black
color quoted green black
color signature brightgreen black
color indicator brightyellow red
color tree brightmagenta black
color status brightyellow black
color tilde brightcyan black
color attachment brightyellow black
color markers brightred black
color search brightwhite black
color error red black
color message brightcyan black
color prompt brightyellow black
color index brightcyan black ~N
color index brightgreen black ~F
color index brightred black ~D
# Key Bindings
bind index <down> next-entry
bind index <up> previous-entry
bind pager <down> next-line
bind pager <up> previous-line
bind pager <space> next-page
bind pager - previous-page
Tips
- Use :set to see all settings
- Use :unset to unset a setting
- Use :source to reload config
- Use :exec to execute command
- Use :push to push command
- Use :shell to execute shell command
- Use :mailbox to change mailbox
- Use :quit to quit
- Use :save to save message
- Use :delete to delete message
- Use :undelete to undelete message
- Use :tag to tag message
- Use :untag to untag message
- Use :limit to limit messages
- Use :unlimit to remove limit