Alacritty (Portable)

This is not the latest version of Alacritty (Portable) available.

  • 1
  • 2
  • 3

0.4.0 | Updated: 02 Jun 2020



Downloads of v 0.4.0:



Software Author(s):

  • Joe Wilm

  • 1
  • 2
  • 3
Alacritty (Portable) 0.4.0

This is not the latest version of Alacritty (Portable) available.

  • 1
  • 2
  • 3

All Checks are Passing

3 Passing Tests

Validation Testing Passed

Verification Testing Passed


Scan Testing Successful:

No detections found in any package files


To install Alacritty (Portable), run the following command from the command line or from PowerShell:


To upgrade Alacritty (Portable), run the following command from the command line or from PowerShell:


To uninstall Alacritty (Portable), run the following command from the command line or from PowerShell:


NOTE: This applies to both open source and commercial editions of Chocolatey.

1. Ensure you are set for organizational deployment

Please see the organizational deployment guide

  • Open Source or Commercial:
    • Proxy Repository - Create a proxy nuget repository on Nexus, Artifactory Pro, or a proxy Chocolatey repository on ProGet. Point your upstream to Packages cache on first access automatically. Make sure your choco clients are using your proxy repository as a source and NOT the default community repository. See source command for more information.
    • You can also just download the package and push it to a repository Download

3. Enter your internal repository url

(this should look similar to

4. Choose your deployment method:

choco upgrade alacritty.portable -y --source="'STEP 3 URL'" [other options]

See options you can pass to upgrade.

See best practices for scripting.

Add this to a PowerShell script or use a Batch script with tools and in places where you are calling directly to Chocolatey. If you are integrating, keep in mind enhanced exit codes.

If you do use a PowerShell script, use the following to ensure bad exit codes are shown as failures:

choco upgrade alacritty.portable -y --source="'STEP 3 URL'"

Write-Verbose "Exit code was $exitCode"
$validExitCodes = @(0, 1605, 1614, 1641, 3010)
if ($validExitCodes -contains $exitCode) {
  Exit 0

Exit $exitCode

- name: Ensure alacritty.portable installed
    name: alacritty.portable
    state: present
    version: 0.4.0
    source: STEP 3 URL

See docs at

chocolatey_package 'alacritty.portable' do
  action    :install
  version  '0.4.0'
  source   'STEP 3 URL'

See docs at

    Name: alacritty.portable,
    Version: 0.4.0,
    Source: STEP 3 URL

Requires Otter Chocolatey Extension. See docs at

cChocoPackageInstaller alacritty.portable
   Name     = 'alacritty.portable'
   Ensure   = 'Present'
   Version  = '0.4.0'
   Source   = 'STEP 3 URL'

Requires cChoco DSC Resource. See docs at

package { 'alacritty.portable':
  provider => 'chocolatey',
  ensure   => '0.4.0',
  source   => 'STEP 3 URL',

Requires Puppet Chocolatey Provider module. See docs at

salt '*' chocolatey.install alacritty.portable version="0.4.0" source="STEP 3 URL"

See docs at

5. If applicable - Chocolatey configuration/installation

See infrastructure management matrix for Chocolatey configuration elements and examples.

This package is likely a meta/virtual (*) or an installer (*.install) or portable (*.portable) application package.

  • Meta/virtual (*) - has a dependency on the *.install or the *.portable package - it is provided for discoverability and for other packages to take a dependency on.
  • Portable (*.portable/*.commandline (deprecated naming convention)/*.tool (deprecated naming convention)) - usually zips or archives that require no administrative access to install.
  • Install (*.install/*.app (deprecated naming convention)) - uses native installers, usually requires administrative access to install.

Learn more about chocolatey's distinction of installed versus portable apps and/or learn about this kind of package.

This package was approved as a trusted package on 17 Jun 2020.



Travis build Status
Appveyor build Status


Alacritty is a terminal emulator with a strong focus on simplicity and
performance. With such a strong focus on performance, included features are
carefully considered and you can always expect Alacritty to be blazingly fast.
By making sane choices for defaults, Alacritty requires no additional setup.
However, it does allow configuration of many aspects of the

The software is considered to be at a beta level of readiness -- there are
a few missing features and bugs to be fixed, but it is already used by many as
a daily driver.

Further information

On Windows, Alacritty also requires Microsoft's VC++ redistributable.

For Windows versions older than Windows 10 (October 2018 Update), Alacritty
requires winpty to emulate UNIX's PTY API. The agent is a single binary
(winpty-agent.exe) which must be in the same directory as the Alacritty


You can find the default configuration file with documentation for all available
fields on the GitHub releases page for each release.

Alacritty looks for the configuration file at the following paths:

  1. $XDG_CONFIG_HOME/alacritty/alacritty.yml
  2. $XDG_CONFIG_HOME/alacritty.yml
  3. $HOME/.config/alacritty/alacritty.yml
  4. $HOME/.alacritty.yml


On Windows the config file is located at:



A full guideline about contributing to Alacritty can be found in the file.

Issues (known, unknown, feature requests, etc.)

If you run into a problem with Alacritty, please file an issue. If you've got a
feature request, feel free to ask about it. Please just keep in mind Alacritty
is focused on simplicity and performance, and not all features are in line with
that goal.

Before opening a new issue, please check if it has already been reported.
There's a chance someone else has already reported it, and you can subscribe to
that issue to keep up on the latest developments.


Is it really the fastest terminal emulator?

In the terminals we've benchmarked,
Alacritty is either faster or way faster than the others. If you've found a
case where this isn't true, please report a bug.

Why isn't feature X implemented?

Alacritty has many great features, but not every feature from every other
terminal. This could be for a number of reasons, but sometimes it's just not a
good fit for Alacritty. This means you won't find things like tabs or splits
(which are best left to a window manager or terminal multiplexer) nor
niceties like a GUI config editor.


Alacritty discussion can be found in #alacritty on freenode.


Alacritty is released under the Apache License, Version 2.0.

$PackageName = 'alacritty.portable'
$Url64 = ''
$Checksum64 = '54a4c4b164bee40880436ba4c49f0478f1fb8731b6406ed4d4f61d2e2d1a6cd49cc6cc94605b8c600ede388f38549d241cff1df0f80591382580dd44d72c5faf'
$ChecksumType64 = 'sha512'
$ToolsPath = Split-Path -Parent $MyInvocation.MyCommand.Definition
$InstallDir = Join-Path $(Get-ToolsLocation) "alacritty"

$desktop = [System.Environment]::GetFolderPath("Desktop")

$PackageArgs = @{
	PackageName = $PackageName
	Url64 = $Url64
	Checksum64 = $Checksum64
	ChecksumType64 = $ChecksumType64
	UnzipLocation = $InstallDir
Install-ChocolateyZipPackage @PackageArgs

Install-BinFile alacritty -path "$InstallDir\alacritty.exe" -UseStart
Install-ChocolateyShortcut -ShortcutFilePath "$desktop\Alacritty.lnk" -TargetPath "$InstallDir\alacritty.exe" -WorkingDirectory "$InstallDir" -WindowStyle 1
$PackageName = 'alacritty.portable'
$InstallDir = Join-Path $(Get-ToolsLocation) "alacritty"
$desktop = [System.Environment]::GetFolderPath("Desktop")

Uninstall-BinFile alacritty -path "$InstallDir\alacritty.exe"
Uninstall-ChocolateyZipPackage -PackageName 'alacritty.portable' -ZipFileName '$filename'

Remove-Item $InstallDir
Remove-Item "$desktop\Alacritty.lnk" -ErrorAction SilentlyContinue -Force | Out-Null

Log in or click on link to see number of positives.

In cases where actual malware is found, the packages are subject to removal. Software sometimes has false positives. Moderators do not necessarily validate the safety of the underlying software, only that a package retrieves software from the official distribution point and/or validate embedded software against official distribution point (where distribution rights allow redistribution).

Chocolatey Pro provides runtime protection from possible malware.

Version Downloads Last Updated Status
Alacritty (Portable) 0.8.0-rc6 6 Friday, May 14, 2021 Approved
Alacritty (Portable) 0.8.0-rc5 5 Thursday, May 13, 2021 Approved
Alacritty (Portable) 0.8.0-rc4 7 Wednesday, May 12, 2021 Approved
Alacritty (Portable) 0.8.0-rc3 9 Monday, May 10, 2021 Approved
Alacritty (Portable) 0.8.0-rc2 7 Tuesday, May 4, 2021 Approved
Alacritty (Portable) 0.7.2 76 Thursday, March 4, 2021 Approved
Alacritty (Portable) 0.7.2-rc2 13 Thursday, February 18, 2021 Approved
Alacritty (Portable) 0.7.2-rc1 10 Thursday, February 18, 2021 Approved
Alacritty (Portable) 0.7.1 60 Wednesday, January 13, 2021 Approved



  • Minimum Rust version has been bumped to 1.36.0

  • Config is not generated anymore, please consider distributing the alacritty.yml as documentation

  • Removed Alacritty terminfo from .deb in favor of ncurses provided one


  • Block selection mode when Control is held while starting a selection

  • Allow setting general window class on X11 using CLI or config (window.class.general)

  • Config option window.gtk_theme_variant to set GTK theme variant

  • Completions for --class and -t (short title)

  • Change the mouse cursor when hovering over the message bar and its close button

  • Support combined bold and italic text (with font.bold_italic to customize it)

  • Extra bindings for F13-F20

  • Terminal escape bindings with combined modifiers

  • Bindings for ScrollToTop and ScrollToBottom actions

  • ReceiveChar key binding action to insert the key's text character

  • New CLI flag --hold for keeping Alacritty opened after its child process exits

  • Escape sequence to save and restore window title from stack

  • Alternate scroll escape sequence (CSI ? 1007 h / CSI ? 1007 l)

  • Print name of launch command if Alacritty failed to execute it

  • Live reload font settings from config

  • UTF-8 mouse mode escape sequence (CSI ? 1005 h / CSI ? 1005 l)

  • Escape for reading clipboard (OSC 52 ; <s / p / c> ; ? BEL)

  • Set selection clipboard (OSC 52 ; <s / p> ; <BASE64> BEL)


  • On Windows, query DirectWrite for recommended anti-aliasing settings

  • Scroll lines out of the visible region instead of deleting them when clearing the screen


  • GUI programs launched by Alacritty starting in the background on X11

  • Text Cursor position when scrolling

  • Performance issues while resizing Alacritty

  • First unfullscreen action ignored on window launched in fullscreen mode

  • The window is now filled with the background color before displaying

  • Cells sometimes not getting cleared correctly

  • X11 clipboard hanging when mime type is set

  • On macOS, Alacritty will now fallback to Menlo if a font specified in the config cannot be loaded

  • Debug ref tests are now written to disk regardless of shutdown method

  • Cursor color setting with escape sequence

  • Override default bindings with subset terminal mode match

  • On Linux, respect fontconfig's embeddedbitmap configuration option

  • Selecting trailing tab with semantic expansion

  • URL parser incorrectly handling Markdown URLs and angled brackets

  • Intermediate bytes of CSI sequences not checked

  • Wayland clipboard integration

  • Use text mouse cursor when mouse mode is temporarily disabled with shift

  • Wayland primary selection clipboard not storing text when selection is stopped outside of the window

  • Block URL highlight while a selection is active

  • Bindings for Alt + F1-F12

  • Discard scrolling region escape with bottom above top

  • Opacity always applying to cells with their background color matching the teriminal background

  • Allow semicolons when setting titles using an OSC

  • Background always opaque on X11

  • Skipping redraws on PTY update

  • Not redrawing while resizing on Windows/macOS

  • Decorations none launching an invisible window on Windows

  • Alacritty turning transparent when opening another window on macOS with chunkwm

  • Startup mode Maximized having no effect on Windows

  • Inserting Emojis using Super+. or compose sequences on Windows

  • Change mouse cursor depending on mode with Wayland

  • Hide mouse cursor when typing if the mouse.hide_when_typing option is set on Wayland

  • Glitches when DPI changes on Windows

  • Crash when resuming after suspension

  • Crash when trying to start on X11 with a Wayland compositor running

  • Crash with a virtual display connected on X11

  • Use \ instead of \\ as path separators on Windows for logging config file location

  • Underline/strikeout drawn above visual bell

  • Terminal going transparent during visual bell

  • Selection not being cleared when sending chars through a binding

  • Mouse protocols/encodings not being mutually exclusive within themselves

  • Escape CSI Ps M deleting lines above cursor when at the bottom of the viewport

  • Cell reset not clearing underline, strikeout and foreground color

  • Escape CSI Ps c honored with a wrong Ps

  • Ignore ESC escapes with invalid intermediates

  • Blank lines after each line when pasting from GTK apps on Wayland


  • Bindings for Super/Command + F1-F12

  • Automatic config generation

  • Deprecated scrolling.faux_multiplier, the alternate scroll escape can now be used to disable it

    and scrolling.multiplier controls the number of scrolled lines

Discussion for the Alacritty (Portable) Package

Ground Rules:

  • This discussion is only about Alacritty (Portable) and the Alacritty (Portable) package. If you have feedback for Chocolatey, please contact the Google Group.
  • This discussion will carry over multiple versions. If you have a comment about a particular version, please note that in your comments.
  • The maintainers of this Chocolatey Package will be notified about new comments that are posted to this Disqus thread, however, it is NOT a guarantee that you will get a response. If you do not hear back from the maintainers after posting a message below, please follow up by using the link on the left side of this page or follow this link to contact maintainers. If you still hear nothing back, please follow the package triage process.
  • Tell us what you love about the package or Alacritty (Portable), or tell us what needs improvement.
  • Share your experiences with the package, or extra configuration or gotchas that you've found.
  • If you use a url, the comment will be flagged for moderation until you've been whitelisted. Disqus moderated comments are approved on a weekly schedule if not sooner. It could take between 1-5 days for your comment to show up.
comments powered by Disqus