Impression sur PT210

Imprime du texte, du Markdown ou des scènes Excalidraw sur une imprimante thermique Bluetooth PT210 à proximité depuis macOS.

Qu'est-ce que Impression sur PT210 ?

Cette compétence permet d'imprimer du texte brut, du Markdown ou des scènes Excalidraw sur une imprimante thermique Bluetooth PT210 depuis macOS. Elle nécessite macOS, `uv`, une PT210 allumée avec du papier, et l'autorisation Bluetooth pour l'application appelante. Le Markdown et Excalidraw nécessitent également Google Chrome installé localement. La compétence utilise un script shell (`print.sh`) pour scanner, configurer et imprimer. Pour le texte brut, l'impression utilise une police intégrée pour l'ASCII et une image bitmap pour l'Unicode. Le Markdown est rendu avec mise en forme (titres, listes, tableaux, etc.) et converti en image via Chrome. Excalidraw utilise le rendu officiel local avec `build-excalidraw` (npm), en préservant la géométrie et en redimensionnant proportionnellement. Les aperçus (prévisualisation) sont générés sans accès Bluetooth et ne remplacent jamais un fichier existant. La compétence gère les échecs d'impression et recommande une inspection manuelle du papier avant de réessayer, sans renvoi automatique.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/guzus/pt-210/tree/HEAD/skills/print

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Impression sur une PT210

Utilisez le script inclus via le dépôt cloné complet. Définissez PRINT_SKILL_DIR sur le répertoire de cette compétence et exécutez :

bash "$PRINT_SKILL_DIR/scripts/print.sh" --help

Nécessite macOS, uv, une PT210 allumée avec du papier, et l'autorisation Bluetooth pour l'application appelante. Markdown/Excalidraw nécessitent également Google Chrome installé localement. La première installation des dépendances utilise le réseau ; le rendu lui-même reste local. Ne supposez pas que ce dossier de compétence fonctionne s'il est copié sans le dépôt.

Connexion unique

bash "$PRINT_SKILL_DIR/scripts/print.sh" scan
bash "$PRINT_SKILL_DIR/scripts/print.sh" setup --address UUID_DU_SCAN

macOS identifie les périphériques BLE par un UUID spécifique à la machine, et non par une adresse MAC Bluetooth classique. La configuration vérifie qu'une caractéristique accessible en écriture est prise en charge et enregistre la sélection dans ~/.config/pt210/printer.json. Une PT210 découverte de manière unique peut être sélectionnée sans --address ; résolvez le périphérique prévu si plusieurs correspondent. Un périphérique enregistré absent ne retombe jamais sur une autre imprimante. --address remplace PT210_ADDRESS, puis la sélection enregistrée. inspect se connecte sans imprimer.

Préparer, prévisualiser, imprimer

Utilisez exactement le contenu demandé. Une demande d'impression autorise sa sortie papier ; n'ajoutez pas de confirmation redondante. Prévisualisez d'abord les mises en page inconnues.

bash "$PRINT_SKILL_DIR/scripts/print.sh" preview --file /tmp/note.md --output /tmp/note-preview.png
bash "$PRINT_SKILL_DIR/scripts/print.sh" print --file /tmp/note.md
  • Texte brut : entrée standard ou --file. L'ASCII s'imprime rapidement avec la police intégrée ; l'Unicode, y compris le coréen, utilise du texte bitmap. --mode raster force le bitmap.
  • Markdown : .md/.markdown détection automatique ; utilisez --format markdown pour l'entrée standard. Préservez la mise en forme demandée. Les titres, l'accentuation, les listes, les cases à cocher, les citations, le code, les tableaux et les liens sont rendus. Les tableaux larges deviennent des lignes étiquetées. Les liens incluent les destinations ; les images deviennent des espaces réservés de texte alternatif. Le HTML brut reste littéral et les ressources externes sont bloquées.
  • Excalidraw : .excalidraw/.excalidraw.json détection automatique ; utilisez --format excalidraw pour l'entrée standard ou un JSON générique. Construisez une fois avec build-excalidraw (nécessite npm). Utilisez la scène enregistrée, pas une URL de partage, une bibliothèque, un wrapper Obsidian ou un PNG. Ne régénérez pas une scène modifiée à partir de Mermaid. Le rendu officiel local préserve la géométrie et met à l'échelle proportionnellement à la largeur du papier. Les avertissements de petit texte nécessitent une inspection de la prévisualisation ; ne recadrez pas et ne réorganisez pas silencieusement. Les PNG/JPEG/WebP/GIF intégrés sont pris en charge ; les embeds distants et les images SVG échouent explicitement. Excalidraw et Markdown utilisent toujours le mode raster.

Les prévisualisations n'accèdent jamais au Bluetooth et refusent d'écraser un fichier existant. Les prévisualisations Markdown/Excalidraw correspondent à l'impression avec des options identiques. Pour le texte brut, utilisez print --mode raster pour correspondre à la prévisualisation ; les polices natives diffèrent. Chaque travail se termine par un guide en tirets et une marge blanche de 20 mm pour le déchirement. Ajustez avec --tear-margin-mm 0..50 ou omettez le guide avec --no-tear-line. La limite de hauteur par défaut est de 2 400 points (300 mm marge comprise) ; raccourcissez une grande sortie ou augmentez explicitement --max-height pour un long reçu demandé.

Livraison et échecs

Attendez la fin du processus. transmitted signifie que les écritures Bluetooth sont terminées, et non une preuve indépendante de la sortie papier. Obtenez une confirmation papier pour la configuration initiale ou un nouveau comportement de transport. Un verrouillage local empêche les travaux simultanés ; ne le contournez pas. Un envoi ayant échoué/interrompu peut avoir partiellement imprimé : inspectez le papier avant de réessayer et ne renvoyez jamais automatiquement.

Si aucune imprimante n'est trouvée, demandez à l'utilisateur de l'allumer à proximité et de déconnecter les applications d'imprimante du téléphone. Utilisez le chemin d'autorisation approuvé par l'environnement d'exécution lorsque Bluetooth est en bac à sable. Un refus Bluetooth nécessite une action de l'utilisateur dans Confidentialité et sécurité de macOS ; ne modifiez pas les paramètres TCC. Les variantes Bluetooth classique uniquement nécessitent un autre transport vérifié ; ne devinez pas les ports série et n'utilisez pas l'imprimante bureau/par défaut.

--transport conservative utilise des paquets plus petits pour le prochain travail autorisé si la sortie est corrompue. La configuration de l'imprimante, les fichiers de verrouillage et les caches de rendu sont un état d'exécution local ; ne les validez jamais. Les capacités complètes, la configuration et les limitations se trouvent dans le README du dépôt.

Skills associés