https://github.com/catppuccin/i3

🌻 Soothing pastel themes for i3 & sway
https://github.com/catppuccin/i3

catppuccin hacktoberfest i3 i3wm sway swaywm theme

Last synced: 4 months ago
JSON representation

🌻 Soothing pastel themes for i3 & sway

• Host: GitHub
• URL: https://github.com/catppuccin/i3
• Owner: catppuccin
• License: mit
• Created: 2022-12-13T10:05:43.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2025-03-30T11:06:52.000Z (about 1 year ago)
• Last Synced: 2025-08-07T01:57:37.696Z (10 months ago)
• Topics: catppuccin, hacktoberfest, i3, i3wm, sway, swaywm, theme
• Language: Just
• Homepage:
• Size: 1.25 MB
• Stars: 244
• Watchers: 3
• Forks: 5
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          


	


	

	Catppuccin for  i3 & sway

	





	

	

	





![preview](assets/preview.webp)



## Previews

🌻 Latte

![latte](assets/latte.webp)

🪴 Frappé

![frappé](assets/frappe.webp)

🌺 Macchiato

![macchiato](assets/macchiato.webp)

🌿 Mocha

![mocha](assets/mocha.webp)

## Usage

1. Download the file with your desired flavour e.g. `catppuccin-mocha` (to be

   found in the release or after cloning the repository in themes/)

2. Copy it into your i3 or sway config directory (usually `~/.config/i3/` or

   `~/.config/sway/`)

3. Follow the instructions for your WM

4. When editing the config, use the

   [name of the colour](https://github.com/catppuccin/catppuccin#-palettes) such

   as `$base`.

```i3config

# target                 title     bg    text   indicator  border

client.focused           $lavender $base $text  $rosewater $lavender

client.focused_inactive  $overlay0 $base $text  $rosewater $overlay0

client.unfocused         $overlay0 $base $text  $rosewater $overlay0

client.urgent            $peach    $base $peach $overlay0  $peach

client.placeholder       $overlay0 $base $text  $overlay0  $overlay0

client.background        $base

# bar

bar {

  colors {

    background         $base

    statusline         $text

    focused_statusline $text

    focused_separator  $base

    # target           border bg        text

    focused_workspace  $base  $mauve    $crust

    active_workspace   $base  $surface2 $text

    inactive_workspace $base  $base     $text

    urgent_workspace   $base  $red      $crust

  }

}

```

## Sway

- Include the file at the top of your `config`:

```i3config

include catppuccin-mocha

```

## i3

- Due to a limitation in i3, you cannot use variables from imported files in the top-level config.

- As a workaround, you may create another file to set the colors by importing them, and import in `config`.

## 🙋 FAQ

- Q: **_"Sway/i3 doesn't work with the colors"_**

  \

  A: Make sure you included the file in the right place and you are using

  `$color`

## 💝 Thanks to

- [rubyowo](https://github.com/rubyowo)

 



	





	Copyright © 2021-present Catppuccin Org