https://github.com/saecki/alco

Update terminal colorschemes on the fly
https://github.com/saecki/alco

colorscheme neovim terminal tmux zsh

Last synced: 3 months ago
JSON representation

Update terminal colorschemes on the fly

• Host: GitHub
• URL: https://github.com/saecki/alco
• Owner: saecki
• Created: 2021-03-04T16:35:46.000Z (over 5 years ago)
• Default Branch: main
• Last Pushed: 2024-07-24T23:15:16.000Z (almost 2 years ago)
• Last Synced: 2025-10-25T08:38:25.163Z (9 months ago)
• Topics: colorscheme, neovim, terminal, tmux, zsh
• Language: Rust
• Homepage:
• Size: 144 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# alco

### Usage

```

alco 0.2.0

Saecki 

Update terminal colorschemes on the fly

USAGE:

    alco [OPTIONS] [SUBCOMMAND]

OPTIONS:

    -a, --reload-all                     Reload all additional colorschemes

    -A, --reload-alacritty               Also reload alacritty updating the configuration file

        --alacritty-file           The alacritty configuration file which will updated [default: ~/.config/alacritty/alacritty.yml]

        --alacritty-in-file        The alacritty configuration file which will updated [default: ~/.config/alacritty/alacritty.yml.in]

        --alacritty-selector       The alacritty selector file which contains a colorscheme mapping [default: ~/.config/alco/alacritty-selector.yml]

    -c, --config-file              Alco's configuration file [default: ~/.config/alco/alco.yml]

    -C, --colorscheme-file         The file that contains a list of colorschemes [default: ~/.config/alco/colors.yml]

        --cmus-selector            The cmus selector file which contains a colorscheme mapping [default: ~/.config/alco/cmus-selector.yml]

    -d, --reload-starship                Also reload starship by updating the configuration file

    -d, --reload-delta                   Also reload delta by updating the configuration file

        --delta-file               The delta configuration file which will be overwritten [default: ~/.config/delta/colors/current.gitconfig]

        --delta-selector           The delta selector file which contains a colorscheme mapping [default: ~/.config/alco/delta-selector.yml]

    -g, --generate-completion     Generates a completion script for the specified shell [possible values: bash, zsh, fish, elvish, powershell]

    -h, --help                           Print help information

    -k, --reload-kitty                   Also reload kitty by sourcing a configuration file

        --kitty-file               The kitty configuration file which will be overwritten and sourced [default: ~/.config/kitty/colors/current.conf]

        --kitty-selector           The kitty selector file which contains a colorscheme mapping [default: ~/.config/alco/kitty-selector.yml]

        --kitty-socket           The unix socket on which kitty is listening for remote control [default: /tmp/kitty]

    -m, --reload-cmus                    Also reload cmus by sourcing a configuration file

    -n, --reload-neovim                  Also reload neovim by sourcing a configuration file

        --neovim-command        The neovim command that will be executed to update the colorscheme [default: "lua require('colors').reload()"]

        --starship-file            The starship configuration file which will be overwritten [default: ~/.config/starship.toml]

        --starship-in-file         The starship in file which will be read [default: ~/.config/starship/starship.toml.in]

        --starship-selector        The starship selector file which contains a colorscheme mapping [default: ~/.config/alco/starship-selector.yml]

    -t, --reload-tmux                    Also reload tmux by sourcing a configuration file

        --tmux-file                The tmux configuration file which will be overwritten and sourced [default: ~/.config/tmux/colors/current.conf]

        --tmux-selector            The tmux selector file which contains a colorscheme mapping [default: ~/.config/alco/tmux-selector.yml]

    -V, --version                        Print version information

SUBCOMMANDS:

    apply     Apply a colorscheme

    help      Print this message or the help of the given subcommand(s)

    list      List available colorschemes

    status    Print the current status

    toggle    Toggle the colorscheme between available options

```

### Selector files

Selctor files contain a mapping from the alco colorscheme names to the respective colorscheme for the specific application. In some cases this might be a path in other cases just a name.

| Application | Type   |

|-------------|--------|

| alacritty   | `path` |

| kitty       | `path` |

| tmux        | `path` |

| starship    | `path` |

| delta       | `path` |

| cmus        | `name` |

__Example__

A `tmux-selector.yml` file

```

my-dark-theme: "~/.config/tmux/colors/my-dark-theme.conf"

my-light-theme: "~/.config/tmux/colors/my-light-theme.conf"

else: "~/.config/tmux/colors/my-dark-theme.conf" # default to a dark theme

```