Gifetch

I created Gifetch to display an animated ASCII gif alongside my neofetch output. The idea came after watching the PewDiePie video about linux — and I thought that was pretty kul

It's just a fun little project for terminal aesthetics. Hope someone else finds it cool too 🍚

🧩 Dependencies

Gifetch uses the following tools:

• ffmpeg — extract frames from a gif
• jp2a — convert image to ASCII
• neofetch — system info display

---

🚀 Installation (Automatic)

For now only works with pacman (Arch-based systems)

cd ~/gifetch
chmod +x install.sh
./install.sh
source ~/.zshrc # or source ~/.bashrc depending on your shell

This will:

• Install required packages (if not present)
• Set up gifetch and gif2ascii aliases

---

⚙️ Manual Setup

If you’re not on Arch or want full control:

1. Install dependencies manually

sudo pacman -S ffmpeg jp2a neofetch

On other distros use your respective package manager (e.g. apt, brew, dnf, etc.)

2. Make scripts executable

chmod +x ~/gifetch/scripts/gifetch.sh
chmod +x ~/gifetch/scripts/gif2ascii.sh

3. Add aliases manually (recommended)

Edit your ~/.zshrc or ~/.bashrc:

alias gifetch="$HOME/gifetch/scripts/gifetch.sh"
alias gif2ascii="$HOME/gifetch/scripts/gif2ascii.sh"

Then:

source ~/.zshrc # or .bashrc

---

🎬 Usage

1. Convert a GIF into ASCII frames:

gif2ascii ~/gifetch/gifs/yourgif.gif

This will:

• Extract frames from the gif
• Convert each frame to ASCII
• Store the ASCII in ~/gifetch/frames/ascii_frames/
• Copy the first frame as the neofetch logo

2. Play it inside the terminal:

gifetch

Press any key to stop the animation.

---

---

📁 Project Structure

gifetch/
├── gifs/                 # Your original gifs go here
├── frames/               # Generated JPG frames
│   └── ascii_frames/     # Generated ASCII text frames
├── scripts/              # gif2ascii.sh, gifetch.sh, utils.sh
├── install.sh            # Setup script

---