Wudstyz

← Projets

Application

VG-X4

Piloter la traceuse à stylo VigoTec VG-X4 depuis un Mac.

  • Version v1.4publiée le 9 novembre 2026 · 145,5 Mo
  • Macplateforme
  • Publié en novembre 2026première publication
  • Code publicREADME et code sur GitHub

Atelier Traceuse transforme un texte, un dessin ou un document en trajets que la traceuse dessine au stylo, sur une vraie feuille de papier.
L'app est autonome (Python et bibliothèques sont dedans) : on la glisse dans Applications et on l'ouvre, sans rien installer d'autre.

Projet indépendant : non affilié à VigoTec. Testé sur une VG-X4 réelle (firmware GRBL 1.1f). Les autres traceuses GRBL à stylo
peuvent fonctionner mais n'ont pas été essayées. Voir Compatibilité.

Ce qu'elle fait

✍️ Écriture manuscriteTexte tracé avec des polices à un trait (Hershey : cursive, script, gothique, feutre…) ou avec des polices du Mac. Inclinaison, irrégularité, ondulation de la ligne de base, espacement : la page ressemble à de l'écrit à la main.
📄 Word et PDFGlisser un .docx ou un .pdf : le texte, les titres, les listes, les images et les tableaux sont mis en page sur des feuilles et tracés. Aperçu manuscrit en direct, feuille par feuille.
🎨 Dessins et SVG30 formes et dessins paramétrables (cadres, étoiles, fleurs, papillons…), import de SVG multicolores (un stylo par couleur), hachures pour remplir les formes.
🖼️ ImagesContours, lignes détectées (idéal pour un dessin ou une illustration), hachures ou tons de gris (hachures croisées) à partir d'un PNG ou d'un JPEG.
✉️ Modèles et publipostageEnveloppe, carte, lettre, étiquette ; une feuille par ligne d'un fichier CSV avec {colonne} dans les textes.
🧭 Composer comme dans un éditeurSélection, rotation, taille, alignement, aimantation aux marges, zoom, annuler/rétablir, plusieurs stylos.
⏱️ Gain de tempsL'ordre des tracés est optimisé (jusqu'à environ 40 % de déplacements à vide en moins sur du texte) et la durée est estimée d'après le modèle de la carte GRBL.
🛡️ Sécurité du tracéCadre et essai à blanc stylo levé, butées virtuelles, arrêt propre avec reprise au trait près, reconnexion automatique, mode simulation sans machine.

Captures d'écran



Réglages d
Composer : réglages d'un texte (police, inclinaison, irrégularité…).
Import d
Document Word / PDF : mise en page manuscrite, tableaux conservés.


Tracé en cours en mode simulation
Tracé en direct : trajet, position du stylo, progression, temps restant.
Aperçu du G-code
G-code : aperçu et envoi d'un fichier ou de la composition.


Bibliothèque de formes
Bibliothèque : formes et dessins paramétrables, les tiens en plus.
Contrôle manuel de la machine
Contrôle : déplacement, stylo, point zéro, butées, console GRBL.

Installation

  1. Télécharger le fichier .dmg depuis la page Releases.
  2. L'ouvrir et **glisser Atelier Traceuse dans Applications**.
  3. Première ouverture : l'app n'est pas notarisée par Apple (c'est un projet libre sans compte développeur payant), macOS affichera donc un avertissement.
    Faire un **clic droit sur l'app → Ouvrir → Ouvrir**. Si macOS indique que l'app est « endommagée », ouvrir Réglages Système → Confidentialité et sécurité et cliquer sur Ouvrir quand même,
    ou lancer une fois dans le Terminal : xattr -dr com.apple.quarantine "/Applications/Atelier Traceuse.app".

Prérequis : un Mac Apple Silicon (M1 ou plus récent) sous macOS 14 (Sonoma) ou plus. Une machine n'est pas nécessaire pour essayer l'app : le bouton Simulation reproduit le protocole GRBL.

Premiers pas

  1. Brancher la traceuse en USB, ouvrir l'app, choisir le port dans la liste et cliquer sur Connecter (ou Simulation pour essayer sans machine).
  2. Dans Composer, régler le papier (format, orientation, marge), puis ajouter du texte, un SVG, une image ou un document avec les boutons bleus.
  3. Placer le stylo sur le coin haut-gauche du papier, aller dans Contrôle → Définir le zéro ici.
  4. Cliquer sur Cadre (le stylo levé fait le tour du dessin) ou Essai à blanc, puis sur ▶ Tracer.

Réglages utiles : valeur S du stylo baissé (par défaut 905), vitesses, inversion des axes (Réglages), étalonnage des pas/mm et jeu mécanique (Test machine).
Tout est détaillé dans les fonctionnalités. Un document Word d'exemple est dans examples/.

Compatibilité

  • Machine : VigoTec VG-X4 avec firmware GRBL 1.1 (115200 bauds, stylo commandé par M3 S… / M5). C'est la seule machine testée.
    D'autres traceuses GRBL avec un servo de stylo similaire devraient marcher en ajustant les réglages ; sans garantie.
  • Ordinateur : macOS 14+ sur Apple Silicon. Pas de version Windows, Linux ni Intel pour l'instant.
  • Limites connues : la machine n'a ni fins de course ni retour de position (GRBL ne sait pas si un moteur a vraiment bougé) ; les butées de l'app sont des butées virtuelles mesurées depuis le zéro.
    Word : pas de zones de texte ni de notes de bas de page, en-tête et pied de page limités au texte (pas d'images) ; PDF scannés : seules les images sont dessinées.

Construire depuis les sources

Il faut un Mac Apple Silicon, clang (outils en ligne de commande Xcode) et une connexion Internet (pour télécharger un Python autonome et les bibliothèques).

git clone https://github.com/Wudstyz/VG-X4.git
cd VG-X4
./build_app.sh      # fabrique « Atelier Traceuse.app » (Python embarqué, vérifié par SHA-256)
./make_dmg.sh       # fabrique dist/Atelier-Traceuse-1.4-macOS-arm64.dmg

Pour développer sans reconstruire l'app :

python3 -m venv .venv && .venv/bin/pip install -r requirements.txt
.venv/bin/python app.py                 # fenêtre native
.venv/bin/python app.py --server 8765   # sans fenêtre : ouvrir http://127.0.0.1:8765 dans un navigateur

Organisation du code

FichierRôle
app.pyFenêtre native (pywebview), serveur HTTP local et API
index.htmlToute l'interface (un seul fichier, sans dépendance externe)
grbl.pyLiaison série GRBL, simulateur, exécution des tracés, reprise
vec.pyTexte, SVG et images → trajets ; génération et optimisation du G-code
shapes.pyBibliothèque de formes paramétrables
docimport.pyLecture et mise en page des documents Word et PDF
build_app.sh, make_dmg.sh, launcher.c, make_icon.pyFabrication de l'app, du .dmg et de l'icône

Contribuer

Les retours sont les bienvenus : ouvrez une issue pour un bug, une idée, ou pour dire sur quelle machine vous l'avez essayée (modèle, firmware GRBL, résultat).
Les pull requests aussi. Un tracé réel peut abîmer une feuille voire la machine : **testez toujours avec un Cadre ou un Essai à blanc d'abord**.

Licence et crédits

MIT — voir aussi THIRD_PARTY_NOTICES.md. Polices Hershey : Dr A. V. Hershey (NBS), via le paquet MIT Hershey-Fonts.
Le protocole de la machine a été vérifié avec le dépôt MIT Morgulisan/VGX4-Control : aucun code n'en a été réutilisé, seulement des faits.
« VigoTec », « VG-X4 » et « GRBL » appartiennent à leurs propriétaires ; ce projet n'a aucun lien avec eux.

Le logiciel est fourni tel quel, sans garantie (voir la licence).

  • Python
  • GRBL
  • Traceuse
  • Matériel

Dernières mises à jour

v1.4 Dernière version

9 novembre 2026 · il y a 7 jours · Mac

Atelier Traceuse 1.4

Nouveautés :

  • Images d'un document Word ou PDF à leur vraie taille : les schémas gardent la taille définie dans le fichier d'origine (case Garder la taille des images du document, cochée par défaut) au lieu d'être réduits.
  • Nuances de gris (option) : pour les images en niveaux de gris avec un seul stylo, les hachures sont plus ou moins espacées selon le gris. Case nuances de gris (espacement variable), désactivée par défaut. Sans contour autour des zones grises.
  • Traits pleins fins tracés en une ligne : un trait noir plus fin que 1,2 mm (réglable : Traits fins en ligne, 0 = comme avant) est dessiné par une seule ligne au lieu d'être hachuré. Les tracés sont plus rapides.
  • Point zéro conservé à la reconnexion : tant que l'application reste ouverte, après une déconnexion ou une coupure USB, la dernière position connue est redonnée à la carte. Le zéro du dessin est gardé et un tracé interrompu peut être repris. Cela suppose que le stylo n'ait pas été déplacé à la main (message dans le journal).

Corrections :

  • Tracé orange en direct : il ne peut plus sauter en avant (par exemple à « 90 % » dès le début d'un gros fichier). Il reste dans la zone des lignes déjà envoyées à la carte. À la reprise d'un tracé, seul ce qui précède le point de reprise reste affiché.
  • Les commentaires du fichier (ex. « Changer de stylo : … ») ne sont plus lus comme des coordonnées.

Inclut aussi la 1.3 (tracé orange fidèle, mots longs, dessins noir et blanc), la 1.2 et la 1.1.

Limites : tout cela a été testé en simulation ; la restauration du zéro et le suivi orange n'ont pas encore été vérifiés sur la machine réelle, ni le DMG sur un autre Mac.

Installer : télécharger Atelier-Traceuse-1.4-macOS-arm64.dmg, l'ouvrir, glisser Atelier Traceuse dans Applications. Rien d'autre à installer.
Première ouverture : l'app n'est pas notarisée → clic droit sur l'app → Ouvrir → Ouvrir (ou xattr -dr com.apple.quarantine "/Applications/Atelier Traceuse.app").
Prérequis : Mac Apple Silicon, macOS 14 ou plus.

⚠️ Un tracé réel peut abîmer une feuille ou la machine : essayez toujours Cadre ou Essai à blanc d'abord.


Atelier Traceuse 1.4 (English)

New:

  • Word/PDF images keep their real size: diagrams keep the size set in the source file (checkbox Keep document image size, on by default) instead of being shrunk.
  • Grey levels (option): for greyscale images with a single pen, hatching is spaced more or less widely depending on the grey. Checkbox nuances de gris (espacement variable), off by default. No outline around grey areas.
  • Thin solid strokes drawn as one line: a black stroke thinner than 1.2 mm (adjustable: Traits fins en ligne, 0 = old behaviour) is drawn as a single line instead of being hatched. Plots are faster.
  • Zero point kept on reconnect: while the app stays open, after a disconnection or USB drop, the last known position is given back to the board. The drawing's zero is kept and an interrupted plot can be resumed. This assumes the pen was not moved by hand (a message is shown in the log).

Fixes:

  • Live orange trail can no longer jump ahead (e.g. to "90%" at the start of a big file). It stays within the lines already sent to the board. When resuming a plot, only what precedes the resume point stays displayed.
  • File comments (e.g. "Changer de stylo: …") are no longer parsed as coordinates.

Includes 1.3, 1.2 and 1.1.

Limits: all tested in simulation; zero restoration and the orange trail are not yet verified on the real machine, nor the DMG on another Mac.

Install: download Atelier-Traceuse-1.4-macOS-arm64.dmg, open it, drag the app into Applications. First launch: not notarized → right-click → Open → Open. Requirements: Apple Silicon, macOS 14+.

⚠️ A real plot can damage a sheet or the machine: always try Frame or Dry run first.

SHA-256 : 17b50abff3b9902284f066fe24a5654361aea80c792c998627933df547709ed7

v1.3

8 novembre 2026 · il y a 7 jours · Mac

Atelier Traceuse 1.3

Corrections et améliorations :

  • Tracé orange en direct : l'aperçu du tracé en cours affichait des tirets droits qui ne suivaient pas les lettres. Il suit maintenant le vrai parcours des traits, courbes comprises. (Affichage seulement : le dessin envoyé à la machine n'a pas changé.)
  • Adresses web et mots très longs dans les tableaux, les PDF et les documents Word : ils sont coupés dans leur cellule au lieu de dépasser de la feuille.
  • Dessins noir et blanc (manga, encre…) : l'app repère l'image et propose les cases tracer les contours et remplir les noirs (hachures), indépendantes l'une de l'autre, avec une option hachures croisées pour un noir plus dense.
  • Format AVIF lu en plus des formats habituels.
  • Réglages « Détails » et « fond flou » du mode Lignes du dessin : ils rafraîchissent maintenant l'aperçu (ils ne le faisaient pas en 1.1 et 1.2).

Inclut aussi la 1.2 (en-tête et pied de page des documents Word) et la 1.1 (mode d'image Lignes du dessin).

Limite : l'aperçu orange en direct a été testé en simulation ; il n'a pas encore été vérifié sur une machine réelle.

Installer : télécharger Atelier-Traceuse-1.3-macOS-arm64.dmg, l'ouvrir, glisser Atelier Traceuse dans Applications. Rien d'autre à installer.
Première ouverture : l'app n'est pas notarisée → clic droit sur l'app → Ouvrir → Ouvrir (ou xattr -dr com.apple.quarantine "/Applications/Atelier Traceuse.app").
Prérequis : Mac Apple Silicon, macOS 14 ou plus.

⚠️ Un tracé réel peut abîmer une feuille ou la machine : essayez toujours Cadre ou Essai à blanc d'abord.


Atelier Traceuse 1.3 (English)

Fixes and improvements:

  • Live orange trail: the preview of the running plot showed straight dashes that did not follow the letters. It now follows the real stroke path, curves included. (Display only: the drawing sent to the machine is unchanged.)
  • Long words and URLs in tables, PDFs and Word documents are wrapped inside their cell instead of running off the sheet.
  • Black-and-white drawings (manga, ink…): the app detects them and offers independent trace outlines and fill blacks (hatching) checkboxes, plus cross-hatching for denser black.
  • AVIF images are supported.
  • "Détails" and "blurred background" settings of the Lignes du dessin mode now refresh the preview (they did not in 1.1 and 1.2).

Includes 1.2 (Word header/footer) and 1.1 (Lignes du dessin image mode).

Limit: the live orange trail was tested in simulation only, not yet on a real machine.

Install: download Atelier-Traceuse-1.3-macOS-arm64.dmg, open it, drag the app into Applications. First launch: not notarized → right-click → Open → Open. Requirements: Apple Silicon, macOS 14+.


SHA-256 (Atelier-Traceuse-1.3-macOS-arm64.dmg) :

4db80073327ef447377b101f8667e1e49def655975cae6b170d7532d143e844b

v1.2

8 novembre 2026 · il y a 7 jours · Mac

Atelier Traceuse 1.2

Nouveau : en-tête et pied de page des documents Word. L'import lit l'en-tête et le pied de page du .docx (texte à gauche, au centre et à droite, y compris en tableau) et les écrit sur chaque feuille. Les numéros de page et le nombre de pages deviennent le numéro de feuille et le total. Une en-tête de première page différente est reprise. Une case permet de les désactiver.

Limites : seul le texte est lu (pas les images d'en-tête), seule la première section est prise en compte, et les numéros comptent les feuilles de la traceuse.

Inclut aussi la 1.1 : mode d'image « Lignes du dessin (détection) ».

Installer : télécharger Atelier-Traceuse-1.2-macOS-arm64.dmg, l'ouvrir, glisser Atelier Traceuse dans Applications. Rien d'autre à installer.
Première ouverture : l'app n'est pas notarisée → clic droit sur l'app → Ouvrir → Ouvrir (ou xattr -dr com.apple.quarantine "/Applications/Atelier Traceuse.app").
Prérequis : Mac Apple Silicon, macOS 14 ou plus.

⚠️ Un tracé réel peut abîmer une feuille ou la machine : essayez toujours Cadre ou Essai à blanc d'abord.


Atelier Traceuse 1.2 (English)

New: headers and footers of Word documents. The importer reads the .docx header and footer (left / centre / right text, including table layouts) and writes them on every sheet. Page-number fields become the sheet number and the total. A different first-page header is honoured. A checkbox turns it off.

Limits: text only (no header images), first section only, numbers count plotter sheets.

Includes 1.1: the image mode "Lignes du dessin (détection)".

Install: download Atelier-Traceuse-1.2-macOS-arm64.dmg, open it, drag the app into Applications. First launch: not notarized → right-click → Open → Open. Requirements: Apple Silicon, macOS 14+.

SHA-256 : dd91a46cb4182d9b913af8782b98b8322910044bba2262cafd229accf61b4169

Toutes les mises à jour

Dans la même catégorie

Capture de StatGithub

StatGithub

Les statistiques de visiteurs de tous vos dépôts GitHub.

Mac

Capture de Phare

Phare

Audit SEO, GSO et accès des robots d’IA à un site web.

Mac

Capture de ChipCard

ChipCard

Lire et écrire des cartes à puce sur Mac.

Mac