atty 0.1.0

Atty

About | Install | How to Use | Configuration | Contribute

About

Atty is a cli utility for Alacritty color theme switching.

[!NOTE] This hasn't been tested on Windows and OS X yet. There'll probably be issues with default settings, as it's looking for the $HOME/.config/alacritty folder, but after setting the --config and --theme_dir flags, it should work just fine.

Install

The recommended way to get atty is to install the latest stable release:

pip install atty

or using pipx:

pipx install atty

How to Use

The default themes folder is in $HOME/.config/alacritty/themes/.

Example:

.
├── alacritty
│   ├── alacritty.yml
│   └── themes

[!TIP] You can get the oficial themes repository of alacritty:

git clone git@github.com:alacritty/alacritty-theme.git $HOME/.config/alacritty/themes/

Next, run atty and select you favority theme:

atty

Up and Down keys: navegate on themes list
Left and Right keys: switch page
ESC key: abort
Select Color:
> Cobalt2
  Mariana
  afterglow
  alabaster
  alabaster_dark
  argonaut
  atom_one_light
  ayu_dark
  ayu_light
  baitong

Page 1/11

(enter to confirm)

Configuration

The utility can be configured by passing additional flags/parameters:

aty --help

Usage: atty [OPTIONS]

  CLI for Alacritty color theme and configuration switching.

  By default, atty will look for the alacritty's configuration file in
  "$HOME/.config/alacritty/alacritty.toml", for the theme files in
  "$HOME/.config/alacritty/themes" folder.

Options:
  --version             Show the version and exit.
  -c, --config TEXT     Absolute path of Alacritty configuration file
  -d, --theme_dir TEXT  Absolute path of themes folder
  -t, --theme TEXT      Select a theme by name instead of showing prompt.
  -h, --help            Show this message and exit.

Contribute

See this guideline here.