mop-skills/skills/memobird/SKILL.md

51 lines
1.8 KiB
Markdown

---
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.