aboutsummaryrefslogtreecommitdiff
path: root/vit
diff options
context:
space:
mode:
Diffstat (limited to 'vit')
-rw-r--r--vit/config.ini512
1 files changed, 256 insertions, 256 deletions
diff --git a/vit/config.ini b/vit/config.ini
index 62cfbb4..70e7bee 100644
--- a/vit/config.ini
+++ b/vit/config.ini
@@ -1,256 +1,256 @@
1# This is the user configuration file for VIT. 1# This is the user configuration file for VIT.
2 2
3# All configuration options are listed here, commented out, and showing their 3# All configuration options are listed here, commented out, and showing their
4# default value when not otherwise set. 4# default value when not otherwise set.
5 5
6# The format is standard INI file format. Configuration sections are enclosed 6# The format is standard INI file format. Configuration sections are enclosed
7# by brackets. Configuration values should be placed in their relevant section, 7# by brackets. Configuration values should be placed in their relevant section,
8# using a 'name = value' format. Boolean values can be expressed by the 8# using a 'name = value' format. Boolean values can be expressed by the
9# following: 9# following:
10# True values: 1, yes, true (case insensitive) 10# True values: 1, yes, true (case insensitive)
11# False values: All other values. 11# False values: All other values.
12 12
13 13
14[taskwarrior] 14[taskwarrior]
15 15
16# Full path to the Taskwarrior configuration file. Tilde will be expanded to 16# Full path to the Taskwarrior configuration file. Tilde will be expanded to
17# the user's home directory. 17# the user's home directory.
18# NOTE: This setting is overridden by the TASKRC environment variable. 18# NOTE: This setting is overridden by the TASKRC environment variable.
19#taskrc = ~/.taskrc 19#taskrc = ~/.taskrc
20 20
21 21
22[vit] 22[vit]
23 23
24# The keybinding map to use. This maps actions registered with VIT to be fired 24# The keybinding map to use. This maps actions registered with VIT to be fired
25# when the user presses the specific keys configured in the keybindings file. 25# when the user presses the specific keys configured in the keybindings file.
26# Possible keybindings are in the 'keybinding' directory, and the setting's 26# Possible keybindings are in the 'keybinding' directory, and the setting's
27# value should be the filename minus the .ini extension. The default keybinding 27# value should be the filename minus the .ini extension. The default keybinding
28# configuration is modeled heavily on the legacy VIT keybindings, and inspired 28# configuration is modeled heavily on the legacy VIT keybindings, and inspired
29# by vi/vim. 29# by vi/vim.
30#default_keybindings = vi 30#default_keybindings = vi
31 31
32# The theme to use. This allows control over the colors used in the 32# The theme to use. This allows control over the colors used in the
33# application itself. Possible themes are in the 'theme' directory, and the 33# application itself. Possible themes are in the 'theme' directory, and the
34# setting's value should be the filename minus the .py extension. 34# setting's value should be the filename minus the .py extension.
35# Note that the theme does not control any coloring related to tasks -- this 35# Note that the theme does not control any coloring related to tasks -- this
36# is controlled via the color settings in the Taskwarrior configuration. 36# is controlled via the color settings in the Taskwarrior configuration.
37#theme = default 37#theme = default
38 38
39# Boolean. If true, VIT will ask for confirmation before marking a task as done, 39# Boolean. If true, VIT will ask for confirmation before marking a task as done,
40# deleting a task, or quitting VIT. Set to false to disable the prompts. 40# deleting a task, or quitting VIT. Set to false to disable the prompts.
41confirmation = False 41confirmation = False
42 42
43 43
44# Boolean. If true, VIT will show the output of the task command and wait for 44# Boolean. If true, VIT will show the output of the task command and wait for
45# enter. If false, VIT will not show output of the task command after 45# enter. If false, VIT will not show output of the task command after
46# modifications to a task are made. 46# modifications to a task are made.
47wait = False 47wait = False
48 48
49# Boolean. If true, VIT will enable mouse support for actions such as selecting 49# Boolean. If true, VIT will enable mouse support for actions such as selecting
50# list items. 50# list items.
51#mouse = False 51#mouse = False
52 52
53# Boolean. If true, hitting backspace against an empty prompt aborts the prompt. 53# Boolean. If true, hitting backspace against an empty prompt aborts the prompt.
54#abort_backspace = False 54#abort_backspace = False
55 55
56# Boolean. If true, VIT will focus on the newly added task. Note: the new task must be 56# Boolean. If true, VIT will focus on the newly added task. Note: the new task must be
57#included in the active filter for this setting to have effect. 57#included in the active filter for this setting to have effect.
58focus_on_add = True 58focus_on_add = True
59 59
60# Path to a directory to manage pid files for running instances of VIT. 60# Path to a directory to manage pid files for running instances of VIT.
61# If no path is provided, no pid files will be managed. 61# If no path is provided, no pid files will be managed.
62# The special token $UID may be used, and will be substituted with the user ID 62# The special token $UID may be used, and will be substituted with the user ID
63# of the user starting VIT. 63# of the user starting VIT.
64# VIT can be run with the '--list-pids' argument, which will output a list of 64# VIT can be run with the '--list-pids' argument, which will output a list of
65# all pids in pid_dir; useful for sending signals to the running processes. 65# all pids in pid_dir; useful for sending signals to the running processes.
66# If you use this feature, it's suggested to choose a directory that is 66# If you use this feature, it's suggested to choose a directory that is
67# automatically cleaned on boot, e.g.: 67# automatically cleaned on boot, e.g.:
68# /var/run/user/$UID/vit 68# /var/run/user/$UID/vit
69# /tmp/vit_pids 69# /tmp/vit_pids
70#pid_dir = 70#pid_dir =
71 71
72# Int. The number of flash repetitions focusing on the edit made 72# Int. The number of flash repetitions focusing on the edit made
73#flash_focus_repeat_times = 2 73#flash_focus_repeat_times = 2
74 74
75# Float. Waiting time for the blink focusing on the edit made 75# Float. Waiting time for the blink focusing on the edit made
76#flash_focus_pause_seconds = 0.1 76#flash_focus_pause_seconds = 0.1
77 77
78[report] 78[report]
79 79
80# The default Taskwarrior report to load when VIT first starts, if no report 80# The default Taskwarrior report to load when VIT first starts, if no report
81# or filters are passed at the command line. 81# or filters are passed at the command line.
82#default_report = next 82#default_report = next
83 83
84# The default Taskwarrior report to load when VIT first starts, if filters are 84# The default Taskwarrior report to load when VIT first starts, if filters are
85# passed at the command line with no report. 85# passed at the command line with no report.
86#default_filter_only_report = next 86#default_filter_only_report = next
87 87
88# Boolean. If true, reports with the primary sort of project ascending will 88# Boolean. If true, reports with the primary sort of project ascending will
89# indent subprojects. If you use deeply nested subprojects, you'll probably 89# indent subprojects. If you use deeply nested subprojects, you'll probably
90# like this setting. 90# like this setting.
91#indent_subprojects = True 91#indent_subprojects = True
92 92
93# Boolean. If true, display report rows with alternating background colors. 93# Boolean. If true, display report rows with alternating background colors.
94#row_striping = True 94#row_striping = True
95 95
96 96
97[marker] 97[marker]
98 98
99# Boolean. Enables markers. Markers are configurable labels that appear on the 99# Boolean. Enables markers. Markers are configurable labels that appear on the
100# left side of a report to indicate information about a task when the displayed 100# left side of a report to indicate information about a task when the displayed
101# report does not contain the related column. 101# report does not contain the related column.
102# For example, let's suppose you have a 'notes' UDA configured. You'd like to 102# For example, let's suppose you have a 'notes' UDA configured. You'd like to
103# see some indication that a task has a note, without displaying the full note 103# see some indication that a task has a note, without displaying the full note
104# column in reports. You could configure a marker for that custom UDA as 104# column in reports. You could configure a marker for that custom UDA as
105# follows: 105# follows:
106# uda.notes.label = (N) 106# uda.notes.label = (N)
107# Then, when a listed task has a note associated with it, you'll see the 107# Then, when a listed task has a note associated with it, you'll see the
108# marker '(N)' displayed in the leftmost column of any report that displays the 108# marker '(N)' displayed in the leftmost column of any report that displays the
109# task in question. 109# task in question.
110#enabled = True 110#enabled = True
111 111
112# What columns to generate markers for. Can either be 'all' for all columns, or 112# What columns to generate markers for. Can either be 'all' for all columns, or
113# a comma separated list of columns to enable markers for. Possible columns 113# a comma separated list of columns to enable markers for. Possible columns
114# are: 114# are:
115# depends,description,due,project,recur,scheduled,start,status,tags,until 115# depends,description,due,project,recur,scheduled,start,status,tags,until
116#columns = all 116#columns = all
117 117
118# The header label for the markers column when it is displayed. 118# The header label for the markers column when it is displayed.
119#header_label = 119#header_label =
120 120
121# Boolean. If true, an associated color value must be configured in the 121# Boolean. If true, an associated color value must be configured in the
122# Taskwarrior configuration in order for the marker to be displayed. If false, 122# Taskwarrior configuration in order for the marker to be displayed. If false,
123# and no Taskwarrior color configuration is present for the matching marker, 123# and no Taskwarrior color configuration is present for the matching marker,
124# then it is not displayed. 124# then it is not displayed.
125# For example, if this is set to True, then for the above-mentioned 'notes' 125# For example, if this is set to True, then for the above-mentioned 'notes'
126# marker to be displayed, a matching Taskwarrior color configuration for the 126# marker to be displayed, a matching Taskwarrior color configuration for the
127# 'notes' UDA must be present, e.g.: 127# 'notes' UDA must be present, e.g.:
128# color.uda.notes=yellow 128# color.uda.notes=yellow
129#require_color = True 129#require_color = True
130 130
131# Boolean. If true, subprojects of a project will also display the configured 131# Boolean. If true, subprojects of a project will also display the configured
132# root project's marker, if the subproject itself does not have its own marker 132# root project's marker, if the subproject itself does not have its own marker
133# configured. 133# configured.
134# For example, given the following projects: 134# For example, given the following projects:
135# Foo 135# Foo
136# Foo.Bar 136# Foo.Bar
137# If this value is set to True, and the Foo project has a configured marker, 137# If this value is set to True, and the Foo project has a configured marker,
138# then Foo.Bar would also display Foo's marker. 138# then Foo.Bar would also display Foo's marker.
139#include_subprojects = True 139#include_subprojects = True
140 140
141# Below are listed all of the available markers, with their default label. 141# Below are listed all of the available markers, with their default label.
142# To disable a specific marker, set its label to empty. Any section enclosed 142# To disable a specific marker, set its label to empty. Any section enclosed
143# in brackets should be replaced by the appropriate identifier, eg. 143# in brackets should be replaced by the appropriate identifier, eg.
144# [project_name] with the actual name of a project. 144# [project_name] with the actual name of a project.
145#active.label = (A) 145#active.label = (A)
146#blocked.label = (BD) 146#blocked.label = (BD)
147#blocking.label = (BG) 147#blocking.label = (BG)
148#completed.label = (C) 148#completed.label = (C)
149#deleted.label = (X) 149#deleted.label = (X)
150#due.label = (D) 150#due.label = (D)
151#due.today.label = (DT) 151#due.today.label = (DT)
152#keyword.label = (K) 152#keyword.label = (K)
153#keyword.[keyword_name].label = 153#keyword.[keyword_name].label =
154#overdue.label = (OD) 154#overdue.label = (OD)
155#project.label = (P) 155#project.label = (P)
156#project.none.label = 156#project.none.label =
157#project.[project_name].label = 157#project.[project_name].label =
158#recurring.label = (R) 158#recurring.label = (R)
159#scheduled.label = (S) 159#scheduled.label = (S)
160#tag.label = (T) 160#tag.label = (T)
161#tag.none.label = 161#tag.none.label =
162#tag.[tag_name].label = 162#tag.[tag_name].label =
163#uda.label = 163#uda.label =
164#uda.priority.label = (PR) 164#uda.priority.label = (PR)
165#uda.[uda_name].label = 165#uda.[uda_name].label =
166 166
167 167
168[color] 168[color]
169 169
170# Boolean. If true, use the colors in Taskwarrior's configuration to colorize 170# Boolean. If true, use the colors in Taskwarrior's configuration to colorize
171# reports. Note that VIT uses a fundamentally different paradigm for 171# reports. Note that VIT uses a fundamentally different paradigm for
172# colorization, which combines tying coloring to associated report columns in 172# colorization, which combines tying coloring to associated report columns in
173# combination with markers (see above). This setting works independently of 173# combination with markers (see above). This setting works independently of
174# Taskwarriors 'color' config setting. 174# Taskwarriors 'color' config setting.
175#enabled = True 175#enabled = True
176 176
177# Boolean. If true, subprojects of a project will also display the configured 177# Boolean. If true, subprojects of a project will also display the configured
178# root project's color, if the subproject itself does not have its own color 178# root project's color, if the subproject itself does not have its own color
179# configured. 179# configured.
180# For example, given the following projects: 180# For example, given the following projects:
181# Foo 181# Foo
182# Foo.Bar 182# Foo.Bar
183# If this value is set to True, and the Foo project has a configured color, 183# If this value is set to True, and the Foo project has a configured color,
184# then Foo.Bar would also display Foo's color. 184# then Foo.Bar would also display Foo's color.
185#include_subprojects = True 185#include_subprojects = True
186 186
187# For the Taskwarrior color configuration, there are three special values: 187# For the Taskwarrior color configuration, there are three special values:
188# color.project.none 188# color.project.none
189# color.tag.none 189# color.tag.none
190# color.uda.[uda_name].none 190# color.uda.[uda_name].none
191# If any of these are configured for color, then the label below will be used 191# If any of these are configured for color, then the label below will be used
192# in the related column to display the color configuration. 192# in the related column to display the color configuration.
193#none_label = [NONE] 193#none_label = [NONE]
194 194
195 195
196[keybinding] 196[keybinding]
197 197
198# This section allows you to override the configured keybindings, associate 198# This section allows you to override the configured keybindings, associate
199# additional keybindings with VIT actions, and set up macros triggered by a 199# additional keybindings with VIT actions, and set up macros triggered by a
200# keybinding. 200# keybinding.
201 201
202# Meta keys are enclosed in angle brackets, variables are enclosed in curly 202# Meta keys are enclosed in angle brackets, variables are enclosed in curly
203# brackets. Keybindings here can either be: 203# brackets. Keybindings here can either be:
204# - Associated with a single VIT action 204# - Associated with a single VIT action
205# - A macro that describes a series of key presses to replay 205# - A macro that describes a series of key presses to replay
206 206
207# For VIT actions, the form is: 207# For VIT actions, the form is:
208# keys[,keys] = {ACTION_NAME} 208# keys[,keys] = {ACTION_NAME}
209# For example, to associate the keybinding 'zz' with the undo action: 209# For example, to associate the keybinding 'zz' with the undo action:
210# zz = {ACTION_TASK_UNDO} 210# zz = {ACTION_TASK_UNDO}
211# To only disable a keybinding, use the special noop action: 211# To only disable a keybinding, use the special noop action:
212# w = {ACTION_NOOP} 212# w = {ACTION_NOOP}
213# wa = {ACTION_TASK_WAIT} 213# wa = {ACTION_TASK_WAIT}
214# The above would disable the task wait action for the 'w' key, and instead 214# The above would disable the task wait action for the 'w' key, and instead
215# assign it to the 'wa' keybinding. 215# assign it to the 'wa' keybinding.
216# For capital letter keybindings, use the letter directly: 216# For capital letter keybindings, use the letter directly:
217# D = {ACTION_TASK_DONE} 217# D = {ACTION_TASK_DONE}
218 218
219# For a list of available actions, run 'vit --list-actions'. 219# For a list of available actions, run 'vit --list-actions'.
220# A great reference for many of the available meta keys, and understanding the 220# A great reference for many of the available meta keys, and understanding the
221# default keybindings is the 'keybinding/vi.ini' file. 221# default keybindings is the 'keybinding/vi.ini' file.
222 222
223# For macros, the form is: 223# For macros, the form is:
224# keys[,keys] = keypresses 224# keys[,keys] = keypresses
225# For example, to map the 'o' key to opening the OneNote script, passing it 225# For example, to map the 'o' key to opening the OneNote script, passing it
226# the currently focused task UUID: 226# the currently focused task UUID:
227# o = :!wr onenote {TASK_UUID}<Enter> 227# o = :!wr onenote {TASK_UUID}<Enter>
228 228
229# The special '{TASK_[attribute]}' variable can be used in any macro, and it 229# The special '{TASK_[attribute]}' variable can be used in any macro, and it
230# will be replaced with the value of the attribute for the currently 230# will be replaced with the value of the attribute for the currently
231# highlighted task. Any attribute listed in 'task _columns' is supported, e.g. 231# highlighted task. Any attribute listed in 'task _columns' is supported, e.g.
232# o = :!wr echo project is {TASK_PROJECT}<Enter> 232# o = :!wr echo project is {TASK_PROJECT}<Enter>
233 233
234# Multiple keybindings can be associated with the same action/macro, simply 234# Multiple keybindings can be associated with the same action/macro, simply
235# separate the keybindings with a comma: 235# separate the keybindings with a comma:
236# <Ctrl> z,zz = {ACTION_TASK_UNDO} 236# <Ctrl> z,zz = {ACTION_TASK_UNDO}
237 237
238# 'Special' keys are indicated by enclosing them in brackets. VIT supports the 238# 'Special' keys are indicated by enclosing them in brackets. VIT supports the
239# following special keys on either side of the keybinding declaration, by 239# following special keys on either side of the keybinding declaration, by
240# internally translating them into the single character: 240# internally translating them into the single character:
241# 241#
242# <Colon> 242# <Colon>
243# <Equals> 243# <Equals>
244# <Space> 244# <Space>
245# <Semicolon> 245# <Semicolon>
246# 246#
247# Under the hood, VIT uses the Urwid mappings for keyboard input: 247# Under the hood, VIT uses the Urwid mappings for keyboard input:
248# http://urwid.org/manual/userinput.html 248# http://urwid.org/manual/userinput.html
249# 249#
250# Any modifier, navigation, or function keys can be described in the VIT 250# Any modifier, navigation, or function keys can be described in the VIT
251# keybinding configuration by wrapping them in angle brackets, matching the 251# keybinding configuration by wrapping them in angle brackets, matching the
252# correct Urwid keyboard input structure: 252# correct Urwid keyboard input structure:
253# 253#
254# <Ctrl> e = :!wr echo do something 254# <Ctrl> e = :!wr echo do something
255# <Shift> <Ctrl> <F5> = :!wr echo you used a function key 255# <Shift> <Ctrl> <F5> = :!wr echo you used a function key
256 256