Skip to content

Every config key

One key = value per line in ~/.config/ase/config.ase. See Configuration for the file's shape and how it reloads.

A key written <like this> stands for a family: substitute the part in angle brackets.

A key marked project can also be set in a .ase.conf at the root of a project, which only that project reads.

Key Default Means Project
background #282828 Page colour. #RRGGBB or #RRGGBBAA. —
text #F5E6C8 Text colour. —
selection #45403866 Selection highlight. —
find_match #45403899 The current find/replace match. —
panel_background #282828E6 Floating panels (find, open, help). —
diagnostic_error #E06C75 Language-server error underline. —
diagnostic_warning #E5C07B Language-server warning underline. —
syntax_type #689d6a Types. One of only two syntax colours. —
syntax_string #d79921 String literals. The other one. —
syntax_keyword_bold true Draw keywords bold. —
syntax_type_italic false Draw types italic, as well as coloured. —
syntax_comment_opacity 57 How strongly comments read, 0-100. —
syntax_number_opacity 78 How strongly numbers read, 0-100. —
font_family monospace Editor font. —
font_size 11 Point size. Ctrl+= / Ctrl+- override it live. —
vim_mode true Modal editing. false for always-insert. —
animations false true for a smooth caret fade instead of a blink. —
line_numbers absolute off, absolute, or relative. —
auto_indent true A new line starts where the one above it started. —
theme ase-default Colour palette. :theme lists them, including your own from /themes/*.ase. —
max_fps unset Cap the animation rate; unset follows the display. —
build_command unset :compile runs this; %f is the current file. —
lsp_command unset Language server for any language without its own. —
syntax_max_kb 4096 Skip highlighting past this file size, in KB. Bounds memory, not lag: the parse is on its own thread. —
restore_session true Reopen last session's files when started bare. —
git_marks true Gutter bars for lines changed since the last commit. —
key.<chord> unset Run a command on a chord, e.g. key.ctrl+s = editor.save. —
vim.<key> unset Make a Normal/Visual key stand for other keys, e.g. vim.normal.Y = y$. Also vim.normal. and vim.visual.. —
lang.<id>.lsp unset Language server for one language, e.g. lang.cpp.lsp. —
filetype.<suffix> unset What a suffix means, e.g. filetype.h = cpp. yes

Built-in themes

theme = <name>, or :theme <name> to see it before you keep it. A theme sets the nine colours above; anything you set by hand stays yours.

Name Is
ase-default Warm cream on near-black
simple-nord Nord's Polar Night and Snow Storm, with one Frost and one Aurora
simple-sola Solarized Dark, down to base03, base1, cyan and yellow