Terminal GIF for GitHub Profile

• Fetches real-time GitHub stats (commits, stars, PRs, followers, rank, languages)
• Three themes — classic terminal, macOS Liquid Glass, or Debian GNOME
• Custom wallpaper — drop any image into assets/ and point to it with one variable
• Username auto-detected — no code editing needed after forking
• Auto-regenerated daily via GitHub Actions

Click the Fork button at the top right of this page.

Go to Settings → Secrets and variables → Actions and add a new secret:

Generate a token at github.com/settings/tokens — only the read:user scope is needed.

Go to Settings → Secrets and variables → Actions, open the Variables tab and add:

If you skip this step the default theme is used.

Upload any image to assets/ in your fork, then add a second variable:

This works for the debian theme. If WALLPAPER is not set, debian_wallpaper.png is used.

For the macos theme, replace assets/macos_wallpaper.jpg directly.

Go to Actions → Generate Terminal GIF → Run workflow.

![Terminal GIF](https://raw.githubusercontent.com/YOUR_USERNAME/gif-terminal/main/output.gif)

pip install github-readme-terminal requests python-dotenv Pillow

# ffmpeg (optional — PIL fallback is used if not installed)
brew install ffmpeg        # macOS
sudo apt install ffmpeg    # Ubuntu / Debian

cp .env.example .env
# fill in GITHUB_TOKEN and GIT_USERNAME

# Debian theme — default wallpaper
python3 generate_debian.py

# Debian theme — custom wallpaper
WALLPAPER=debian_dark_wallpaper.jpg python3 generate_debian.py

# macOS theme
python3 generate_liquid_glass.py

# Classic dark
python3 generate_with_stats.py

.
├── generate_debian.py            # Debian GNOME theme
├── generate_liquid_glass.py      # macOS Liquid Glass theme
├── generate_with_stats.py        # Classic dark theme
├── assets/
│   ├── debian_wallpaper.png      # Default Debian wallpaper
│   ├── debian_dark_wallpaper.jpg # Dark Debian wallpaper
│   └── macos_wallpaper.jpg       # macOS wallpaper (replace with your own)
├── output.gif                    # Generated GIF (auto-updated by CI)
├── .env.example
└── .github/workflows/generate-gif.yml

If you already forked this repo, sync with upstream and you're done — nothing breaks:

• THEME=debian keeps working exactly as before
• The window buttons changed visually from colored circles to ˅ ◇ × icons
• New: add a WALLPAPER variable pointing to any image in assets/ to use a custom wallpaper (see step 4 above)

No code edits required.

Contributions, issues, and feature requests are welcome. Feel free to open an issue or submit a pull request.