2017-01-06 14:16:57 -05:00
|
|
|
# Configuration for Alacritty, the GPU enhanced terminal emulator
|
2017-02-13 21:22:59 -05:00
|
|
|
|
|
|
|
# Any items in the `env` entry below will be added as
|
|
|
|
# environment variables. Some entries may override variables
|
|
|
|
# set by alacritty it self.
|
|
|
|
env:
|
2017-04-21 19:24:54 -04:00
|
|
|
# TERM env customization.
|
|
|
|
#
|
|
|
|
# If this property is not set, alacritty will set it to xterm-256color.
|
|
|
|
#
|
|
|
|
# Note that some xterm terminfo databases don't declare support for italics.
|
|
|
|
# You can verify this by checking for the presence of `smso` and `sitm` in
|
|
|
|
# `infocmp xterm-256color`.
|
2017-02-13 21:22:59 -05:00
|
|
|
TERM: xterm-256color
|
|
|
|
|
2017-12-20 14:30:22 -05:00
|
|
|
window:
|
|
|
|
# Window dimensions in character columns and lines
|
|
|
|
# (changes require restart)
|
|
|
|
dimensions:
|
|
|
|
columns: 80
|
|
|
|
lines: 24
|
|
|
|
|
|
|
|
# Adds this many blank pixels of padding around the window
|
|
|
|
# Units are physical pixels; this is not DPI aware.
|
|
|
|
# (change requires restart)
|
|
|
|
padding:
|
|
|
|
x: 2
|
|
|
|
y: 2
|
|
|
|
|
|
|
|
# Window decorations
|
2018-09-20 11:24:26 -04:00
|
|
|
# Available values:
|
|
|
|
# - `full`: Window with title bar and title bar buttons
|
|
|
|
# - `none`: Window without title bar, rounded corners, or drop shadow
|
|
|
|
# - `transparent`: Window with title bar with transparent background and title
|
|
|
|
# bar buttons
|
|
|
|
# - `buttonless`: Window with title bar with transparent background and no
|
|
|
|
# title bar buttons
|
|
|
|
decorations: full
|
2017-05-06 11:45:23 -04:00
|
|
|
|
2018-03-09 13:45:40 -05:00
|
|
|
scrolling:
|
|
|
|
# How many lines of scrollback to keep,
|
|
|
|
# '0' will disable scrolling.
|
|
|
|
history: 10000
|
|
|
|
|
|
|
|
# Number of lines the viewport will move for every line
|
|
|
|
# scrolled when scrollback is enabled (history > 0).
|
|
|
|
multiplier: 3
|
|
|
|
|
|
|
|
# Faux Scrolling
|
|
|
|
#
|
|
|
|
# The `faux_multiplier` setting controls the number
|
|
|
|
# of lines the terminal should scroll when the alternate
|
|
|
|
# screen buffer is active. This is used to allow mouse
|
|
|
|
# scrolling for applications like `man`.
|
|
|
|
#
|
|
|
|
# To disable this completely, set `faux_multiplier` to 0.
|
|
|
|
faux_multiplier: 3
|
2018-02-16 20:54:32 -05:00
|
|
|
|
2018-03-22 20:01:55 -04:00
|
|
|
# Automatically scroll to the bottom when new text is written
|
|
|
|
# to the terminal.
|
|
|
|
auto_scroll: false
|
|
|
|
|
2018-09-18 16:20:59 -04:00
|
|
|
# Spaces per Tab
|
|
|
|
#
|
|
|
|
# This setting defines the width of a tab in cells. Changes to this
|
|
|
|
# value require a restart to take effect.
|
|
|
|
#
|
|
|
|
# Some applications, like Emacs, rely on knowing about the width of a tab.
|
|
|
|
# To prevent unexpected behavior in these applications, it's also required to
|
|
|
|
# change the `it` value in terminfo when altering this setting.
|
2017-01-06 14:16:57 -05:00
|
|
|
tabspaces: 8
|
|
|
|
|
|
|
|
# When true, bold text is drawn using the bright variant of colors.
|
|
|
|
draw_bold_text_with_bright_colors: true
|
|
|
|
|
|
|
|
# Font configuration (changes require restart)
|
|
|
|
font:
|
|
|
|
# The normal (roman) font face to use.
|
|
|
|
normal:
|
|
|
|
family: Menlo
|
|
|
|
# Style can be specified to pick a specific face.
|
|
|
|
# style: Regular
|
|
|
|
|
|
|
|
# The bold font face
|
|
|
|
bold:
|
|
|
|
family: Menlo
|
|
|
|
# Style can be specified to pick a specific face.
|
|
|
|
# style: Bold
|
|
|
|
|
|
|
|
# The italic font face
|
|
|
|
italic:
|
|
|
|
family: Menlo
|
|
|
|
# Style can be specified to pick a specific face.
|
|
|
|
# style: Italic
|
|
|
|
|
|
|
|
# Point size of the font
|
|
|
|
size: 12.0
|
2017-01-15 12:38:04 -05:00
|
|
|
|
2017-01-06 14:16:57 -05:00
|
|
|
# Offset is the extra space around each character. offset.y can be thought of
|
|
|
|
# as modifying the linespacing, and offset.x as modifying the letter spacing.
|
|
|
|
offset:
|
2018-03-13 02:07:40 -04:00
|
|
|
x: 0
|
|
|
|
y: 0
|
2017-01-06 14:16:57 -05:00
|
|
|
|
2017-01-15 12:38:04 -05:00
|
|
|
# Glyph offset determines the locations of the glyphs within their cells with
|
|
|
|
# the default being at the bottom. Increase the x offset to move the glyph to
|
|
|
|
# the right, increase the y offset to move the glyph upward.
|
|
|
|
glyph_offset:
|
2018-03-13 02:07:40 -04:00
|
|
|
x: 0
|
|
|
|
y: 0
|
2017-01-15 12:38:04 -05:00
|
|
|
|
2018-07-21 13:17:41 -04:00
|
|
|
# Scale the font size based on the monitor's DPI. This will lead to bigger text on HiDPI
|
|
|
|
# screens and make reading text a little easier.
|
|
|
|
scale_with_dpi: true
|
|
|
|
|
2017-01-10 08:58:54 -05:00
|
|
|
# OS X only: use thin stroke font rendering. Thin strokes are suitable
|
|
|
|
# for retina displays, but for non-retina you probably want this set to
|
|
|
|
# false.
|
|
|
|
use_thin_strokes: true
|
|
|
|
|
2017-01-06 14:16:57 -05:00
|
|
|
# Should display the render timer
|
|
|
|
render_timer: false
|
|
|
|
|
2017-01-08 22:18:39 -05:00
|
|
|
# Use custom cursor colors. If true, display the cursor in the cursor.foreground
|
|
|
|
# and cursor.background colors, otherwise invert the colors of the cursor.
|
|
|
|
custom_cursor_colors: false
|
|
|
|
|
2017-01-06 14:16:57 -05:00
|
|
|
# Colors (Tomorrow Night Bright)
|
|
|
|
colors:
|
|
|
|
# Default colors
|
|
|
|
primary:
|
|
|
|
background: '0x000000'
|
|
|
|
foreground: '0xeaeaea'
|
2017-02-10 12:15:36 -05:00
|
|
|
|
Merge master into scrollback
* Allow disabling DPI scaling
This makes it possible to disable DPI scaling completely, instead the
the display pixel ration will always be fixed to 1.0.
By default nothing has changed and DPI is still enabled, this just seems
like a better way than running `WINIT_HIDPI_FACTOR=1.0 alacritty` every
time the user wants to start alacritty.
It would be possible to allow specifying any DPR, however I've decided
against this since I'd assume it's a very rare usecase. It's also still
possible to make use of `WINIT_HIDPI_FACTOR` to do this on X11.
Currently this is not updated at runtime using the live config update,
there is not really much of a technical limitation why this woudn't be
possible, however a solution for that issue should be first added in
jwilm/alacritty#1346, once a system is established for changing DPI at
runtime, porting that functionality to this PR should be simple.
* Add working --class and --title CLI parameters
* Reduce Increase-/DecreaseFontSize step to 0.5
Until now the Increase-/DecreaseFontSize keybinds hand a step size of 1.0. Since the font size however is multiplied by two to allow more granular font size control, this lead to the bindings skipping one font size (incrementing/decrementing by +-2).
To fix this the step size of the Increase-/DecreaseFontSize bindings has been reduced to the minimum step size that exists with the current font configuration (0.5). This should allow users to increment and decrement the font size by a single point instead of two.
This also adds a few tests to make sure the methods for increasing/decreasing/resetting font size work properly.
* Add Copy/Cut/Paste keys
This just adds support for the Copy/Cut/Paste keys and sets up
Copy/Paste as alternative defaults for Ctrl+Shift+C/V.
* Move to cargo clippy
Using clippy as a library has been deprecated, instead the `cargo
clippy` command should be used instead. To comply with this change
clippy has been removed from the `Cargo.toml` and is now installed with
cargo when building in CI.
This has also lead to a few new clippy issues to show up, this includes
everything in the `font` subdirectory. This has been fixed and `font`
should now be covered by clippy CI too.
This also upgrades all dependencies, as a result this fixes #1341 and
this fixes #1344.
* Override dynamic_title when --title is specified
* Change green implementation to use the macro
* Ignore mouse input if window is unfocused
* Make compilation of binary a phony target
* Add opensuse zypper install method to readme
* Fix clippy issues
* Update manpage to document all CLI options
The introduction of `--class` has added a flag to the CLI without adding
it to the manpage. This has been fixed by updating the manpage.
This also adds the default values of `--class` and `--title` to the CLI
options.
* Remove unnecessary clippy lint annotations
We moved to "cargo clippy" in 5ba34d4f9766a55a06ed5e3e44cc384af1b09f65 and
removing the clippy lint annotations in `src/lib.rs` does not cause any additional warnings.
This also changes `cargo clippy` to use the flags required for checking integration tests.
* Enable clippy in font/copypasta crates
Enabled clippy in the sub-crates font and copypasta. All issues
that were discovered by this change have also been fixed.
* Remove outdated comment about NixOS
* Replace debug asserts with static_assertions
To check that transmutes will work correctly without having to rely on
error-prone runtime checking, the `static_assertions` crate has been
introduced. This allows comparing the size of types at compile time,
preventing potentially silent breakage.
This fixes #1417.
* Add `cargo deb` build instructions
Updated the `Cargo.toml` file and added a `package.metadata.deb`
subsection to define how to build a debian "deb" install file using
`cargo deb`. This will allow debian/ubuntu users to install `alacritty`
using their system's package manager. It also will make it easier to
provide pre-built binaries for those systems.
Also fixed a stray debug line in the bash autocomplete script that was
writting to a tempfile.
* Add config for unfocused window cursor change
* Add support for cursor shape escape sequence
* Add bright foreground color option
It was requested in jwilm/alacritty#825 that it should be possible to
add an optional bright foreground color.
This is now added to the primary colors structure and allows the user to
set a foreground color for bold normal text. This has no effect unless
the draw_bold_text_with_bright_colors option is also enabled.
If the color is not specified, the bright foreground color will fall
back to the normal foreground color.
This fixes #825.
* Fix clone URL in deb install instructions
* Fix 'cargo-deb' desktop file name
* Remove redundant dependency from deb build
* Switch from deprecated `std::env::home_dir` to `dirs::home_dir`
* Allow specifying modifiers for mouse bindings
* Send newline with NumpadEnter
* Add support for LCD-V pixel mode
* Add binding action for hiding the window
* Switch to rustup clippy component
* Add optional dim foreground color
Add optional color for the dim foreground (`\e[2m;`)
Defaults to 2/3 of the foreground color. (same as other colors).
If a bright color is dimmed, it's displayed as the normal color. The
exception for this is when the bright foreground is dimmed when no
bright foreground color is set. In that case it's treated as a normal
foreground color and dimmed to DimForeground.
To minimize the surprise for the user, the bright and dim colors have
been completely removed from the default configuration file.
Some documentation has also been added to make it clear to users what
these options can be used for.
This fixes #1448.
* Fix clippy lints and run font tests on travis
This fixes some existing clippy issues and runs the `font` tests through travis.
Testing of copypasta crate was omitted due to problens when running on headless travis-ci environment (x11 clipboard would fail).
* Ignore errors when logger can't write to output
The (e)print macro will panic when there is no output available to
write to, however in our scenario where we only log user errors to
stderr, the better choice would be to ignore when writing to stdout or
stderr is not possible.
This changes the (e)print macro to make use of `write` and ignore
any potential errors.
Since (e)println rely on (e)print, this also solves potential failuers
when calling (e)println.
With this change implemented, all of logging, (e)println and (e)print
should never fail even if the stdout/stderr is not available.
2018-07-28 19:10:13 -04:00
|
|
|
# (Optional) Bright and Dim foreground colors
|
|
|
|
#
|
|
|
|
# The dimmed foreground color is calculated automatically if it is not present.
|
|
|
|
# If the bright foreground color is not set, or `draw_bold_text_with_bright_colors`
|
|
|
|
# is `false`, the normal foreground color will be used.
|
|
|
|
#
|
|
|
|
# dim_foreground: '0x9a9a9a'
|
|
|
|
# bright_foreground: '0xffffff'
|
|
|
|
|
2017-02-10 12:15:36 -05:00
|
|
|
# Colors the cursor will use if `custom_cursor_colors` is true
|
2017-01-08 22:18:39 -05:00
|
|
|
cursor:
|
2017-02-24 11:23:07 -05:00
|
|
|
text: '0x000000'
|
|
|
|
cursor: '0xffffff'
|
2017-01-06 14:16:57 -05:00
|
|
|
|
|
|
|
# Normal colors
|
|
|
|
normal:
|
|
|
|
black: '0x000000'
|
|
|
|
red: '0xd54e53'
|
|
|
|
green: '0xb9ca4a'
|
|
|
|
yellow: '0xe6c547'
|
|
|
|
blue: '0x7aa6da'
|
|
|
|
magenta: '0xc397d8'
|
|
|
|
cyan: '0x70c0ba'
|
2017-05-27 23:02:56 -04:00
|
|
|
white: '0xffffff'
|
2017-01-06 14:16:57 -05:00
|
|
|
|
|
|
|
# Bright colors
|
|
|
|
bright:
|
|
|
|
black: '0x666666'
|
|
|
|
red: '0xff3334'
|
|
|
|
green: '0x9ec400'
|
|
|
|
yellow: '0xe7c547'
|
|
|
|
blue: '0x7aa6da'
|
|
|
|
magenta: '0xb77ee0'
|
|
|
|
cyan: '0x54ced6'
|
2017-05-27 23:02:56 -04:00
|
|
|
white: '0xffffff'
|
2017-01-06 14:16:57 -05:00
|
|
|
|
2017-06-23 13:01:53 -04:00
|
|
|
# Dim colors (Optional)
|
|
|
|
dim:
|
2017-09-02 10:14:26 -04:00
|
|
|
black: '0x333333'
|
|
|
|
red: '0xf2777a'
|
|
|
|
green: '0x99cc99'
|
|
|
|
yellow: '0xffcc66'
|
|
|
|
blue: '0x6699cc'
|
|
|
|
magenta: '0xcc99cc'
|
|
|
|
cyan: '0x66cccc'
|
|
|
|
white: '0xdddddd'
|
2017-06-23 13:01:53 -04:00
|
|
|
|
|
|
|
|
2017-02-10 12:15:36 -05:00
|
|
|
# Visual Bell
|
|
|
|
#
|
|
|
|
# Any time the BEL code is received, Alacritty "rings" the visual bell. Once
|
|
|
|
# rung, the terminal background will be set to white and transition back to the
|
|
|
|
# default background color. You can control the rate of this transition by
|
|
|
|
# setting the `duration` property (represented in milliseconds). You can also
|
|
|
|
# configure the transition function by setting the `animation` property.
|
|
|
|
#
|
|
|
|
# Possible values for `animation`
|
|
|
|
# `Ease`
|
|
|
|
# `EaseOut`
|
|
|
|
# `EaseOutSine`
|
|
|
|
# `EaseOutQuad`
|
|
|
|
# `EaseOutCubic`
|
|
|
|
# `EaseOutQuart`
|
|
|
|
# `EaseOutQuint`
|
|
|
|
# `EaseOutExpo`
|
|
|
|
# `EaseOutCirc`
|
|
|
|
# `Linear`
|
2017-01-06 14:16:57 -05:00
|
|
|
#
|
2017-02-10 12:15:36 -05:00
|
|
|
# To completely disable the visual bell, set its duration to 0.
|
2017-01-06 14:16:57 -05:00
|
|
|
#
|
2017-02-10 12:15:36 -05:00
|
|
|
visual_bell:
|
|
|
|
animation: EaseOutExpo
|
2017-02-11 23:42:58 -05:00
|
|
|
duration: 0
|
2017-01-06 14:16:57 -05:00
|
|
|
|
2017-08-20 12:55:45 -04:00
|
|
|
# Background opacity
|
|
|
|
background_opacity: 1.0
|
|
|
|
|
2017-10-20 10:59:28 -04:00
|
|
|
# Mouse bindings
|
|
|
|
#
|
|
|
|
# Currently doesn't support modifiers. Both the `mouse` and `action` fields must
|
|
|
|
# be specified.
|
|
|
|
#
|
|
|
|
# Values for `mouse`:
|
|
|
|
# - Middle
|
|
|
|
# - Left
|
|
|
|
# - Right
|
|
|
|
# - Numeric identifier such as `5`
|
|
|
|
#
|
|
|
|
# Values for `action`:
|
|
|
|
# - Paste
|
|
|
|
# - PasteSelection
|
|
|
|
# - Copy (TODO)
|
|
|
|
mouse_bindings:
|
|
|
|
- { mouse: Middle, action: PasteSelection }
|
|
|
|
|
|
|
|
mouse:
|
2017-12-29 12:37:46 -05:00
|
|
|
# Click settings
|
|
|
|
#
|
|
|
|
# The `double_click` and `triple_click` settings control the time
|
|
|
|
# alacritty should wait for accepting multiple clicks as one double
|
|
|
|
# or triple click.
|
2017-10-20 10:59:28 -04:00
|
|
|
double_click: { threshold: 300 }
|
|
|
|
triple_click: { threshold: 300 }
|
2017-12-29 12:37:46 -05:00
|
|
|
|
2017-10-20 10:59:28 -04:00
|
|
|
selection:
|
|
|
|
semantic_escape_chars: ",│`|:\"' ()[]{}<>"
|
|
|
|
|
2017-12-24 13:24:28 -05:00
|
|
|
dynamic_title: true
|
|
|
|
|
2017-10-20 10:59:28 -04:00
|
|
|
hide_cursor_when_typing: false
|
|
|
|
|
2017-12-03 16:38:42 -05:00
|
|
|
# Style of the cursor
|
|
|
|
#
|
|
|
|
# Values for 'cursor_style':
|
|
|
|
# - Block
|
|
|
|
# - Underline
|
|
|
|
# - Beam
|
|
|
|
cursor_style: Block
|
|
|
|
|
Merge master into scrollback
* Allow disabling DPI scaling
This makes it possible to disable DPI scaling completely, instead the
the display pixel ration will always be fixed to 1.0.
By default nothing has changed and DPI is still enabled, this just seems
like a better way than running `WINIT_HIDPI_FACTOR=1.0 alacritty` every
time the user wants to start alacritty.
It would be possible to allow specifying any DPR, however I've decided
against this since I'd assume it's a very rare usecase. It's also still
possible to make use of `WINIT_HIDPI_FACTOR` to do this on X11.
Currently this is not updated at runtime using the live config update,
there is not really much of a technical limitation why this woudn't be
possible, however a solution for that issue should be first added in
jwilm/alacritty#1346, once a system is established for changing DPI at
runtime, porting that functionality to this PR should be simple.
* Add working --class and --title CLI parameters
* Reduce Increase-/DecreaseFontSize step to 0.5
Until now the Increase-/DecreaseFontSize keybinds hand a step size of 1.0. Since the font size however is multiplied by two to allow more granular font size control, this lead to the bindings skipping one font size (incrementing/decrementing by +-2).
To fix this the step size of the Increase-/DecreaseFontSize bindings has been reduced to the minimum step size that exists with the current font configuration (0.5). This should allow users to increment and decrement the font size by a single point instead of two.
This also adds a few tests to make sure the methods for increasing/decreasing/resetting font size work properly.
* Add Copy/Cut/Paste keys
This just adds support for the Copy/Cut/Paste keys and sets up
Copy/Paste as alternative defaults for Ctrl+Shift+C/V.
* Move to cargo clippy
Using clippy as a library has been deprecated, instead the `cargo
clippy` command should be used instead. To comply with this change
clippy has been removed from the `Cargo.toml` and is now installed with
cargo when building in CI.
This has also lead to a few new clippy issues to show up, this includes
everything in the `font` subdirectory. This has been fixed and `font`
should now be covered by clippy CI too.
This also upgrades all dependencies, as a result this fixes #1341 and
this fixes #1344.
* Override dynamic_title when --title is specified
* Change green implementation to use the macro
* Ignore mouse input if window is unfocused
* Make compilation of binary a phony target
* Add opensuse zypper install method to readme
* Fix clippy issues
* Update manpage to document all CLI options
The introduction of `--class` has added a flag to the CLI without adding
it to the manpage. This has been fixed by updating the manpage.
This also adds the default values of `--class` and `--title` to the CLI
options.
* Remove unnecessary clippy lint annotations
We moved to "cargo clippy" in 5ba34d4f9766a55a06ed5e3e44cc384af1b09f65 and
removing the clippy lint annotations in `src/lib.rs` does not cause any additional warnings.
This also changes `cargo clippy` to use the flags required for checking integration tests.
* Enable clippy in font/copypasta crates
Enabled clippy in the sub-crates font and copypasta. All issues
that were discovered by this change have also been fixed.
* Remove outdated comment about NixOS
* Replace debug asserts with static_assertions
To check that transmutes will work correctly without having to rely on
error-prone runtime checking, the `static_assertions` crate has been
introduced. This allows comparing the size of types at compile time,
preventing potentially silent breakage.
This fixes #1417.
* Add `cargo deb` build instructions
Updated the `Cargo.toml` file and added a `package.metadata.deb`
subsection to define how to build a debian "deb" install file using
`cargo deb`. This will allow debian/ubuntu users to install `alacritty`
using their system's package manager. It also will make it easier to
provide pre-built binaries for those systems.
Also fixed a stray debug line in the bash autocomplete script that was
writting to a tempfile.
* Add config for unfocused window cursor change
* Add support for cursor shape escape sequence
* Add bright foreground color option
It was requested in jwilm/alacritty#825 that it should be possible to
add an optional bright foreground color.
This is now added to the primary colors structure and allows the user to
set a foreground color for bold normal text. This has no effect unless
the draw_bold_text_with_bright_colors option is also enabled.
If the color is not specified, the bright foreground color will fall
back to the normal foreground color.
This fixes #825.
* Fix clone URL in deb install instructions
* Fix 'cargo-deb' desktop file name
* Remove redundant dependency from deb build
* Switch from deprecated `std::env::home_dir` to `dirs::home_dir`
* Allow specifying modifiers for mouse bindings
* Send newline with NumpadEnter
* Add support for LCD-V pixel mode
* Add binding action for hiding the window
* Switch to rustup clippy component
* Add optional dim foreground color
Add optional color for the dim foreground (`\e[2m;`)
Defaults to 2/3 of the foreground color. (same as other colors).
If a bright color is dimmed, it's displayed as the normal color. The
exception for this is when the bright foreground is dimmed when no
bright foreground color is set. In that case it's treated as a normal
foreground color and dimmed to DimForeground.
To minimize the surprise for the user, the bright and dim colors have
been completely removed from the default configuration file.
Some documentation has also been added to make it clear to users what
these options can be used for.
This fixes #1448.
* Fix clippy lints and run font tests on travis
This fixes some existing clippy issues and runs the `font` tests through travis.
Testing of copypasta crate was omitted due to problens when running on headless travis-ci environment (x11 clipboard would fail).
* Ignore errors when logger can't write to output
The (e)print macro will panic when there is no output available to
write to, however in our scenario where we only log user errors to
stderr, the better choice would be to ignore when writing to stdout or
stderr is not possible.
This changes the (e)print macro to make use of `write` and ignore
any potential errors.
Since (e)println rely on (e)print, this also solves potential failuers
when calling (e)println.
With this change implemented, all of logging, (e)println and (e)print
should never fail even if the stdout/stderr is not available.
2018-07-28 19:10:13 -04:00
|
|
|
# Whether the cursor should be a hollow block on window focus loss
|
|
|
|
unfocused_hollow_cursor: true
|
|
|
|
|
2017-10-20 10:59:28 -04:00
|
|
|
# Live config reload (changes require restart)
|
|
|
|
live_config_reload: true
|
|
|
|
|
|
|
|
# Shell
|
|
|
|
#
|
|
|
|
# You can set shell.program to the path of your favorite shell, e.g. /bin/fish.
|
|
|
|
# Entries in shell.args are passed unmodified as arguments to the shell.
|
|
|
|
#
|
|
|
|
# shell:
|
|
|
|
# program: /bin/bash
|
|
|
|
# args:
|
|
|
|
# - --login
|
|
|
|
|
2017-01-06 14:16:57 -05:00
|
|
|
# Key bindings
|
|
|
|
#
|
|
|
|
# Each binding is defined as an object with some properties. Most of the
|
|
|
|
# properties are optional. All of the alphabetical keys should have a letter for
|
|
|
|
# the `key` value such as `V`. Function keys are probably what you would expect
|
|
|
|
# as well (F1, F2, ..). The number keys above the main keyboard are encoded as
|
|
|
|
# `Key1`, `Key2`, etc. Keys on the number pad are encoded `Number1`, `Number2`,
|
|
|
|
# etc. These all match the glutin::VirtualKeyCode variants.
|
|
|
|
#
|
2018-01-10 13:36:34 -05:00
|
|
|
# A list with all available `key` names can be found here:
|
|
|
|
# https://docs.rs/glutin/*/glutin/enum.VirtualKeyCode.html#variants
|
|
|
|
#
|
2017-01-06 14:16:57 -05:00
|
|
|
# Possible values for `mods`
|
|
|
|
# `Command`, `Super` refer to the super/command/windows key
|
|
|
|
# `Control` for the control key
|
|
|
|
# `Shift` for the Shift key
|
|
|
|
# `Alt` and `Option` refer to alt/option
|
|
|
|
#
|
|
|
|
# mods may be combined with a `|`. For example, requiring control and shift
|
|
|
|
# looks like:
|
|
|
|
#
|
|
|
|
# mods: Control|Shift
|
|
|
|
#
|
|
|
|
# The parser is currently quite sensitive to whitespace and capitalization -
|
|
|
|
# capitalization must match exactly, and piped items must not have whitespace
|
|
|
|
# around them.
|
|
|
|
#
|
2017-07-01 23:38:14 -04:00
|
|
|
# Either an `action`, `chars`, or `command` field must be present.
|
2018-03-10 14:24:10 -05:00
|
|
|
# `action` must be one of the following:
|
|
|
|
# - `Paste`
|
|
|
|
# - `PasteSelection`
|
|
|
|
# - `Copy`
|
|
|
|
# - `IncreaseFontSize`
|
|
|
|
# - `DecreaseFontSize`
|
|
|
|
# - `ResetFontSize`
|
|
|
|
# - `ScrollPageUp`
|
|
|
|
# - `ScrollPageDown`
|
|
|
|
# - `ScrollToTop`
|
|
|
|
# - `ScrollToBottom`
|
|
|
|
# - `Quit`
|
2017-07-01 23:38:14 -04:00
|
|
|
# `chars` writes the specified string every time that binding is activated.
|
|
|
|
# These should generally be escape sequences, but they can be configured to
|
|
|
|
# send arbitrary strings of bytes.
|
|
|
|
# `command` must be a map containing a `program` string, and `args` array of
|
|
|
|
# strings. For example:
|
|
|
|
# - { ... , command: { program: "alacritty", args: ["-e", "vttest"] } }
|
2017-01-06 14:16:57 -05:00
|
|
|
key_bindings:
|
|
|
|
- { key: V, mods: Command, action: Paste }
|
|
|
|
- { key: C, mods: Command, action: Copy }
|
2018-07-21 13:17:41 -04:00
|
|
|
- { key: Paste, action: Paste }
|
|
|
|
- { key: Copy, action: Copy }
|
Merge master into scrollback
* Allow disabling DPI scaling
This makes it possible to disable DPI scaling completely, instead the
the display pixel ration will always be fixed to 1.0.
By default nothing has changed and DPI is still enabled, this just seems
like a better way than running `WINIT_HIDPI_FACTOR=1.0 alacritty` every
time the user wants to start alacritty.
It would be possible to allow specifying any DPR, however I've decided
against this since I'd assume it's a very rare usecase. It's also still
possible to make use of `WINIT_HIDPI_FACTOR` to do this on X11.
Currently this is not updated at runtime using the live config update,
there is not really much of a technical limitation why this woudn't be
possible, however a solution for that issue should be first added in
jwilm/alacritty#1346, once a system is established for changing DPI at
runtime, porting that functionality to this PR should be simple.
* Add working --class and --title CLI parameters
* Reduce Increase-/DecreaseFontSize step to 0.5
Until now the Increase-/DecreaseFontSize keybinds hand a step size of 1.0. Since the font size however is multiplied by two to allow more granular font size control, this lead to the bindings skipping one font size (incrementing/decrementing by +-2).
To fix this the step size of the Increase-/DecreaseFontSize bindings has been reduced to the minimum step size that exists with the current font configuration (0.5). This should allow users to increment and decrement the font size by a single point instead of two.
This also adds a few tests to make sure the methods for increasing/decreasing/resetting font size work properly.
* Add Copy/Cut/Paste keys
This just adds support for the Copy/Cut/Paste keys and sets up
Copy/Paste as alternative defaults for Ctrl+Shift+C/V.
* Move to cargo clippy
Using clippy as a library has been deprecated, instead the `cargo
clippy` command should be used instead. To comply with this change
clippy has been removed from the `Cargo.toml` and is now installed with
cargo when building in CI.
This has also lead to a few new clippy issues to show up, this includes
everything in the `font` subdirectory. This has been fixed and `font`
should now be covered by clippy CI too.
This also upgrades all dependencies, as a result this fixes #1341 and
this fixes #1344.
* Override dynamic_title when --title is specified
* Change green implementation to use the macro
* Ignore mouse input if window is unfocused
* Make compilation of binary a phony target
* Add opensuse zypper install method to readme
* Fix clippy issues
* Update manpage to document all CLI options
The introduction of `--class` has added a flag to the CLI without adding
it to the manpage. This has been fixed by updating the manpage.
This also adds the default values of `--class` and `--title` to the CLI
options.
* Remove unnecessary clippy lint annotations
We moved to "cargo clippy" in 5ba34d4f9766a55a06ed5e3e44cc384af1b09f65 and
removing the clippy lint annotations in `src/lib.rs` does not cause any additional warnings.
This also changes `cargo clippy` to use the flags required for checking integration tests.
* Enable clippy in font/copypasta crates
Enabled clippy in the sub-crates font and copypasta. All issues
that were discovered by this change have also been fixed.
* Remove outdated comment about NixOS
* Replace debug asserts with static_assertions
To check that transmutes will work correctly without having to rely on
error-prone runtime checking, the `static_assertions` crate has been
introduced. This allows comparing the size of types at compile time,
preventing potentially silent breakage.
This fixes #1417.
* Add `cargo deb` build instructions
Updated the `Cargo.toml` file and added a `package.metadata.deb`
subsection to define how to build a debian "deb" install file using
`cargo deb`. This will allow debian/ubuntu users to install `alacritty`
using their system's package manager. It also will make it easier to
provide pre-built binaries for those systems.
Also fixed a stray debug line in the bash autocomplete script that was
writting to a tempfile.
* Add config for unfocused window cursor change
* Add support for cursor shape escape sequence
* Add bright foreground color option
It was requested in jwilm/alacritty#825 that it should be possible to
add an optional bright foreground color.
This is now added to the primary colors structure and allows the user to
set a foreground color for bold normal text. This has no effect unless
the draw_bold_text_with_bright_colors option is also enabled.
If the color is not specified, the bright foreground color will fall
back to the normal foreground color.
This fixes #825.
* Fix clone URL in deb install instructions
* Fix 'cargo-deb' desktop file name
* Remove redundant dependency from deb build
* Switch from deprecated `std::env::home_dir` to `dirs::home_dir`
* Allow specifying modifiers for mouse bindings
* Send newline with NumpadEnter
* Add support for LCD-V pixel mode
* Add binding action for hiding the window
* Switch to rustup clippy component
* Add optional dim foreground color
Add optional color for the dim foreground (`\e[2m;`)
Defaults to 2/3 of the foreground color. (same as other colors).
If a bright color is dimmed, it's displayed as the normal color. The
exception for this is when the bright foreground is dimmed when no
bright foreground color is set. In that case it's treated as a normal
foreground color and dimmed to DimForeground.
To minimize the surprise for the user, the bright and dim colors have
been completely removed from the default configuration file.
Some documentation has also been added to make it clear to users what
these options can be used for.
This fixes #1448.
* Fix clippy lints and run font tests on travis
This fixes some existing clippy issues and runs the `font` tests through travis.
Testing of copypasta crate was omitted due to problens when running on headless travis-ci environment (x11 clipboard would fail).
* Ignore errors when logger can't write to output
The (e)print macro will panic when there is no output available to
write to, however in our scenario where we only log user errors to
stderr, the better choice would be to ignore when writing to stdout or
stderr is not possible.
This changes the (e)print macro to make use of `write` and ignore
any potential errors.
Since (e)println rely on (e)print, this also solves potential failuers
when calling (e)println.
With this change implemented, all of logging, (e)println and (e)print
should never fail even if the stdout/stderr is not available.
2018-07-28 19:10:13 -04:00
|
|
|
- { key: H, mods: Command, action: Hide }
|
2017-02-05 21:32:43 -05:00
|
|
|
- { key: Q, mods: Command, action: Quit }
|
|
|
|
- { key: W, mods: Command, action: Quit }
|
2017-02-10 12:15:36 -05:00
|
|
|
- { key: Home, chars: "\x1bOH", mode: AppCursor }
|
2017-08-22 15:23:19 -04:00
|
|
|
- { key: Home, chars: "\x1b[H", mode: ~AppCursor }
|
2017-02-10 12:15:36 -05:00
|
|
|
- { key: End, chars: "\x1bOF", mode: AppCursor }
|
2017-08-22 15:23:19 -04:00
|
|
|
- { key: End, chars: "\x1b[F", mode: ~AppCursor }
|
2017-10-16 12:57:05 -04:00
|
|
|
- { key: Key0, mods: Command, action: ResetFontSize }
|
|
|
|
- { key: Equals, mods: Command, action: IncreaseFontSize }
|
|
|
|
- { key: Minus, mods: Command, action: DecreaseFontSize }
|
2018-09-01 20:30:03 -04:00
|
|
|
- { key: K, mods: Command, action: ClearHistory }
|
|
|
|
- { key: K, mods: Command, chars: "\x0c" }
|
2017-05-10 12:51:41 -04:00
|
|
|
- { key: PageUp, mods: Shift, chars: "\x1b[5;2~" }
|
2017-05-10 08:46:32 -04:00
|
|
|
- { key: PageUp, mods: Control, chars: "\x1b[5;5~" }
|
2017-01-06 14:16:57 -05:00
|
|
|
- { key: PageUp, chars: "\x1b[5~" }
|
2017-05-10 12:51:41 -04:00
|
|
|
- { key: PageDown, mods: Shift, chars: "\x1b[6;2~" }
|
2017-05-10 08:46:32 -04:00
|
|
|
- { key: PageDown, mods: Control, chars: "\x1b[6;5~" }
|
2017-01-06 14:16:57 -05:00
|
|
|
- { key: PageDown, chars: "\x1b[6~" }
|
2017-10-20 10:59:28 -04:00
|
|
|
- { key: Tab, mods: Shift, chars: "\x1b[Z" }
|
|
|
|
- { key: Back, chars: "\x7f" }
|
|
|
|
- { key: Back, mods: Alt, chars: "\x1b\x7f" }
|
|
|
|
- { key: Insert, chars: "\x1b[2~" }
|
|
|
|
- { key: Delete, chars: "\x1b[3~" }
|
2017-01-06 14:16:57 -05:00
|
|
|
- { key: Left, mods: Shift, chars: "\x1b[1;2D" }
|
|
|
|
- { key: Left, mods: Control, chars: "\x1b[1;5D" }
|
|
|
|
- { key: Left, mods: Alt, chars: "\x1b[1;3D" }
|
|
|
|
- { key: Left, chars: "\x1b[D", mode: ~AppCursor }
|
|
|
|
- { key: Left, chars: "\x1bOD", mode: AppCursor }
|
|
|
|
- { key: Right, mods: Shift, chars: "\x1b[1;2C" }
|
|
|
|
- { key: Right, mods: Control, chars: "\x1b[1;5C" }
|
|
|
|
- { key: Right, mods: Alt, chars: "\x1b[1;3C" }
|
|
|
|
- { key: Right, chars: "\x1b[C", mode: ~AppCursor }
|
|
|
|
- { key: Right, chars: "\x1bOC", mode: AppCursor }
|
|
|
|
- { key: Up, mods: Shift, chars: "\x1b[1;2A" }
|
|
|
|
- { key: Up, mods: Control, chars: "\x1b[1;5A" }
|
|
|
|
- { key: Up, mods: Alt, chars: "\x1b[1;3A" }
|
|
|
|
- { key: Up, chars: "\x1b[A", mode: ~AppCursor }
|
|
|
|
- { key: Up, chars: "\x1bOA", mode: AppCursor }
|
|
|
|
- { key: Down, mods: Shift, chars: "\x1b[1;2B" }
|
|
|
|
- { key: Down, mods: Control, chars: "\x1b[1;5B" }
|
|
|
|
- { key: Down, mods: Alt, chars: "\x1b[1;3B" }
|
|
|
|
- { key: Down, chars: "\x1b[B", mode: ~AppCursor }
|
|
|
|
- { key: Down, chars: "\x1bOB", mode: AppCursor }
|
|
|
|
- { key: F1, chars: "\x1bOP" }
|
|
|
|
- { key: F2, chars: "\x1bOQ" }
|
|
|
|
- { key: F3, chars: "\x1bOR" }
|
|
|
|
- { key: F4, chars: "\x1bOS" }
|
|
|
|
- { key: F5, chars: "\x1b[15~" }
|
|
|
|
- { key: F6, chars: "\x1b[17~" }
|
|
|
|
- { key: F7, chars: "\x1b[18~" }
|
|
|
|
- { key: F8, chars: "\x1b[19~" }
|
|
|
|
- { key: F9, chars: "\x1b[20~" }
|
|
|
|
- { key: F10, chars: "\x1b[21~" }
|
|
|
|
- { key: F11, chars: "\x1b[23~" }
|
|
|
|
- { key: F12, chars: "\x1b[24~" }
|
2017-10-20 10:59:28 -04:00
|
|
|
- { key: F1, mods: Shift, chars: "\x1b[1;2P" }
|
|
|
|
- { key: F2, mods: Shift, chars: "\x1b[1;2Q" }
|
|
|
|
- { key: F3, mods: Shift, chars: "\x1b[1;2R" }
|
|
|
|
- { key: F4, mods: Shift, chars: "\x1b[1;2S" }
|
|
|
|
- { key: F5, mods: Shift, chars: "\x1b[15;2~" }
|
|
|
|
- { key: F6, mods: Shift, chars: "\x1b[17;2~" }
|
|
|
|
- { key: F7, mods: Shift, chars: "\x1b[18;2~" }
|
|
|
|
- { key: F8, mods: Shift, chars: "\x1b[19;2~" }
|
|
|
|
- { key: F9, mods: Shift, chars: "\x1b[20;2~" }
|
|
|
|
- { key: F10, mods: Shift, chars: "\x1b[21;2~" }
|
|
|
|
- { key: F11, mods: Shift, chars: "\x1b[23;2~" }
|
|
|
|
- { key: F12, mods: Shift, chars: "\x1b[24;2~" }
|
|
|
|
- { key: F1, mods: Control, chars: "\x1b[1;5P" }
|
|
|
|
- { key: F2, mods: Control, chars: "\x1b[1;5Q" }
|
|
|
|
- { key: F3, mods: Control, chars: "\x1b[1;5R" }
|
|
|
|
- { key: F4, mods: Control, chars: "\x1b[1;5S" }
|
|
|
|
- { key: F5, mods: Control, chars: "\x1b[15;5~" }
|
|
|
|
- { key: F6, mods: Control, chars: "\x1b[17;5~" }
|
|
|
|
- { key: F7, mods: Control, chars: "\x1b[18;5~" }
|
|
|
|
- { key: F8, mods: Control, chars: "\x1b[19;5~" }
|
|
|
|
- { key: F9, mods: Control, chars: "\x1b[20;5~" }
|
|
|
|
- { key: F10, mods: Control, chars: "\x1b[21;5~" }
|
|
|
|
- { key: F11, mods: Control, chars: "\x1b[23;5~" }
|
|
|
|
- { key: F12, mods: Control, chars: "\x1b[24;5~" }
|
|
|
|
- { key: F1, mods: Alt, chars: "\x1b[1;6P" }
|
|
|
|
- { key: F2, mods: Alt, chars: "\x1b[1;6Q" }
|
|
|
|
- { key: F3, mods: Alt, chars: "\x1b[1;6R" }
|
|
|
|
- { key: F4, mods: Alt, chars: "\x1b[1;6S" }
|
|
|
|
- { key: F5, mods: Alt, chars: "\x1b[15;6~" }
|
|
|
|
- { key: F6, mods: Alt, chars: "\x1b[17;6~" }
|
|
|
|
- { key: F7, mods: Alt, chars: "\x1b[18;6~" }
|
|
|
|
- { key: F8, mods: Alt, chars: "\x1b[19;6~" }
|
|
|
|
- { key: F9, mods: Alt, chars: "\x1b[20;6~" }
|
|
|
|
- { key: F10, mods: Alt, chars: "\x1b[21;6~" }
|
|
|
|
- { key: F11, mods: Alt, chars: "\x1b[23;6~" }
|
|
|
|
- { key: F12, mods: Alt, chars: "\x1b[24;6~" }
|
|
|
|
- { key: F1, mods: Command, chars: "\x1b[1;3P" }
|
|
|
|
- { key: F2, mods: Command, chars: "\x1b[1;3Q" }
|
|
|
|
- { key: F3, mods: Command, chars: "\x1b[1;3R" }
|
|
|
|
- { key: F4, mods: Command, chars: "\x1b[1;3S" }
|
|
|
|
- { key: F5, mods: Command, chars: "\x1b[15;3~" }
|
|
|
|
- { key: F6, mods: Command, chars: "\x1b[17;3~" }
|
|
|
|
- { key: F7, mods: Command, chars: "\x1b[18;3~" }
|
|
|
|
- { key: F8, mods: Command, chars: "\x1b[19;3~" }
|
|
|
|
- { key: F9, mods: Command, chars: "\x1b[20;3~" }
|
|
|
|
- { key: F10, mods: Command, chars: "\x1b[21;3~" }
|
|
|
|
- { key: F11, mods: Command, chars: "\x1b[23;3~" }
|
|
|
|
- { key: F12, mods: Command, chars: "\x1b[24;3~" }
|
Merge master into scrollback
* Allow disabling DPI scaling
This makes it possible to disable DPI scaling completely, instead the
the display pixel ration will always be fixed to 1.0.
By default nothing has changed and DPI is still enabled, this just seems
like a better way than running `WINIT_HIDPI_FACTOR=1.0 alacritty` every
time the user wants to start alacritty.
It would be possible to allow specifying any DPR, however I've decided
against this since I'd assume it's a very rare usecase. It's also still
possible to make use of `WINIT_HIDPI_FACTOR` to do this on X11.
Currently this is not updated at runtime using the live config update,
there is not really much of a technical limitation why this woudn't be
possible, however a solution for that issue should be first added in
jwilm/alacritty#1346, once a system is established for changing DPI at
runtime, porting that functionality to this PR should be simple.
* Add working --class and --title CLI parameters
* Reduce Increase-/DecreaseFontSize step to 0.5
Until now the Increase-/DecreaseFontSize keybinds hand a step size of 1.0. Since the font size however is multiplied by two to allow more granular font size control, this lead to the bindings skipping one font size (incrementing/decrementing by +-2).
To fix this the step size of the Increase-/DecreaseFontSize bindings has been reduced to the minimum step size that exists with the current font configuration (0.5). This should allow users to increment and decrement the font size by a single point instead of two.
This also adds a few tests to make sure the methods for increasing/decreasing/resetting font size work properly.
* Add Copy/Cut/Paste keys
This just adds support for the Copy/Cut/Paste keys and sets up
Copy/Paste as alternative defaults for Ctrl+Shift+C/V.
* Move to cargo clippy
Using clippy as a library has been deprecated, instead the `cargo
clippy` command should be used instead. To comply with this change
clippy has been removed from the `Cargo.toml` and is now installed with
cargo when building in CI.
This has also lead to a few new clippy issues to show up, this includes
everything in the `font` subdirectory. This has been fixed and `font`
should now be covered by clippy CI too.
This also upgrades all dependencies, as a result this fixes #1341 and
this fixes #1344.
* Override dynamic_title when --title is specified
* Change green implementation to use the macro
* Ignore mouse input if window is unfocused
* Make compilation of binary a phony target
* Add opensuse zypper install method to readme
* Fix clippy issues
* Update manpage to document all CLI options
The introduction of `--class` has added a flag to the CLI without adding
it to the manpage. This has been fixed by updating the manpage.
This also adds the default values of `--class` and `--title` to the CLI
options.
* Remove unnecessary clippy lint annotations
We moved to "cargo clippy" in 5ba34d4f9766a55a06ed5e3e44cc384af1b09f65 and
removing the clippy lint annotations in `src/lib.rs` does not cause any additional warnings.
This also changes `cargo clippy` to use the flags required for checking integration tests.
* Enable clippy in font/copypasta crates
Enabled clippy in the sub-crates font and copypasta. All issues
that were discovered by this change have also been fixed.
* Remove outdated comment about NixOS
* Replace debug asserts with static_assertions
To check that transmutes will work correctly without having to rely on
error-prone runtime checking, the `static_assertions` crate has been
introduced. This allows comparing the size of types at compile time,
preventing potentially silent breakage.
This fixes #1417.
* Add `cargo deb` build instructions
Updated the `Cargo.toml` file and added a `package.metadata.deb`
subsection to define how to build a debian "deb" install file using
`cargo deb`. This will allow debian/ubuntu users to install `alacritty`
using their system's package manager. It also will make it easier to
provide pre-built binaries for those systems.
Also fixed a stray debug line in the bash autocomplete script that was
writting to a tempfile.
* Add config for unfocused window cursor change
* Add support for cursor shape escape sequence
* Add bright foreground color option
It was requested in jwilm/alacritty#825 that it should be possible to
add an optional bright foreground color.
This is now added to the primary colors structure and allows the user to
set a foreground color for bold normal text. This has no effect unless
the draw_bold_text_with_bright_colors option is also enabled.
If the color is not specified, the bright foreground color will fall
back to the normal foreground color.
This fixes #825.
* Fix clone URL in deb install instructions
* Fix 'cargo-deb' desktop file name
* Remove redundant dependency from deb build
* Switch from deprecated `std::env::home_dir` to `dirs::home_dir`
* Allow specifying modifiers for mouse bindings
* Send newline with NumpadEnter
* Add support for LCD-V pixel mode
* Add binding action for hiding the window
* Switch to rustup clippy component
* Add optional dim foreground color
Add optional color for the dim foreground (`\e[2m;`)
Defaults to 2/3 of the foreground color. (same as other colors).
If a bright color is dimmed, it's displayed as the normal color. The
exception for this is when the bright foreground is dimmed when no
bright foreground color is set. In that case it's treated as a normal
foreground color and dimmed to DimForeground.
To minimize the surprise for the user, the bright and dim colors have
been completely removed from the default configuration file.
Some documentation has also been added to make it clear to users what
these options can be used for.
This fixes #1448.
* Fix clippy lints and run font tests on travis
This fixes some existing clippy issues and runs the `font` tests through travis.
Testing of copypasta crate was omitted due to problens when running on headless travis-ci environment (x11 clipboard would fail).
* Ignore errors when logger can't write to output
The (e)print macro will panic when there is no output available to
write to, however in our scenario where we only log user errors to
stderr, the better choice would be to ignore when writing to stdout or
stderr is not possible.
This changes the (e)print macro to make use of `write` and ignore
any potential errors.
Since (e)println rely on (e)print, this also solves potential failuers
when calling (e)println.
With this change implemented, all of logging, (e)println and (e)print
should never fail even if the stdout/stderr is not available.
2018-07-28 19:10:13 -04:00
|
|
|
- { key: NumpadEnter, chars: "\n" }
|