Editor Settings
Utterly Voice Editor settings are found in the
config\editor.yaml
file found in the application directory.
This file has the following settings:
| Setting |
Type |
Description |
navigatorFavorites
|
List Collection |
List of strings which provide favorite folders shown when
you say "open navigator".
Add any folders that you frequently access when opening files.
|
tabSize
|
Number |
The displayed width of a tab character.
|
fontSize
|
Number |
Text font size.
|
fonts
|
List Collection |
Ordered list of font path strings.
The first font to correctly load in this list is used.
|
backgroundColorHex
|
String |
The hex color of the panel background.
|
backgroundAlternateColorHex
|
String |
The alternate hex color of the panel background alternating shading.
|
foregroundColorHex
|
String |
The hex color of the text.
|
cursorColorHex
|
String |
The hex color of the cursor.
|
selectionColorHex
|
String |
The hex color of selected text background.
|
highlightColorHex
|
String |
The hex color of the highlighted text background (find, replace, etc.).
|
metaHBackgroundColorHex
|
String |
The hex color of the metadata horizontal top and bottom bars background.
|
metaHForegroundColorHex
|
String |
The hex color of the metadata horizontal top and bottom bars foreground.
|
metaVBackgroundColorHex
|
String |
The hex color of the metadata vertical left and right gutters background.
|
metaVForegroundColorHex
|
String |
The hex color of the metadata vertical left and right gutters foreground.
|
commandPromptColorHex
|
String |
The hex color of the command prompts (example "Gemini>").
|
filePermissionsColorHex
|
String |
The hex color of the file permissions in the navigator.
|
folderNameColorHex
|
String |
The hex color of folder names in the navigator.
|
fileNameColorHex
|
String |
The hex color of the file names in the navigator.
|
gemini
|
Map Collection |
Settings specific to Gemini.
See Gemini below.
|
codeStyle
|
String |
The code style used for foreground colors of code files.
For supported options see the
options here.
For example, here are some recommended dark themes:
"fruity", "navy", "rrt", "github-dark", "xcode-dark".
|
code
|
List Collection |
Settings specific to code languages.
See Code below.
|
Gemini 
Settings for the recommended but optional integration with Gemini API
Generative AI.
| Setting |
Type |
Description |
apiKeySecret
|
String |
API key you acquired from Google.
Keep this key private and secure.
More info.
|
model
|
String |
Gemini model you want to use.
More info.
|
timeoutSeconds
|
Number |
Timeout for Gemini requests.
|
maximumHistory
|
Number |
Each conversational turn with the model results in at least two history messages:
a query from you and a response from the model.
There may be more messages during a turn when tools are called for file reading,
file writing, or web page fetches.
These messages are saved in history and provided as context to the model
in each new query. If this history is unbounded, you can exceed token limits
for the model, or significantly increase cost for the session.
Set this value to the maximum number of messages that should be saved in history.
We recommend values in the range 20-40.
Lower values reduce cost but limit conversation context.
Higher values increase cost but enhance conversation context.
|
systemInstructions
|
String |
System instructions provided as a preamble to every prompt.
Note that the tools provided to the model do not actually have file access,
but the model thinks it does.
This uses free-form XML, which is not required,
but does improve reliability slightly.
All user queries are wrapped in
<user_input>...</user_input>
by the application.
|
Code
Advanced language-specific settings for code editing.
These settings are only applied when a file suffix matches one of the
listed suffixes.
Automatic indentation only occurs when pressing the enter key,
and it only depends on regular expression matches
before and after the newly inserted newline character.
This keeps indentation predictable and configurable,
which is important for dictating code by voice.
Rule matches are attempted in order.
If a rule matches, remaining rules are ignored.
| Setting |
Type |
Description |
name
|
String |
The name of the language (e.g., "Go").
|
suffixes
|
List Collection |
List of string suffixes that identify files for this language.
|
postSaveCommand
|
String |
After a file is successfully saved, the optional postSaveCommand
is executed with "{file}" replaced with the absolute path to the saved file.
|
lineComment
|
String |
The syntax used for line comments (e.g., "// ").
|
blockCommentStart
|
String |
The syntax used to start block comments (e.g., "/* ").
|
blockCommentFinish
|
String |
The syntax used to finish block comments (e.g., " */").
|
indentationUnit
|
String |
The string representing one unit of indentation (e.g., "\t" or " ").
|
indentationRules
|
List Collection |
Optional rules for automatic indentation.
See Indentation Rules below.
|
Indentation Rules
| Setting |
Type |
Description |
indent
|
Number |
The number of indentation units to add or remove relative to the previous line.
|
whenPreviousLineMatches
|
String |
A regular expression that must match the line before
the newly inserted newline character.
Either one or both of the fields
whenPreviousLineMatches and whenNextLineMatches
must be supplied.
|
whenNextLineMatches
|
String |
A regular expression that must match the line after
the newly inserted newline character.
|
