whatisgithub

What is fzf-catppuccin?

muesli/fzf-catppuccin — explained in plain English

Analysis updated 2026-08-08 · repo last pushed 2022-10-29

Audience · developerComplexity · 1/5DormantSetup · easy

In one sentence

A color theme for the fzf command-line search tool, applying the soft Catppuccin pastel color palette so your terminal search looks nicer and matches your other themed apps.

Mindmap

mindmap
  root((repo))
    What it does
      Themes fzf search tool
      Soft pastel colors
      Four variants
    Variants
      Latte light theme
      Frappe dark theme
      Macchiato dark theme
      Mocha dark theme
    Setup
      Paste into shell config
      Bash and Zsh support
      Fish one-time command
    Audience
      Terminal power users
      Catppuccin fans
      Developers and admins
    Tech stack
      Shell config snippets
      Hex color values

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Make your fzf search interface match your Catppuccin-themed editor and terminal.

USE CASE 2

Choose between a light Latte theme or three dark variants for comfortable searching.

USE CASE 3

Quickly personalize a tool you use constantly in the terminal with no complex setup.

What is it built with?

Shellfzf

How does it compare?

muesli/fzf-catppuccin000madz000/rfid-attendance00kaku/gallery-slider-block
LanguageTypeScriptJavaScript
Last pushed2022-10-292024-07-222021-05-19
MaintenanceDormantDormantDormant
Setup difficultyeasyeasyeasy
Complexity1/52/52/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Just copy a short snippet of color settings into your shell config file or run a single command for Fish.

No license information is provided in this repository, so usage rights are unclear.

So what is it?

fzf-catppuccin is a color theme for a popular command-line tool called fzf, which lets you quickly search through lists of files, text, or other data right in your terminal. By default, fzf can look pretty plain or even harsh on the eyes. This project applies the "Catppuccin" color palette, a set of soft, soothing pastel colors, to make that search interface look much nicer and easier to read. The project offers four different color variations, called Latte, Frappé, Macchiato, and Mocha. Latte is a light theme, while the other three are dark themes with slightly different shades. You pick the one you like best, then copy a short snippet of settings into your terminal's configuration file. For Bash or Zsh users, that means pasting it into a file like ~/.bashrc or ~/.zshrc. For Fish users, it's a one-time command you run. After that, every time you use fzf, it shows up in your chosen colors. This is aimed at developers, system administrators, or anyone who spends time in the terminal and uses fzf for searching. If you've already themed your code editor and terminal emulator with Catppuccin colors, this brings that same consistent look to your search tool. It's a small quality-of-life improvement for people who care about a cohesive, comfortable workspace. There's not much complexity under the hood. The project is essentially a set of color values, specific hex codes for backgrounds, text, highlights, and prompts, formatted so fzf can understand them. It's a lightweight, no-fuss way to personalize a tool you use constantly throughout the day.

Copy-paste prompts

Prompt 1
Help me set up the Catppuccin Mocha theme for fzf in my ~/.zshrc file. Show me exactly what to paste and where.
Prompt 2
I use the Fish shell. How do I apply the Catppuccin Latte theme to fzf with a one-time command?
Prompt 3
Compare the Latte, Frappe, Macchiato, and Mocha Catppuccin variants for fzf and help me pick the best one for a dark terminal environment.

Frequently asked questions

What is fzf-catppuccin?

A color theme for the fzf command-line search tool, applying the soft Catppuccin pastel color palette so your terminal search looks nicer and matches your other themed apps.

Is fzf-catppuccin actively maintained?

Dormant — no commits in 2+ years (last push 2022-10-29).

What license does fzf-catppuccin use?

No license information is provided in this repository, so usage rights are unclear.

How hard is fzf-catppuccin to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is fzf-catppuccin for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.