---
name: memobird
description: Print text, images, and notes directly to the Memobird thermal printer. Use this when the user wants to print a physical note, a shopping list, or a small image to the Memobird at its local IP.
---

# 🐦 Memobird Printer

Direct printing to the Memobird thermal printer on the local network.

## 📦 Installation

This skill uses [uv](https://docs.astral.sh/uv/) for dependency management. No manual installation of Python packages is required as dependencies are declared inline within the script.

Ensure you have `uv` installed on your system.

## 🚀 Usage

Use `uv run` to execute the script. `uv` will automatically create a temporary environment and install the required dependencies (`requests`, `Pillow`).

### 1. Print simple text
```bash
uv run skills/memobird/scripts/memobird_print.py --text "Hello from Gemini!"
```

### 2. Print styled text
```bash
uv run skills/memobird/scripts/memobird_print.py --text "IMPORTANT NOTE" --big --bold
```

### 3. Print an image
```bash
uv run skills/memobird/scripts/memobird_print.py --image "path/to/image.png"
```

### 4. Print a separator line
```bash
uv run skills/memobird/scripts/memobird_print.py --line THICK
```

## 🛠️ Options
- `--text`: The string to print.
- `--image`: Path to a local image file (converted to 1-bit monochrome automatically).
- `--ip`: Override the default IP (192.168.10.165).
- `--big`, `--bold`, `--underline`: Text styling.
- `--line`: Print a line (`THICK`, `THIN`, or `DASH`).

## 💡 Tips
- **Character Limit:** Thermal paper is narrow (384px wide). Long lines of text will wrap.
- **Image Size:** Large images might fail if they take too long to transfer. Keep them reasonably sized.
- **Connection:** Ensure the printer is powered on and connected to the same WiFi network.