Repository navigation
tips_and_tricks
Advanced workflows, techniques, and best practices to master QElectroTech and create professional diagrams efficiently.
Drawing a wire:
- Press on a symbol's terminal
- Drag to the other terminal β it shows red where a connection is refused
- Release. QET routes the wire itself
Rerouting:
- Select the wire and drag the handles on its segments to change its path
- Edit β Reset conductors (Ctrl+K) throws your changes away and lets QET route the selected wires again
- Placing or moving a symbol so that its terminals line up with free ones can wire them automatically (Automatic creation conductor (s), see Conductors Β§8)
Double-click to place:
- Double-click a symbol in the Collections panel (or select it and press Enter) β it follows the pointer
- Click to place it
- Press A to place the same symbol again, as many times as you need
See Managing collections and Drawing faster for the picker (Insert), the shortcut bar (S) and repeating the last command (Enter).
Alignment:
- Everything you drag snaps to the grid; hold Ctrl to drag off it
- Edit β Align lines a selection up on one edge or centre line, or puts it back on the grid β see Aligning items
- Edit β Group β Group keeps items together while you move them β see Grouping items
Quick Rotation:
- Select the element and press Space to rotate it β this is the actual
registered shortcut (
diagrameditor.rotate_selection); R is not bound to anything in the diagram editor - Shift+Space rotates a multi-element selection as one group
- Or right-click β Rotate
Multi-Select Tricks:
- Ctrl+click elements one by one to add to selection
- Drag selection box to select all within box
- Edit β Selection β Select All (Ctrl+A) for entire diagram
- Edit β Selection β Select all conductors / Select all text fields β these two exist as real actions; there's no "select by device type" (switches, motors, etc.) feature to reach for instead
- Tab / Shift+Tab cycles the selection through every item on the diagram, one at a time, wrapping at either end β see Keyboard-only control
Smart Copying:
- Select element(s)
- Ctrl+C to copy
- Ctrl+V to paste β the copy follows the cursor until you click, Enter, or Escape to cancel
- Click to drop it wherever you want
For a row of copies rather than one placed by eye, Ctrl+D is the faster tool β see the Duplicate Trick below.
Duplicate Trick:
- Select element(s), press Ctrl+D
- First time: a small dialog asks for a spacing (grid steps) and a direction β up, down, left or right. Confirm it and the copy lands at that offset immediately, no dragging into place
- Every later Ctrl+D reuses that spacing/direction silently and continues from the copy just placed β hold Ctrl, tap D a few times to lay out an evenly-spaced row
- Change the spacing/direction later from Edit β Configure duplication...
- See Keyboard-only control for the full mechanics
Sheet Strategy:
- One sheet per major section: Power Supply, Control Logic, Outputs, Safety, etc.
- Clear naming: "01-Power Distribution", "02-Motor Control", "03-Safety"
- Cross-references: Use automatic xref for inter-sheet connections
Naming Conventions (Best Practice):
For Elements:
- Use reference designators: S1, S2, R1, M1, U1 (switch, relay, motor, IC)
- Helps identify components in bills of materials
- Makes troubleshooting easier
For Wires:
- Use signal names: "Enable", "Speed_Feedback", "Alarm"
- Electrical properties: "24V", "GND", "Signal"
- Improves readability and documentation
Hierarchical Organization:
- Level 1: Single sheet (simple projects)
- Level 2: 3-5 sheets (medium projects)
- Level 3: 10+ sheets (split into multiple files)
Zoom Shortcuts:
- Your platform's standard zoom-in/out keys (
QKeySequence::ZoomIn/ZoomOutβ usually Ctrl+Plus/Ctrl+Minus, not the bare +/- keys) - Ctrl+8: Zoom on content
- Ctrl+9: Fit zoom (adapted to the sheet)
- Ctrl+0 (Cmd+0 Mac): Reset zoom
- Mouse wheel: Zoom in and out around the mouse pointer β zoom out, point at the next area, zoom back in
Pan Tricks:
- Middle mouse button drag to pan
- Ctrl+Scroll scrolls up and down without zooming
- Move (hand icon): left-drag pans without selecting
- Space rotates the selection; it does not pan
Full reference, trackpad mode and the Centre on cursor key: Moving around a zoomed-in sheet.
Quick Navigation:
- Project panel (left): Click sheet to jump to it
- Tab key doesn't cycle sheets β it cycles the selection through every item on the current sheet instead (Shift+Tab goes backward). See Keyboard-only control for the full keyboard picture, including what actually is and isn't reachable without a mouse.
-
Ctrl+G: jump to a placed element by its label, or to a cell such as
B13or4-B7β see Finding your place on a sheet - Display β Keep headers visible keeps the column numbers and row letters in sight when zoomed in
Use Wire Colors Meaningfully:
- Red β Power/Phase
- Blue/Green β Neutral/Ground
- Yellow β Safety/Fault
- Gray β Signals/Control
- Improves readability at a glance
Element Coloring:
- Right-click element β Properties
- Assign background/outline colors
- Group by function or type
- Helps distinguish sections visually
IEC Standards Compliance:
- Use IEC symbols (included in QET)
- Follow IEC 81346 classification
- Consistent symbol size and spacing
- Clear signal flow direction
Good Diagram Habits:
- One function per sheet β Easier to understand
- Logical flow β Left to right, top to bottom
- Consistent spacing β Use grid alignment
- Minimal crossing β Reduce complexity
- Clear labels β Every wire and element
Labeling Best Practices:
| Element | Label | Wire Label |
|---|---|---|
| Switches | S1, S2, S3 | "Enable", "Reset" |
| Relays | R1, R2 | "Alarm", "Trip" |
| Motors | M1, M2 | "Run", "Stop" |
| Sensors | B1, B2 (proximity) | "Sensor 1" |
| Power | U1 (supply) | "24V", "GND", "Phase" |
Auto-Numbered Reports:
- Project β Export to CSV (there's no "Reports" submenu β this is the actual menu entry, and it opens a query builder with a configurable column set; see Building a custom nomenclature or summary table)
- Creates element list with counts
- Useful for bills of materials
- Export to file, or preview on screen first
Conductor Documentation:
- Project β Export the list of names of wires
- Lists all connections
- Export for manufacturing
- Useful for wiring technicians
Numbering Schemes:
- Elements: Auto-number as S1, S2, R1, R2, etc.
- Conductors: Auto-number L1, L2, L3, N, PE, etc.
- Sheets: Use consistent naming: "Sheet 1 of 10"
Design Custom Elements:
- Identify repeated patterns in your work
- Create as custom elements (.elmt files)
- Define terminals for connections
- Add metadata (properties, information)
Examples to Create:
- Complex subsystem blocks (controller units)
- Your company's standard components
- Industry-specific symbols not in library
- Custom logic or control blocks
Share Across Projects:
- Save .elmt files to shared folder
- Team members import via Elements panel
- Maintains consistency
- Saves time on repeated designs
Maintain Your Library:
- Version custom elements
- Document what each does
- Update when standards change
- Keep backup copies
Collection Strategy:
- Group by function: Power, Control, Sensors, etc.
- Group by manufacturer for specific products
- Create company-standard library
- Add "Favorites" for frequently used
Access Community Elements:
- Browse Elements Repository
- Download and import new symbols
- Contribute your own
- Share with community
For 100+ Elements:
- Hide the grid (Display β Display the grid) if not needed
- Close unused panels (View β Panels) to free memory
- Zoom to working area rather than whole page
- Split into multiple sheets if very large
For 500+ Elements:
- Split into separate .qet files instead of one massive file
- Use simplified symbols (outline only) in overview diagrams
- Detail complex sections in separate diagrams
- Improves both performance and readability
Responsiveness Tips:
- Save frequently (Ctrl+S) to reduce potential data loss
- Don't undo extremely far back; can slow performance
- Close files you're not actively editing
- Restart QET occasionally for fresh memory
Cleanup Techniques:
- Delete unused elements (select, press Delete)
- Remove extra wires (clean up old drafts)
- Consolidate symbols (use one library symbol instead of many)
Save Space:
- File β Save (not Save As) overwrites current, efficient
- PNG export for archival (smaller than .qet if size matters)
- Compress .qet files if storing on limited space
Basic Sharing:
- Each team member works on different sheets
- Save .qet file to shared network drive
- Work in sequence (one at a time) or parallel (different sheets)
- Merge changes manually if editing same sheet
Git Integration:
- Initialize Git in project directory
- Commit .qet files to repository
- Each team member branches for their work
- Merge via pull request
- Resolve conflicts in XML if needed
Best Practices:
- Communicate who's working on what
- Save frequently to avoid conflicts
- Use meaningful names for files and sheets
- Document changes in commit messages or notes
Manual Merge:
- Open Version A of diagram
- Export sections as PNG/SVG
- Open Version B (base)
- Copy elements from Version A into Version B
- Resolve conflicts (overlapping elements)
Git Merge:
- Both contributors push branches
- Create pull request with changes
- Review differences (XML diffs)
- Merge when ready
- Manually adjust conflicts in resulting .qet
PDF Workflow (Best for Sharing):
- Ensure all sheets are complete and labeled
- File β Print or Export β PDF
- Configure: scale, color/B&W, margins
- Generate PDF
- Share with clients, collaborators, installers
SVG Export (For Editing):
- File β Export β SVG
- Exports as vector format
- Editable in Inkscape, Adobe Illustrator
- Good for further refinement in other tools
PNG/JPG (For Web/Documents):
- File β Export β PNG (or JPG)
- Choose resolution (DPI)
- Good for embedded in documents, web pages
- Not editable but shareable
Multi-Format Export:
- Generate documentation in multiple formats
- Use PDF for official documents
- Use PNG for web embedding
- Use SVG for future editing
- Archival strategy
Keep spellings consistent: a parts list or query compares exact text, so "Schneider" and "Schneider Electric" end up as two suppliers. When you fill in an element's Informations tab (manufacturer, supplier, referenceβ¦), each field suggests the values other elements of the same project already use. Matching ignores case and works anywhere in the text β typing "ard" offers "Arduino" β so pick the existing spelling instead of typing a new one. The Label field has no suggestions, since a label names one element; nor do values from other projects.
Generate Automatically:
- Project β Export to CSV
- Creates element count and reference list
- Export to CSV for spreadsheet
- Use for purchasing, inventory
CSV Workflow:
- Export nomenclature as CSV
- Open in Excel/Google Sheets
- Add supplier information, costs
- Maintain parts list in spreadsheet
- Reference during assembly
Available Variables:
- %id β Element ID/reference
- %label β Element label
- %comment β Custom comment
- %author β Project author
- %date β Current date
- %filename β File name
Example: Add text "%date" to diagram β displays "2026-09-09"
For the full picture β every registered shortcut checked directly against the source, plus how far you can actually get without a mouse at all β see Keyboard-only control.
Essential Shortcuts (checked against ShortcutManager's registry β
see Keyboard-only control for the complete,
verified list):
| Action | Shortcut |
|---|---|
| New | Ctrl+N |
| Open | Ctrl+O |
| Save | Ctrl+S |
| Ctrl+P | |
| Undo | Ctrl+Z |
| Redo | your platform's standard "redo" key (varies β Ctrl+Y on Windows, Ctrl+Shift+Z on most Linux desktops) |
| Select All | Ctrl+A |
| Copy | Ctrl+C |
| Paste | Ctrl+V |
| Duplicate (offset by a configured spacing/direction) | Ctrl+D |
| Delete | Delete |
| Rotate | Space, not R β R isn't bound to anything here |
| Zoom In / Out | your platform's standard zoom keys, not bare +/- |
| Reset zoom | Ctrl+0 |
Power-User Series:
- Learn 5 shortcuts at a time
- Practice until muscle memory
- Gradually build speed
- Dramatically increases productivity
"Wires won't connect"
- Ensure you're clicking directly on terminals (small dots)
- Not all points on symbols are connectable
- Check element definition for terminal locations
"Elements look wrong after rotation"
- Some symbols aren't symmetric
- Rotate before finalizing placement if possible
- Or use simpler symbol and rotate after
"Diagram is slow"
- Large projects (500+ elements) may lag
- Split into multiple files
- Close unused panels
- Save and restart QET
"Lost work/file corrupt"
- After a crash, QET offers its crash-recovery copies at the next start β the last three of each project, see FAQ
- Autosave is off by default: set an interval for Automatic backup of projects in Settings β Configure QElectroTech β General
- Keep .qet files under version control
- Regular manual backups recommended
File Corruption:
- Pick an older crash-recovery copy at the next start, if the newest is the broken one
- Open .qet in text editor (it's XML)
- Look for obvious corruption
- Try opening in different QET version
Accidental Deletion:
- Use Ctrl+Z immediately after mistake
- Undo history very deep (many steps back possible)
- Version control (.git) has full history
Pattern:
- Create power distribution sheet
- Create PLC/controller sheet
- Create I/O terminal sheet
- Create sensor/actuator sheet
- Use cross-references between sheets
- Generate wiring list for technicians
Pattern:
- One sheet per major system (engine, lights, climate)
- Label with wire gauge (AWG)
- Color code per standard
- Export for manufacturing/assembly instructions
Pattern:
- Power distribution diagram
- Switch/outlet layout diagram
- Network/control diagram
- Device connectivity diagram
- Generate for electrician and homeowner
Pattern:
- Power generation (panels, inverters)
- Battery storage (if applicable)
- AC distribution
- Grounding and safety
- Metering and monitoring
Start Here:
- Quick Start Guide β Basic skills
- User Manual β All features
Build Skills: 3. Create simple projects (5-10 elements) 4. Try multi-sheet projects 5. Learn export and reports 6. Create custom elements
Master Advanced: 7. Collaborate with team 8. Build element libraries 9. Automate reporting 10. Develop workflows for your industry
- User Manual β Complete reference
- FAQ β Common questions
- Forum β Ask community
- YouTube Tutorials β Video guides
- Example Projects β Real-world examples
Found a great workflow? Have a technique to share?
β Post on the Forum to share your tips with the community!
Getting Started
π Languages β English Β· FranΓ§ais Β· Deutsch
Windows without admin rights β the portable archive, no installer
Guides
Conductors β wire properties, what feeds which export, cables, and hops where wires cross
Wires per terminal β limit the wires on a terminal, chain wiring instead of stars
Printing and exporting β paper, PDF, images, and what each path does differently
Linking elements β master, slave, terminal
PLC modules β I/O tables and linking a wire to a specific point
Using the element editor β drawing tools, saving, checks
Grid size and element size β why symbols aren't all the same scale, and scaling one without leaving the grid
Preferences reference β what each settings page does
Saving and loading settings β your whole setup in one file, to copy or keep
Keyboard-only control β mouseless QET, and what still needs a mouse
Mouse modifiers β what Shift, Ctrl and Alt change while you drag
3D mouse β SpaceMouse pan, zoom and buttons
Aligning items β snap symbols back to the grid, or line them up
Pictures on a sheet β labels, crop, transparency, what they cost in the file
Arcs and curved wires β the Arc tool, pulling an arc in or out, rounding a corner with a fillet, dashed arcs for lighting layouts
Grouping items β select, move and copy several items as one
Finding your place on a sheet β go to a cell like B13 or 4-B7, keep the headers in sight, show the cell limits, zoom and pan
Showing and hiding kinds of items β hide texts, wire numbers, shapes, pictures, tables or cross-references on every sheet
Drawing faster β place without dragging, the S shortcut bar, command search, gestures
Customising QElectroTech β keys, toolbar size and contents, the gesture ring (partly pending)
Managing collections β folders, writability, building your own shortlist
Templates β reusable multi-element blocks, placed by double-click or drag
Search & Replace β bulk property changes
Building a nomenclature query β the BOM/summary table builder
Linking wires across pages β sheet reports
Variables & formulas β %f, %{label}, sequences
Auto-numbering β schemes, sequences, freezing
Terminal strips β strips, levels, bridges
Title block templates β the .titleblock format
Importing EPLAN parts (.edz) β EPLAN Data Portal
DXF import & export β two unrelated features, one format; command-line export and layers
The project database β the in-memory SQLite cache
Development
Automating QET β CLI, XML formats, external tools
CLI Reference β command line usage
JavaScript Scripting β --run, geometry editing, undo
MCP server β let an AI assistant read, verify and edit projects
Connecting an AI assistant β setup for Claude, Copilot, Gemini, Codex, Cursor, LM Studio
Script buttons β stored scripts with an icon, by hand or by an assistant
Live mode β an assistant working in the open project while you watch
Macro recorder β record a task by hand, for an assistant to script
Vision β proposal, under discussion
