alacrittyfiles

Personal Alacritty configuration with Catppuccin Mocha theme

---

Table of Contents

• Overview
• Important Notice
• Prerequisites
• Installation
• Active Theme
• Submodule Maintenance
• Updates
• Contributing

---

Overview

This repository contains a personal Alacritty configuration. It replicates the official Alacritty theme repository on GitHub via a Git submodule — so it is important to keep the themes submodule up to date as described later.

The configuration applies the Catppuccin Mocha theme with a reduced opacity of 95%.

---

Important Notice

Make sure Alacritty is installed and working before proceeding. If there is already a custom Alacritty configuration on your machine, it will likely conflict with this repository. In that case, back up and remove the existing configuration before continuing.

# Backup current configuration
cp -r ~/.config/alacritty ~/.config/alacritty.bak

# Remove previous configuration
rm -rf ~/.config/alacritty

---

Prerequisites

• Alacritty installed and working
• Git installed and configured

---

Installation

Close Alacritty and clone the repository:

git clone https://forge.itamarcampos.com.br/itamcampos/alacrittyfiles.git ~/.config/alacritty

Change to the cloned directory:

cd ~/.config/alacritty

Initialize the submodule:

git submodule init

Update the submodule to pull the themes:

git submodule update

Reopen Alacritty and check if the changes have been applied.

---

Active Theme

The configured color scheme is Catppuccin Mocha, available in the official Alacritty theme repository. In addition to the theme, the configuration sets a window opacity of 95%.

Setting	Value
Theme	catppuccin_mocha.toml
Opacity	0.95

---

Submodule Maintenance

The themes/ directory is a Git submodule pointing to the official Alacritty theme repository. Use the commands below to keep it up to date.

Initialize the submodule (required only once after cloning):

git submodule init

Update the submodule to the revision recorded in this repository:

git submodule update

Update the submodule to the latest commit from the remote repository:

git submodule update --remote themes

Check the current state of the submodule:

git submodule status

Clone the repository with submodules already initialized:

git clone --recurse-submodules https://forge.itamarcampos.com.br/itamcampos/alacrittyfiles.git ~/.config/alacritty

---

Updates

To update the main configuration, run:

cd ~/.config/alacritty && git pull

To update the themes submodule:

git submodule update --remote themes

---

Contributing

Suggestions are welcome. Open an issue or submit a pull request.

---

_{Made by itamcampos}