# altp
A simple theme-picker for [alacritty](https://alacritty.org) A cross-platform, GPU-accelerated terminal emulator.
`[al]acritty [t]heme [p]icker`
Full credits to [@rajasegar](https://github.com/rajasegar) and [@juanvqz](https://github.com/juanvqz) for the awesome [alacritty-themes](https://github.com/rajasegar/alacritty-themes) NPM package that inspired this.
## Motivation
I'd wanted to try out some other themes for Alacritty so thought I'd give [alacritty-themes](https://github.com/rajasegar/alacritty-themes) a go, but found it didn't support the newer TOML config syntax for Alacritty.
Naturally, like any sane human being and instead of just updating my Alacritty config manually, I decided to re-write the entire thing in Rust with support for TOML config files.
## Installation
If not already installed, first install [rust](https://www.rust-lang.org/tools/install).
Then install altp globally:
```sh
$ cargo install altp
```
## Usage
Using the command with no arguments or options will show an interactive menu to select a theme:
```sh
$ altp
Select a theme: [Page 1/7]
> 3024 (dark)
3024 (light)
Afterglow
Alabaster
Alabaster (dark)
Argonaut
Ashes (dark)
Ashes (light)
Atelierdune (dark)
Atelierdune (light)
Atelierforest (dark)
Atelierforest (light)
Atelierheath (dark)
Atelierheath (light)
```
More advanced options can be used to customise behaviour.
Use the `h` or `help` options to view the documentation.
```sh
$ altp -h
Usage: altp [OPTIONS] [THEME]
Arguments:
[THEME] The name of the theme to use
Options:
-l, --list Print a list of available themes
-C, --current Print the current theme name
-d, --dir <DIR> The directory to search for the alacritty config file
-c, --create Whether to create a new config file if one does not already exist
-h, --help Print help (see more with '--help')
-V, --version Print version
```