# fetch-snap
Absolutely worst piece of code, completely generated by AI to complete one single task - make fastfetch pictures.

## Purpose
Render fastfetch output to an image (png, jpg, webp, gif) without losing any colors.

## Install
Requires [uv](https://docs.astral.sh/uv/) and fastfetch.

```sh
uv sync
```

## Usage
```sh
uv run fetch-snap                       # fetch.png in the current directory
uv run fetch-snap -o snap.png           # pick output file
```

The output format is taken from the file extension, or set with `-f`:
```sh
uv run fetch-snap -f jpg -o out.jpg
uv run fetch-snap -f webp -o out.webp
uv run fetch-snap -f gif -o out.gif
```

### Options
| Flag | Description |
| --- | --- |
| `-o, --output` | Output file (default: `fetch.<format>`) |
| `-f, --format` | Image format: `png`, `jpg`, `webp`, `gif` |
| `--icon` | Fetch icon (logo), passed to fastfetch `--logo`, e.g. `ascii`, `nerd_font` |
| `--theme` | Kitty color theme name or `.conf` path |
| `--prompt` | Real shell prompt line: `top`, `bottom` or `both` |
| `--shell` | Fallback prompt style if the real prompt cannot be captured: `bash`, `zsh`, `fish`, `nu`, `pwsh` |
| `--raw` | Run the command directly, without shell alias expansion |
| `--bg` | Background color, e.g. `#1e1e2e` (default: dark gray, or the theme background) |
| `--scale` | Render scale, multiplies font size and padding (default: 2) |
| `--font` | Font path or fontconfig family name, e.g. `"JetBrainsMono Nerd Font"` |
| `--font-size` | Font size in px (default: 16) |
| `--padding` | Padding around the text in px (default: 14) |
| `--fastfetch` | Command to run instead of `fastfetch` |

### Examples
```sh
# nerd font icons with a kitty theme and prompt lines
uv run fetch-snap --icon nerd_font --theme nord --prompt both -o snap.png

# custom background color and a sharper 4x render
uv run fetch-snap --bg "#241f31" --scale 4 -o snap.png

# use your own pretty fastfetch alias (aliases are expanded by default)
uv run fetch-snap -o snap.png

# skip alias expansion and call fastfetch directly
uv run fetch-snap --raw -o snap.png

# prompt two ways
uv run fetch-snap --prompt top --shell zsh -o snap.png
uv run fetch-snap --prompt bottom --shell fish -o snap.png
```

## Notes
- The output is captured through a pty so fastfetch keeps its colors. The
  real terminal is detected (process tree, like `detect_os.py` does) and the
  capture names itself after it, so modules like `terminalfont` and
  `{$MY_TERMINAL}`-style configs show your actual terminal and font.
- Without `--raw`, the command runs through an interactive shell, so your
  `.bashrc` aliases apply.
- `--prompt` renders your real shell prompt: the shell itself is started
  interactively in a pty and the prompt it prints is captured, colors
  included. If that fails, a synthetic prompt is used instead. With `top` or
  `both`, the typed command line (e.g. `fastfetch --logo nerd_font`) is shown
  after the prompt at the top; the bottom only gets the prompt.
- If no `--theme` is given, colors are read from `~/.config/kitty/kitty.conf`
  and your terminal's background/foreground.
- Fonts: a nerd font is preferred when installed; missing glyphs fall back
  per-character to any font that covers them, so nerd icons and emoji render
  even if your main font lacks them.
- The resolved fonts are printed to stderr, e.g. `font: .../SomeNerdFont.ttf`.