You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

980 lines
21 KiB

2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
  1. .\" meli - meli.conf.5
  2. .\"
  3. .\" Copyright 2017-2019 Manos Pitsidianakis
  4. .\"
  5. .\" This file is part of meli.
  6. .\"
  7. .\" meli is free software: you can redistribute it and/or modify
  8. .\" it under the terms of the GNU General Public License as published by
  9. .\" the Free Software Foundation, either version 3 of the License, or
  10. .\" (at your option) any later version.
  11. .\"
  12. .\" meli is distributed in the hope that it will be useful,
  13. .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
  14. .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  15. .\" GNU General Public License for more details.
  16. .\"
  17. .\" You should have received a copy of the GNU General Public License
  18. .\" along with meli. If not, see <http://www.gnu.org/licenses/>.
  19. .\"
  20. .Dd September 16, 2019
  21. .Dt MELI.CONF 5
  22. .Os
  23. .Sh NAME
  24. .Nm meli.conf
  25. .Nd configuration file for the Meli Mail User Agent
  26. .Sh SYNOPSIS
  27. .Pa $XDG_CONFIG_HOME/meli/config.toml
  28. .Sh DESCRIPTION
  29. Configuration for meli is written in TOML which has a few things to consider (quoting the spec):
  30. .Pp
  31. .Bl -bullet -compact
  32. .It
  33. TOML is case sensitive.
  34. .It
  35. A TOML file must be a valid UTF-8 encoded Unicode document.
  36. .It
  37. Whitespace means tab (0x09) or space (0x20).
  38. .It
  39. Newline means LF (0x0A) or CRLF (0x0D 0x0A).
  40. .El
  41. .Pp
  42. Refer to TOML documentation for valid TOML syntax.
  43. .sp
  44. Though not part of TOML syntax,
  45. .Nm
  46. can have nested configuration files by using the following
  47. .Xr m4 1
  48. include macro:
  49. .Dl include(\&"/path/to/file\&")
  50. .Sh SECTIONS
  51. The top level sections of the config are:
  52. .Bl -bullet -compact
  53. .It
  54. accounts
  55. .It
  56. shortcuts
  57. .It
  58. notifications
  59. .It
  60. pager
  61. .It
  62. listing
  63. .It
  64. composing
  65. .It
  66. pgp
  67. .It
  68. terminal
  69. .It
  70. log
  71. .El
  72. .Sh EXAMPLES
  73. example configuration
  74. .sp
  75. .Bd -literal
  76. # Setting up a Maildir account
  77. [accounts.account-name]
  78. root_mailbox = "/path/to/root/folder"
  79. format = "Maildir"
  80. index_style = "Compact"
  81. identity="email@address.tld"
  82. subscribed_mailboxes = ["folder", "folder/Sent"] # or [ "*", ] for all mailboxes
  83. display_name = "Name"
  84. # Set mailbox-specific settings
  85. [accounts.account-name.mailboxes]
  86. "INBOX" = { alias="Inbox" } #inline table
  87. "drafts" = { alias="Drafts" } #inline table
  88. [accounts.account-name.mailboxes."foobar-devel"] # or a regular table
  89. ignore = true # don't show notifications for this mailbox
  90. # Setting up an mbox account
  91. [accounts.mbox]
  92. root_mailbox = "/var/mail/username"
  93. format = "mbox"
  94. index_style = "Compact"
  95. identity="username@hostname.local"
  96. composing.send_mail = { hostname = "localhost", port = 25, auth = { type = "none" }, security = { type = "none" } }
  97. [pager]
  98. filter = "COLUMNS=72 /usr/local/bin/pygmentize -l email"
  99. html_filter = "w3m -I utf-8 -T text/html"
  100. [notifications]
  101. script = "notify-send"
  102. [composing]
  103. # required for sending e-mail
  104. send_mail = 'msmtp --read-recipients --read-envelope-from'
  105. #send_mail = { hostname = "smtp.mail.tld", port = 587, auth = { type = "auto", username = "user", password = { type = "command_eval", value = "gpg2 --no-tty -q -d ~/.passwords/user.gpg" } }, security = { type = "STARTTLS" } }
  106. editor_command = 'vim +/^$'
  107. [shortcuts]
  108. [shortcuts.composing]
  109. edit_mail = 'e'
  110. [shortcuts.listing]
  111. new_mail = 'm'
  112. set_seen = 'n'
  113. [terminal]
  114. theme = "light"
  115. .Ed
  116. .Pp
  117. Available options are listed below.
  118. Default values are shown in parentheses.
  119. .Sh ACCOUNTS
  120. .Bl -tag -width 36n
  121. .It Ic root_mailbox Ar String
  122. The backend-specific path of the root_mailbox, usually INBOX.
  123. .It Ic format Ar String Op maildir mbox imap notmuch jmap
  124. The format of the mail backend.
  125. .It Ic subscribed_mailboxes Ar [String,]
  126. An array of mailbox paths to display in the UI.
  127. Paths are relative to the root mailbox (eg "INBOX/Sent", not "Sent").
  128. The glob wildcard
  129. .Em \&*
  130. can be used to match every mailbox name and path.
  131. .It Ic identity Ar String
  132. Your e-mail address that is inserted in the From: headers of outgoing mail.
  133. .It Ic index_style Ar String
  134. Sets the way mailboxes are displayed.
  135. .El
  136. .TS
  137. allbox tab(:);
  138. lb l.
  139. conversations:shows one entry per thread
  140. compact:shows one row per thread
  141. threaded:shows threads as a tree structure
  142. plain:shows one row per mail, regardless of threading
  143. .TE
  144. .Bl -tag -width 36n
  145. .It Ic display_name Ar String
  146. .Pq Em optional
  147. A name which can be combined with your address: "Name <email@address.tld>".
  148. .It Ic read_only Ar boolean
  149. Attempt to not make any changes to this account.
  150. .Pq Em false
  151. .It Ic manual_refresh Ar boolean
  152. .Pq Em optional
  153. If true, do not monitor account for changes (you can use shortcut listing.refresh)
  154. .Pq Em false
  155. .It Ic refresh_command Ar String
  156. .Pq Em optional
  157. command to execute when manually refreshing (shortcut listing.refresh)
  158. .Pq Em None
  159. .It Ic search_backend Ar String
  160. .Pq Em optional
  161. Choose which search backend to use.
  162. Available options are 'none' and 'sqlite3'
  163. .Pq Em "sqlite3"
  164. .It Ic vcard_folder Ar String
  165. .Pq Em optional
  166. Folder that contains .vcf files.
  167. They are parsed and imported read-only.
  168. .It Ic mailboxes Ar mailbox
  169. .Pq Em optional
  170. Configuration for each mailbox.
  171. Its format is described below in
  172. .Sx mailboxes Ns
  173. \&.
  174. .El
  175. .Ss notmuch only
  176. .Ic root_mailbox
  177. points to the directory which contains the
  178. .Pa .notmuch/
  179. subdirectory.
  180. notmuch mailboxes are virtual, since they are defined by user-given notmuch queries.
  181. You must explicitly state the mailboxes you want in the
  182. .Ic mailboxes
  183. field and set the
  184. .Ar query
  185. property to each of them.
  186. Example:
  187. .Bd -literal
  188. [accounts.notmuch]
  189. format = "notmuch"
  190. \&...
  191. [accounts.notmuch.mailboxes]
  192. "INBOX" = { query="tag:inbox", subscribe = true }
  193. "Drafts" = { query="tag:draft", subscribe = true }
  194. "Sent" = { query="from:username@server.tld from:username2@server.tld", subscribe = true }
  195. .Ed
  196. .Ss IMAP only
  197. IMAP specific options are:
  198. .Bl -tag -width 36n
  199. .It Ic server_hostname Ar String
  200. example:
  201. .Qq mail.example.tld
  202. .It Ic server_username Ar String
  203. Server username
  204. .It Ic server_password Ar String
  205. Server password
  206. .It Ic server_password_command Ar String
  207. .Pq Em optional
  208. Use instead of
  209. .Ic server_password
  210. .It Ic server_port Ar number
  211. .Pq Em optional
  212. The port to connect to
  213. .\" default value
  214. .Pq Em 143
  215. .It Ic use_starttls Ar boolean
  216. .Pq Em optional
  217. If port is 993 and use_starttls is unspecified, it becomes false by default.
  218. .\" default value
  219. .Pq Em true
  220. .It Ic danger_accept_invalid_certs Ar boolean
  221. .Pq Em optional
  222. Do not validate TLS certificates.
  223. .\" default value
  224. .Pq Em false
  225. .It Ic use_idle Ar boolean
  226. .Pq Em optional
  227. Use IDLE extension.
  228. .\" default value
  229. .Pq Em true
  230. .It Ic use_deflate Ar boolean
  231. .Pq Em optional
  232. Use COMPRESS=DEFLATE extension (if built with DEFLATE support).
  233. .\" default value
  234. .Pq Em true
  235. .El
  236. .Ss JMAP only
  237. JMAP specific options
  238. .Bl -tag -width 36n
  239. .It Ic server_hostname Ar String
  240. example:
  241. .Qq mail.example.tld
  242. .It Ic server_username Ar String
  243. Server username
  244. .It Ic server_password Ar String
  245. Server password
  246. .It Ic server_port Ar number
  247. .Pq Em optional
  248. The port to connect to
  249. .\" default value
  250. .Pq Em 443
  251. .It Ic danger_accept_invalid_certs Ar boolean
  252. .Pq Em optional
  253. Do not validate TLS certificates.
  254. .\" default value
  255. .Pq Em false
  256. .El
  257. .Ss mbox only
  258. mbox specific options
  259. .Bl -tag -width 36n
  260. .It Ic prefer_mbox_type Ar String
  261. .Pq Em optional
  262. Prefer specific mbox format reader for each message.
  263. Default is mboxcl2 format.
  264. If the preferred format fails, the message is retried with mboxrd and then if it fails again there's a recover attempt, which discards the invalid message.
  265. Valid values
  266. .Bl -bullet -compact
  267. .It
  268. .Ar auto
  269. .It
  270. .Ar mboxo
  271. .It
  272. .Ar mboxrd
  273. .It
  274. .Ar mboxcl
  275. .It
  276. .Ar mboxcl2
  277. .El
  278. .\" default value
  279. .Pq Em auto
  280. .El
  281. To set multiple mailboxes, you have to explicitly state the mailboxes you want in the
  282. .Ic mailboxes
  283. field and set the
  284. .Ar path
  285. property to each of them.
  286. Example:
  287. .Bd -literal
  288. [accounts.mbox]
  289. format = "mbox"
  290. mailboxes."Python mailing list" = { path = "~/.mail/python.mbox", subscribe = true, autoload = true }
  291. .Ed
  292. .Ss MAILBOXES
  293. .Bl -tag -width 36n
  294. .It Ic alias Ar String
  295. .Pq Em optional
  296. Show a different name for this mailbox in the UI
  297. .It Ic autoload Ar boolean
  298. .Pq Em optional
  299. Load this mailbox on startup
  300. .\" default value
  301. .Pq Em true
  302. .It Ic subscribe Ar boolean
  303. .Pq Em optional
  304. Watch this mailbox for updates
  305. .\" default value
  306. .Pq Em true
  307. .It Ic ignore Ar boolean
  308. .Pq Em optional
  309. Silently insert updates for this mailbox, if any
  310. .\" default value
  311. .Pq Em false
  312. .It Ic usage Ar boolean
  313. .Pq Em optional
  314. special usage of this mailbox.
  315. Valid values are:
  316. .Bl -bullet -compact
  317. .It
  318. .Ar Normal
  319. .Pq Em default
  320. .It
  321. .Ar Inbox
  322. .It
  323. .Ar Archive
  324. .It
  325. .Ar Drafts
  326. .It
  327. .Ar Flagged
  328. .It
  329. .Ar Junk
  330. .It
  331. .Ar Sent
  332. .It
  333. .Ar Trash
  334. .El
  335. otherwise usage is inferred from the mailbox title.
  336. If for example your Sent folder is not named "Sent", you must explicitly set it.
  337. .It Ic conf_override Ar boolean
  338. .Pq Em optional
  339. Override global settings for this mailbox.
  340. Available sections to override are
  341. .Em pager, notifications, shortcuts, composing
  342. and the account options
  343. .Em identity
  344. and
  345. .Em index_style Ns
  346. \&.
  347. Example:
  348. .Bd -literal
  349. [accounts."imap.domain.tld".mailboxes."INBOX"]
  350. index_style = "plain"
  351. [accounts."imap.domain.tld".mailboxes."INBOX".pager]
  352. filter = ""
  353. .Ed
  354. .El
  355. .Sh COMPOSING
  356. Composing specific options
  357. .Bl -tag -width 36n
  358. .It Ic send_mail Ar String|SmtpServerConf
  359. Command to pipe new mail to (exit code must be 0 for success) or settings for an SMTP server connection.
  360. See section
  361. .Sx SMTP Connections
  362. for its fields.
  363. .It Ic editor_command Ar String
  364. Command to launch editor.
  365. Can have arguments.
  366. Draft filename is given as the last argument.
  367. If it's missing, the environment variable $EDITOR is looked up.
  368. .It Ic embed Ar boolean
  369. .Pq Em optional
  370. Embed editor within meli.
  371. Editor must be xterm compliant.
  372. .\" default value
  373. .Pq Em false
  374. .It Ic format_flowed Ar boolean
  375. .Pq Em optional
  376. Set format=flowed [RFC3676] in text/plain attachments.
  377. .\" default value
  378. .Pq Em true
  379. .It Ic default_header_values Ar hash table String[String]
  380. Default header values used when creating a new draft.
  381. .El
  382. .Sh SHORTCUTS
  383. Shortcuts can take the following values:
  384. .Bl -bullet -compact
  385. .It
  386. .Em Backspace
  387. .It
  388. .Em Left
  389. .It
  390. .Em Right
  391. .It
  392. .Em Up
  393. .It
  394. .Em Down
  395. .It
  396. .Em Home
  397. .It
  398. .Em End
  399. .It
  400. .Em PageUp
  401. .It
  402. .Em PageDown
  403. .It
  404. .Em Delete
  405. .It
  406. .Em Insert
  407. .It
  408. .Em Enter
  409. .It
  410. .Em Tab
  411. .It
  412. .Em Esc
  413. .It
  414. .Em F1..F12
  415. .It
  416. .Em M-char
  417. .It
  418. .Em C-char
  419. .It
  420. .Em char
  421. .El
  422. .Em char
  423. is a single character string.
  424. .sp
  425. The headings before each list indicate the map key of the shortcut list.
  426. For example for the first list titled
  427. .Em general
  428. the configuration is typed as follows:
  429. .Bd -literal
  430. [shortcuts.general]
  431. next_tab = 'T'
  432. .Ed
  433. .sp
  434. and for
  435. .Em compact-listing Ns
  436. :
  437. .Bd -literal
  438. [shortcuts.compact-listing]
  439. open_thread = "Enter"
  440. exit_thread = 'i'
  441. .Ed
  442. .sp
  443. .Pp
  444. .Em general
  445. .Bl -tag -width 36n
  446. .It Ic enter_command_mode
  447. Enter
  448. .Em COMMAND
  449. mode.
  450. .\" default value
  451. .Pq Ql Em \
  452. .It Ic next_tab
  453. Go to next tab.
  454. .\" default value
  455. .Pq Em T
  456. .It Ic go_to_tab
  457. Go to the
  458. .Em n Ns
  459. th tab
  460. .Pq Em cannot be redefined
  461. .El
  462. .sp
  463. .Em listing
  464. .Bl -tag -width 36n
  465. .It Ic prev_page
  466. Go to previous page.
  467. .\" default value
  468. .Pq Em PageUp
  469. .It Ic next_page
  470. Go to next page.
  471. .\" default value
  472. .Pq Em PageDown
  473. .It Ic prev_mailbox
  474. Go to previous mailbox.
  475. .\" default value
  476. .Pq Em K
  477. .It Ic next_mailbox
  478. Go to next mailbox.
  479. .\" default value
  480. .Pq Em J
  481. .It Ic prev_account
  482. Go to previous account.
  483. .\" default value
  484. .Pq Em l
  485. .It Ic next_account
  486. Go to next account.
  487. .\" default value
  488. .Pq Em h
  489. .It Ic new_mail
  490. Start new mail draft in new tab
  491. .\" default value
  492. .Pq Em m
  493. .It Ic set_seen
  494. Set thread as seen.
  495. .\" default value
  496. .Pq Em n
  497. .It Ic refresh
  498. Manually request a mailbox refresh.
  499. .\" default value
  500. .Pq Em F5
  501. .It Ic search
  502. Search within list of e-mails.
  503. .\" default value
  504. .Pq Em /
  505. .It Ic toggle_menu_visibility
  506. Toggle visibility of side menu in mail list.
  507. .\" default value
  508. .Pq Em `
  509. .El
  510. .sp
  511. .Em compact-listing
  512. .Bl -tag -width 36n
  513. .It Ic exit_thread
  514. Exit thread view
  515. .\" default value
  516. .Pq Em i
  517. .It Ic open_thread
  518. Open thread.
  519. .\" default value
  520. .Pq Em Enter
  521. .It Ic select_entry
  522. Select thread entry.
  523. .\" default value
  524. .Pq Em v
  525. .El
  526. .sp
  527. .Em pager
  528. .Bl -tag -width 36n
  529. .It Ic scroll_up
  530. Scroll up pager.
  531. .\" default value
  532. .Pq Em k
  533. .It Ic scroll_down
  534. Scroll down pager.
  535. .\" default value
  536. .Pq Em j
  537. .It Ic page_up
  538. Go to previous pager page
  539. .\" default value
  540. .Pq Em PageUp
  541. .It Ic page_down
  542. Go to next pager pag
  543. .\" default value
  544. .Pq Em PageDown
  545. .El
  546. .sp
  547. .Em contact-list
  548. .Bl -tag -width 36n
  549. .It Ic create_contact
  550. Create new contact.
  551. .\" default value
  552. .Pq Em c
  553. .It Ic edit_contact
  554. Edit contact under cursor
  555. .\" default value
  556. .Pq Em e
  557. .It Ic mail_contact
  558. Mail contact under cursor
  559. .\" default value
  560. .Pq Em m
  561. .It Ic toggle_menu_visibility
  562. Toggle visibility of side menu in mail list.
  563. .\" default value
  564. .Pq Em `
  565. .El
  566. .sp
  567. .sp
  568. .Em composing
  569. .Bl -tag -width 36n
  570. .It Ic send_mail
  571. Deliver draft to mailer
  572. .\" default value
  573. .Pq Em s
  574. .It Ic edit_mail
  575. Edit mail.
  576. .\" default value
  577. .Pq Em e
  578. .El
  579. .sp
  580. .Em envelope-view
  581. .Pp
  582. To select an attachment, type its index (you will see the typed result in the command buffer on the bottom right of the status line), then issue the corresponding command.
  583. .Bl -tag -width 36n
  584. .It Ic add_addresses_to_contacts Ns
  585. Select addresses from envelope to add to contacts.
  586. .\" default value
  587. .Pq Em c
  588. .It Ic view_raw_source
  589. View raw envelope source in a pager.
  590. .\" default value
  591. .Pq Em M-r
  592. .It Ic reply
  593. Reply to envelope.
  594. .\" default value
  595. .Pq Em R
  596. .It Ic edit
  597. Open envelope in composer.
  598. .\" default value
  599. .Pq Em e
  600. .It Ic return_to_normal_view
  601. Return to envelope if viewing raw source or attachment.
  602. .\" default value
  603. .Pq Em r
  604. .It Ic open_attachment
  605. Opens selected attachment with
  606. .Cm xdg-open
  607. .\" default value
  608. .Pq Em a
  609. .It Ic open_mailcap
  610. Opens selected attachment according to its mailcap entry.
  611. See
  612. .Xr meli 1 FILES
  613. for the mailcap file locations.
  614. .\" default value
  615. .Pq Em m
  616. .It Ic go_to_url
  617. Go to url of given index
  618. .\" default value
  619. .Pq Em g
  620. .It Ic toggle_url_mode
  621. Toggles url open mode.
  622. When active, it prepends an index next to each url that you can select by typing the index and open by issuing
  623. .Ic go_to_url
  624. .\" default value
  625. .Pq Em u
  626. .It Ic toggle_expand_headers
  627. Expand extra headers (References and others)
  628. .\" default value
  629. .Pq Em h
  630. .El
  631. .sp
  632. .Em thread-view
  633. .Bl -tag -width 36n
  634. .It Ic reverse_thread_order
  635. Reverse thread order.
  636. .\" default value
  637. .Pq Em r
  638. .It Ic toggle_mailview
  639. Toggle mail view visibility.
  640. .\" default value
  641. .Pq Em p
  642. .It Ic toggle_threadview
  643. Toggle thread view visibility.
  644. .\" default value
  645. .Pq Em t
  646. .It Ic collapse_subtree
  647. Collapse thread branches.
  648. .\" default value
  649. .Pq Em h
  650. .It Ic prev_page
  651. Go to previous page.
  652. .\" default value
  653. .Pq Em PageUp
  654. .It Ic next_page
  655. Go to next page.
  656. .\" default value
  657. .Pq Em PageDown
  658. .El
  659. .sp
  660. .Sh NOTIFICATIONS
  661. .Bl -tag -width 36n
  662. .It Ic enable Ar boolean
  663. Enable freedesktop-spec notifications.
  664. .\" default value
  665. .Pq Em true
  666. .It Ic script Ar String
  667. .Pq Em optional
  668. Script to pass notifications to, with title as 1st arg and body as 2nd
  669. .\" default value
  670. .Pq Em none Ns
  671. \&.
  672. .It Ic xbiff_file_path Ar String
  673. .Pq Em optional
  674. File that gets its size updated when new mail arrives.
  675. .Pq Em none
  676. .\" default value
  677. .It Ic play_sound Ar boolean
  678. .Pq Em optional
  679. Play theme sound in notifications if possible.
  680. .Pq Em false
  681. .\" default value
  682. .It Ic sound_file Ar String
  683. .Pq Em optional
  684. Play sound file in notifications if possible.
  685. .\" default value
  686. .Pq Em none
  687. .El
  688. .Sh PAGER
  689. .Bl -tag -width 36n
  690. .It Ic headers_sticky Ar boolean
  691. .Pq Em optional
  692. Always show headers when scrolling.
  693. .\" default value
  694. .Pq Em true
  695. .It Ic html_filter Ar String
  696. .Pq Em optional
  697. Pipe html attachments through this filter before display
  698. .\" default value
  699. .Pq Em none
  700. .It Ic filter Ar String
  701. .Pq Em optional
  702. A command to pipe mail output through for viewing in pager.
  703. .\" default value
  704. .Pq Em none
  705. .It Ic format_flowed Ar bool
  706. .Pq Em optional
  707. Respect format=flowed
  708. .\" default value
  709. .Pq Em true
  710. .It Ic split_long_lines Ar bool
  711. .Pq Em optional
  712. Split long lines that would overflow on the x axis.
  713. .\" default value
  714. .Pq Em true
  715. .It Ic minimum_width Ar num
  716. .Pq Em optional
  717. Minimum text width in columns.
  718. .\" default value
  719. .Pq Em 80
  720. .It Ic auto_choose_multipart_alternative Ar boolean
  721. .Pq Em optional
  722. Choose `text/html` alternative if `text/plain` is empty in `multipart/alternative` attachments.
  723. .\" default value
  724. .Pq Em true
  725. .El
  726. .Sh LISTING
  727. .Bl -tag -width 36n
  728. .It Ic datetime_fmt Ar String
  729. .Pq Em optional
  730. Datetime formatting passed verbatim to strftime(3).
  731. .\" default value
  732. .Pq Em \&%Y-\&%m-\&%d \&%T
  733. .It Ic recent_dates Ar Boolean
  734. .Pq Em optional
  735. Show recent dates as `X {minutes,hours,days} ago`, up to 7 days.
  736. .\" default value
  737. .Pq Em true
  738. .It Ic filter Ar Query
  739. .Pq Em optional
  740. Show only envelopes matching this query.
  741. .Po
  742. For query syntax see
  743. .Xr meli 1 QUERY ABNF SYNTAX
  744. .Pc
  745. .\" default value
  746. .Pq Em None
  747. .Pp
  748. Example:
  749. .Bd -literal
  750. filter = "not flags:seen" # show only unseen messages
  751. .Ed
  752. .El
  753. .Sh TAGS
  754. .Bl -tag -width 36n
  755. .It Ic colours Ar hash table String[Color]
  756. .Pq Em optional
  757. Set UI colors for tags
  758. .It Ic ignore_tags Ar Array String
  759. .Pq Em optional
  760. Hide tags (not the tagged messages themselves)
  761. .El
  762. .sp
  763. Example:
  764. .sp
  765. .Bd -literal
  766. [tags]
  767. # valid inputs: #HHHHHH, #ABC -> #AABBCC, XTERM_NAME, 0-255 byte
  768. colors = { signed="#Ff6600", replied="DeepSkyBlue4", draft="#f00", replied="8" }
  769. [accounts.dummy]
  770. \&...
  771. [accounts.dummy.mailboxes]
  772. # per mailbox override:
  773. "INBOX" = { tags.ignore_tags=["inbox", ] }
  774. .Ed
  775. .Sh PGP
  776. .Bl -tag -width 36n
  777. .It Ic auto_verify_signatures Ar boolean
  778. Auto verify signed e-mail according to RFC3156
  779. .\" default value
  780. .Pq Em true
  781. .It Ic auto_sign Ar boolean
  782. .Pq Em optional
  783. Always sign sent messages
  784. .\" default value
  785. .Pq Em false
  786. .It Ic key Ar String
  787. .Pq Em optional
  788. Key to be used when signing/encrypting (not functional yet)
  789. .\" default value
  790. .Pq Em none
  791. .It Ic gpg_binary Ar String
  792. .Pq Em optional
  793. The gpg binary name or file location to use
  794. .\" default value
  795. .Pq Em "gpg2"
  796. .El
  797. .Sh TERMINAL
  798. .Bl -tag -width 36n
  799. .It Ic theme Ar String
  800. .Pq Em optional
  801. Theme name to use.
  802. .\" default value
  803. .Pq Em dark
  804. .It Ic ascii_drawing Ar boolean
  805. .Pq Em optional
  806. If true, box drawing will be done with ascii characters.
  807. .\" default value
  808. .Pq Em false
  809. .It Ic use_color Ar boolean
  810. .Pq Em optional
  811. If false, no ANSI colors are used.
  812. .\" default value
  813. .Pq Em true
  814. .It Ic window_title Ar String
  815. .Pq Em optional
  816. Set window title in xterm compatible terminals An empty string means no window title is set.
  817. .\" default value
  818. .Pq Em "meli"
  819. .It Ic themes Ar hash table String[String[Attribute]]
  820. Define UI themes.
  821. See
  822. .Xr meli-themes 5
  823. for details.
  824. .Bd -literal
  825. [terminal]
  826. theme = "themeB"
  827. [terminal.themes.themeA]
  828. "mail.view.body" = {fg = "HotPink3", bg = "LightSalmon1"}
  829. \&...
  830. [terminal.themes.themeB]
  831. "mail.view.body" = {fg = "CadetBlue", bg = "White"}
  832. \&...
  833. [terminal.themes.themeC]
  834. \&...
  835. .Ed
  836. .El
  837. .Sh LOG
  838. .Bl -tag -width 36n
  839. .It Ic log_file Ar String
  840. .Pq Em optional
  841. path of the log file
  842. .\" default value
  843. .Pq Pa $XDG_DATA_HOME/meli/meli.log
  844. .It Ic maximum_level Ar String
  845. .Pq Em optional
  846. maximum level of messages to log.
  847. All levels less or equal to the
  848. .Ic maximum_level
  849. will be appended to the log file.
  850. Available levels are, in partial order:
  851. .Bl -bullet -compact
  852. .It
  853. .Em OFF
  854. .It
  855. .Em FATAL
  856. .It
  857. .Em ERROR
  858. .It
  859. .Em WARN
  860. .It
  861. .Em INFO
  862. .It
  863. .Em DEBUG
  864. .It
  865. .Em TRACE
  866. .El
  867. This means that to turn logging off, set
  868. .Ic maximum_level
  869. to
  870. .Em OFF Ns
  871. \&.
  872. .\" default value
  873. .Pq Em INFO
  874. .El
  875. .Sh SMTP Connections
  876. .Bl -tag -width 36n
  877. .It Ic hostname Ar String
  878. server hostname
  879. .It Ic port Ar Integer
  880. server port
  881. .It Ic envelope_from Ar String
  882. .Pq Em optional
  883. address to set as sender in SMTP transactions
  884. .\" default value
  885. .Pq Em none
  886. .It Ic auth Ar SmtpAuth
  887. SMTP server authentication.
  888. See
  889. .Sx SmtpAuth
  890. subsection.
  891. .It Ic security Ar SmtpSecurity
  892. .Pq Em optional
  893. gpg binary name or file location to use
  894. .\" default value
  895. .Po see
  896. .Sx SmtpSecurity
  897. subsection
  898. .Pc
  899. .It Ic extensions Ar SmtpExtensions
  900. .Pq Em optional
  901. set support for SMTP extensions if they are advertised by the server
  902. .\" default value
  903. .Po see
  904. .Sx SmtpExtensions
  905. subsection
  906. .Pc
  907. .El
  908. .Ss SmtpAuth
  909. .Bl -tag -width 36n
  910. .It Ic type Ar "none" | "auto"
  911. .El
  912. .Pp
  913. For type "auto":
  914. .Bl -tag -width 36n
  915. .It Ic username Ar String
  916. .It Ic password Ar String|SmtpPassword
  917. .It Ic require_auth Ar bool
  918. .Pq Em optional
  919. require authentication in every case
  920. .\" default value
  921. .Pq Em true
  922. .El
  923. .Ss SmtpPassword
  924. .Bl -tag -width 36n
  925. .It Ic type Ar "raw" | "command_evaluation"
  926. .It Ic value Ar String
  927. Either a raw password string, or command to execute.
  928. .El
  929. .Ss SmtpSecurity
  930. Default security type is
  931. .Em auto Ns
  932. \&.
  933. .Bl -tag -width 36n
  934. .It Ic type Ar "none" | "auto" | "starttls" | "tls"
  935. .It Ic danger_accept_invalid_certs Ar bool
  936. Accept invalid SSL/TLS certificates
  937. .\" default value
  938. .Pq Em false
  939. .El
  940. .Ss SmtpExtensions
  941. .Bl -tag -width 36n
  942. .It Ic pipelining Ar bool
  943. rfc2920
  944. .\" default value
  945. .Pq Em true
  946. .It Ic chunking Ar bool
  947. rfc3030
  948. .\" default value
  949. .Pq Em true
  950. .It Ic prdr Ar bool
  951. draft-hall-prdr-00
  952. .\" default value
  953. .Pq Em true
  954. .It Ic dsn_notify Ar String
  955. RFC3461
  956. .\" default value
  957. .Pq Em FAILURE
  958. .El
  959. .Sh SEE ALSO
  960. .Xr meli 1 ,
  961. .Xr meli-themes 5
  962. .Sh CONFORMING TO
  963. TOML Standard v.0.5.0 https://toml.io/en/v0.5.0
  964. .Sh AUTHORS
  965. Copyright 2017-2019
  966. .An Manos Pitsidianakis Aq epilys@nessuent.xyz
  967. Released under the GPL, version 3 or greater.
  968. This software carries no warranty of any kind.
  969. (See COPYING for full copyright and warranty notices.)
  970. .Pp
  971. .Aq https://meli.delivery