Layout
The layout editor lets you build a visual representation of your model train layout on a grid. This track plan is used in the throttle to show real-time accessory states and track occupancy, and in automation scripts to reference accessories and feedback sensors.
Editing the example layout
Available items
| Category | Items | Configurable |
|---|---|---|
| Track | Straight, Corner, Wide corner, Platform, Bumper | Feedback sensor |
| Turnouts | Left, Right, Three-way, Double slip switch, Turntable | Accessory, Feedback sensor |
| Signals | Light signal (6 states), Semaphore (3 states), Crossing | Accessory (dual), Feedback sensor |
| On-track items | Track sensor, Track switch, Track route, Uncoupler | Accessory, Feedback sensor, Route |
| Standalone items | Switch, Sensor, Route, Camera, Variable | Accessory, Route, Camera, Variable |
| Scenery | House, Factory, Windmill, Tree, Rock, Pond, Lion, Label | Accessory (some) |
| Bridges | Bridge start, Bridge section, Bridge crossing | Feedback sensor |
| Tunnels | Tunnel start, Tunnel section | Feedback sensor |
All items can be rotated in 45-degree steps. Items with track connectivity connect to neighboring items to form your rail network.
Adding items
Tap the + button in the bottom-right corner. A toolbar appears with all available items — select the one you want, then tap anywhere on the grid to place it. Tapping an occupied cell replaces the existing item.
Editing items
Tap the pencil button in the bottom-right corner to enter edit mode. Then tap an item to select it — the edit toolbar appears. Tap the selected item again to open its configuration sheet.
| Action | Description |
|---|---|
| Edit | Open the configuration sheet for the selected item. |
| Clone | Duplicate a configured item. Tap to select the source (blue border), then tap an empty cell to place the copy with all its settings. |
| Rotate | Rotate the item clockwise or counter-clockwise in 45-degree steps. |
| Move | Drag the item to a new position on the grid. |
| Delete | Remove the item from the layout. |
Use undo to revert any action.
Item configuration
Depending on the item type, the configuration sheet offers different options:
Name
Turnouts, signals, switches, sensors, routes, and variables can have a short name (up to 6 characters) that is displayed on the layout. This makes it easy to identify items at a glance.
Accessory address
Items like turnouts, signals, crossings, switches, and uncouplers can be linked to a DCC accessory address. This connects the layout item to the physical device on your layout, so tapping it in the throttle sends the corresponding command to your command station.
Turnouts and signals can have two accessories configured for complex setups (e.g. a signal controlled by two addresses).
Feedback sensor
Track pieces, turnouts, signals, bridges, and tunnels can have a feedback sensor configured. Select the feedback bus and address matching your physical sensor:
- R-Bus — Module and input number (Z21).
- LocoNet — Address (Z21).
- CAN bus — Address and port (Z21).
- ECoSLink — Address and port (ECoS).
When a feedback sensor reports occupancy, the track item changes color in the throttle view. If RailCom is supported, the occupying vehicle's name or avatar can be displayed directly on the track.
Route
Route items can be linked to a route. Tapping the item in the throttle executes the route, switching all configured accessories at once.
Camera
Camera items can be linked to a camera for Locovision vehicle detection. You can configure which area of the camera frame is used for detection (center, corners, or edges).
User interaction
A toggle that controls whether the item can be tapped in the throttle view. When disabled, the item is display-only — useful for items that should show state but not be accidentally toggled.
Notes
A free text field for your own documentation per item.
Layout in the throttle
In the throttle the layout becomes a live overview of your layout:
- Accessory states — Turnout positions, signal colors, and crossing states update in real time.
- Track occupancy — Feedback sensors highlight occupied track sections. With RailCom, the occupying vehicle is identified by name or avatar.
- Interactive control — Tap accessories to toggle them, tap routes to execute them, or tap cameras to view the live feed.
- Pan and zoom — Navigate large layouts by scrolling and pinching. Tap the zoom indicator to center the layout on screen.