Installation Guide

Gogh can be installed and used in two primary ways: a user-friendly interactive mode or a non-interactive mode ideal for scripting and automation.

Prerequisites

Before running the installation script, you need to install some required packages. The commands vary depending on your operating system.

For Debian / Ubuntu:

sudo apt-get install dconf-cli uuid-runtime

For Arch Linux:

sudo pacman -S dconf util-linux-libs

The easiest way to get started with Gogh is to use the interactive one-line installer. This will present you with a list of all available themes to choose from and apply.

For Linux users:

bash -c "$(wget -qO- https://git.io/vQgMr)"

For macOS users:

bash -c "$(curl -sLo- https://git.io/vQgMr)"

After running the command, simply follow the on-screen prompts to select and apply your desired themes.

Non-Interactive Mode (for Scripting)

For automation or if you prefer a manual setup, you can clone the repository or download the required files.

1. Clone the Full Repository

This method gives you access to all themes and scripts locally.

# Create a source directory and clone the repo
mkdir -p "$HOME/src"
cd "$HOME/src"
git clone https://github.com/Gogh-Co/Gogh.git gogh
cd gogh

# Set your terminal type (see the Supported Terminals page for more options)
export TERMINAL=gnome-terminal

# Navigate to the installer scripts
cd installs

# Run the installer for a specific theme
./dracula.sh
./solarized-dark.sh

2. Download Required Files (Bare Minimum)

If you only need to apply a few themes without cloning the entire repository.

# Download the main apply script
wget https://raw.githubusercontent.com/Gogh-Co/Gogh/master/apply-colors.sh

# Download a desired theme installer
wget https://raw.githubusercontent.com/Gogh-Co/Gogh/master/installs/selenized-dark.sh

# Make the scripts executable
chmod +x apply-colors.sh selenized-dark.sh

# Apply the theme
TERMINAL=gnome-terminal ./selenized-dark.sh

Python Dependencies for Specific Terminals

Applying themes to Alacritty and Terminator requires Python and additional packages. If you intend to use Gogh with these terminals, you must install the dependencies listed in requirements.txt.

# Install Python dependencies using pip
pip install -r requirements.txt

The required packages are:

  • ruamel.yaml
  • unidecode
  • pyyaml
  • tomli
  • tomli_w
  • configobj

After installing these, you can apply themes by setting the TERMINAL variable accordingly:

# Example for Alacritty
export TERMINAL=alacritty
cd installs
./dracula.sh