Référence de la ligne de commande

Guide des options en ligne de commande de QElectroTech.

Corrigé en septembre 2026. Cette page décrivait auparavant une option --dpi et des variables d'environnement QET_PLUGIN_PATH / QET_ELEMENT_PATH qui n'existent pas, et plaçait les arguments dans un ordre que l'analyseur ne comprend pas. Tout ce qui suit a été vérifié sur le code source.

Options générales

Ces options prennent leur valeur avec un signe =.

Option	Effet
`--help`	Afficher l'aide sur les options
`-v`, `--version`	Afficher la version
`--license`	Afficher la licence
`--lang-dir=DOSSIER`	Dossier contenant les fichiers de langue

Selon la façon dont le binaire a été compilé, ces redéfinitions de dossiers peuvent aussi être disponibles : --common-elements-dir=DOSSIER, --common-tbt-dir=DOSSIER, --config-dir=DOSSIER, --data-dir=DOSSIER. Lancez --help pour voir celles dont dispose votre version.

Ouvrir des fichiers

Un fichier projet se donne comme simple argument positionnel. Il n'existe pas d'option -o ni --open.

qelectrotech monprojet.qet
qelectrotech projet1.qet projet2.qet

QET n'autorise qu'une seule instance : lancer la commande alors que QET tourne déjà transmet les fichiers à la fenêtre existante.

Export sans interface

Passez l'un des indicateurs ci-dessous et QET ouvre le projet, fait le travail et se termine, sans jamais afficher de fenêtre.

Les arguments sont positionnels, contrairement aux options générales. La forme est toujours :

qelectrotech <indicateur> <projet.qet> <sortie>

L'indicateur vient avant le projet. L'ordre inverse ne fonctionne pas.

Indicateur	Sortie
`--export-pdf`	un PDF, tous les folios
`--export-png` / `--export-svg`	un dossier, une image par folio
`--export-bom`	CSV, nomenclature
`--export-wiring`	CSV, liste de câblage de-à
`--export-cables`	CSV, liste de câblage issue du XML du document
`--export-wires`	CSV, numéros de conducteurs
`--export-nets`	CSV, réseaux électriques
`--export-links`	CSV, renvois de folio
`--info`	JSON structurel (sur stdout si aucun chemin n'est donné)
`--resave`	`.qet` réécrit
`--set-titleblock`	`.qet` avec champs de cartouche renseignés
`--check-elements`	valide des fichiers `.elmt` ou un dossier

Plus --show-terminals, qui dessine les marqueurs de bornes dans les sorties PDF/PNG/SVG.

qelectrotech --export-pdf monprojet.qet sortie.pdf
qelectrotech --export-png monprojet.qet images/
qelectrotech --export-bom monprojet.qet nomenclature.csv
qelectrotech --check-elements mes_elements/

Il n'y a pas d'option de résolution : --export-png rend chaque folio à la taille de sa zone imprimable.

Codes de retour

0 succès · 1 le travail a échoué · 2 erreur d'appel. Utilisables directement avec set -e.

Dans un script

set -e
for f in projets/*.qet; do
    timeout 120 qelectrotech --export-pdf "$f" "pdf/$(basename "${f%.qet}").pdf"
done

QT_QPA_PLATFORM=offscreen suffit ; Xvfb n'est pas nécessaire. Prévoyez toujours un délai d'expiration : un projet enregistré par une version antérieure peut faire apparaître une fenêtre modale.

Variables d'environnement

QET ne définit pas de variable d'environnement propre pour les greffons ou les éléments. Utilisez les options --common-elements-dir= et compagnie ci-dessus lorsque votre version les propose.