Fastfetch Carousel Config for Kitty

This repository contains a custom configuration for fastfetch that displays a rotating carousel of images (or any file) in Kitty terminal, with optional color themes and media info.

Features

• Cyclical or random image rotation (configurable in carousel_logic.zsh)
• Uses kitty-direct for optimal image rendering in Kitty
• Skips execution when inside Zellij to avoid duplicate banners
• Displays system info, uptime, shell, and currently playing media (via MPRIS)
• Customizable colors and ASCII art header (VIKTHOR with Japanese symbols)

Installation

1. Clone or copy this repo to your desired location (e.g., ~/dotfiles/fastfetch-config).

2. Copy the config files to ~/.config/fastfetch/:

   cp -r ~/fastfetch-config/config.jsonc ~/.config/fastfetch/
   cp -r ~/fastfetch-config/carousel_logic.zsh ~/.config/fastfetch/
   cp -r ~/fastfetch-config/logos ~/.config/fastfetch/  # Optional: only if you want to use the sample images

   💡 Note: The logos folder contains sample images. Replace them with your own (PNG, JPG, etc.) or add more. The script will ignore current_logo and any metadata files (like .counter.txt or .shuffle_pool).

3. Update your ~/.zshrc to load the carousel at startup (but skip inside Zellij):

   # At the VERY TOP of ~/.zshrc, before any other code:
   if [[ -z "$ZELLIJ" ]]; then
       source ~/.config/fastfetch/carousel_logic.zsh
   fi

   ⚠️ Important: This must be placed before the Powerlevel10k instant prompt block (if you use it) to avoid console output warnings.

4. Create an alias for fastfetch to enable rotation on every manual run:

   alias fastfetch="ff_carousel"

   Add this line anywhere in your ~/.zshrc (after sourcing the carousel logic).

5. Reload your shell:

   source ~/.zshrc

   Now, every time you open a new Kitty terminal (or run fastfetch manually), you’ll see a random image from your logos folder, system info, and the currently playing track (if any).

How It Works

• The carousel_logic.zsh script defines a function ff_carousel that:

  1. Selects an image from ~/.config/fastfetch/logos/ (excluding symlinks and metadata).
  2. Updates the symlink current_logo to point to the selected image.
  3. Calls fastfetch --logo-type kitty-direct --logo "<path_to_image>" to render the image using Kitty’s graphics protocol.
  4. (Optional) Tracks rotation via a counter or shuffle bag to avoid repeats.

• The config.jsonc defines the layout, colors, and modules displayed. Feel free to edit it to match your aesthetic!

Customization

• Change rotation mode: Edit carousel_logic.zsh to switch between random, cyclical, or shuffle-bag logic.
• Adjust colors: Modify the display.color section in config.jsonc to suit your theme.
• Change header: Edit the custom module that renders the VIKTHOR panel to your liking.
• Add/remove modules: Adjust the modules array in config.jsonc to show/hide system info.

Requirements

• fastfetch (version 2.61.0 or later)
• Kitty terminal (for kitty-direct support)
• A shell that supports arrays (Zsh, Bash)
• Optional: playerctl or MPRIS-compatible player for media module

Credits

Inspired by the fastfetch-carousel repository and tailored for a Neo-Tokyo/Cyber-Industrial aesthetic.

---

Made with 💖 by Ivy, your digital muse.