1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
|
ask_subject = boolean(default=True) # ask for subject when compose
# confirm exit
bug_on_exit = boolean(default=False)
# offset of next focused buffer if the current one gets closed
bufferclose_focus_offset = integer(default=-1)
# number of colours your terminal supports
colourmode = option(1, 16, 256, default=256)
# number of spaces used to replace tab characters
tabwidth = integer(default=8)
# templates directory that contains your message templates.
# It will be used if you give `compose --template` a filename without a path prefix.
template_dir = string(default='$XDG_CONFIG_HOME/alot/templates')
# directory containing theme files
themes_dir = string(default=None)
# name of the theme to use
theme = string(default=None)
# fill threadline with message content
display_content_in_threadline = boolean(default=False)
# headers that get displayed by default
displayed_headers = string_list(default=list(From,To,Cc,Bcc,Subject))
# headers that are hidden in envelope buffers by default
envelope_headers_blacklist = string_list(default=list(In-Reply-To,References))
# Replace own email addresses with "me" in author lists
# Uses own addresses and aliases in all configured accounts.
thread_authors_replace_me = boolean(default=True)
#Word to replace own addresses with. Works in combination with
#:ref:`thread_authors_replace_me <thread-authors-replace-me>`
thread_authors_me = string(default='Me')
# set terminal command used for spawning shell commands
terminal_cmd = string(default='x-terminal-emulator -e')
# editor command
# if unset, alot will first try the EDITOR env variable, then /usr/bin/editor
editor_cmd = string(default=None)
# file encoding used by your editor
editor_writes_encoding = string(default='UTF-8')
# use terminal_command to spawn a new terminal for the editor?
editor_spawn = boolean(default=False)
# call editor in separate thread.
# In case your editor doesn't run in the same window as alot, setting true here
# will make alot non-blocking during edits
editor_in_thread = boolean(default=False)
# Which header fields should be editable in your editor
# used are those that match the whitelist and don't match the blacklist.
# in both cases '*' may be used to indicate all fields.
edit_headers_whitelist = string_list(default=list(*,))
# see :ref:`edit_headers_whitelist <edit-headers-whitelist>`
edit_headers_blacklist = string_list(default=list(Content-Type,MIME-Version,References,In-Reply-To))
# timeout in secs after a failed attempt to flush is repeated
flush_retry_timeout = integer(default=5)
# where to look up hooks
hooksfile = string(default='~/.config/alot/hooks.py')
# time in secs to display status messages
notify_timeout = integer(default=2)
# display status-line?
show_statusbar = boolean(default=True)
# timestamp format in strftime format syntax:
# http://docs.python.org/library/datetime.html#strftime-strptime-behavior
timestamp_format = string(default=None)
# max length of authors line in thread widgets
authors_maxlength = integer(default=30)
# how to print messages:
# this specifies a shell command used pro printing.
# threads/messages are piped to this command as plain text.
# muttprint/a2ps works nicely
print_cmd = string(default=None)
# initial command when none is given as argument:
initial_command = string(default='search tag:inbox AND NOT tag:killed')
# default sort order of results in a search
search_threads_sort_order = option('oldest_first', 'newest_first', 'message_id', 'unsorted', default='newest_first')
# in case more than one account has an address book:
# Set this to True to make tab completion for recipients during compose only
# look in the abook of the account matching the sender address
complete_matching_abook_only = boolean(default=False)
# shut down when the last buffer gets closed
quit_on_last_bclose = boolean(default=False)
# value of the User-Agent header used for outgoing mails.
# setting this to the empty string will cause alot to omit the header all together.
# The string '{version}' will be replaced by the version string of the running instance.
user_agent = string(default='alot/{version}')
# Key bindings
[bindings]
__many__ = string(default=None)
[[___many___]]
__many__ = string(default=None)
[tags]
# for each tag
[[__many__]]
# foreground
fg = string(default=None)
# background
bg = string(default=None)
# foreground if focused
focus_fg = string(default=None)
# background if focused
focus_bg = string(default=None)
# don't display at all?
hidden = boolean(default=False)
# alternative string representation
translated = string(default=None)
# substitution to generate translated from section name
translation = mixed_list(string, string, default=None)
[accounts]
[[__many__]]
# your email address
address = string
# used to format the (proposed) From-header in outgoing mails
realname = string
# used to clear your addresses/ match account when formatting replies
aliases = string_list(default=list())
# how to send mails
sendmail_command = string(default='sendmail')
# specifies the mailbox where you want outgoing mails to be stored after successfully sending them, e.g.
# where to store outgoing mail, e.g. `maildir:///home/you/mail//Sent`
# You can use mbox, maildir, mh, babyl and mmdf in the protocol part of the URL.
sent_box = string(default=None)
# how to tag sent mails.
sent_tags = string_list(default=list('sent'))
# path to signature file that gets attached to all outgoing mails from this account, optionally
# renamed to `signature_filename`.
signature = string(default=None)
# attach signature file if set to True, append its content (mimetype text)
# to the body text if set to False. Defaults to False.
signature_as_attachment = boolean(default=False)
# signature file's name as it appears in outgoing mails if
# signature_as_attachment is set to True
signature_filename = string(default=None)
# address book for this account
[[[abook]]]
# type identifier for address book
type = option('shellcommand', 'abook', default=None)
# command to lookup contacts in shellcommand abooks
# it will be called with the lookup prefix as only argument
command = string(default=None)
# regular expression used to match name/address pairs in the output of `command`
# for shellcommand abooks
regexp = string(default=None)
# contacts file used for type 'abook' address book
abook_contacts_file = string(default='~/.abook/addressbook')
|
