Software
Project and backup
A project is your whole layout: track plan, devices, locos, trains, stations and everything learned. This page shows how to create, open, save and back up layouts – and which basic layout settings to make before you draw the first track.
Where the project is stored
A project is stored as a folder on the layout computer. Its backup is a file with the extension .lodiaura. It contains the track plan, interfaces, locos, automation and all specialist modules. Everything is managed under “System” › “Project” on the “Load & save project” page.
Single file or project folder
Older layouts are often still stored as a single .lodiaura file. Under “My layouts” they carry the “Single file” badge and the “Convert to folder” button.
After converting, the layout, operating state, learned data and log are kept in separate files, and a train run only writes kilobytes instead of the whole project. The previous file stays where it is as an archive.
Loading and saving the project
Current project
- Save: “Save now” or a click on the save tile in the header. With a single file, LoDi-Aura keeps the previous version next to it as a
.bakfile. A project folder saves its files individually and only what has changed. - Rename: “Rename” opens the “Rename project” dialog. The new name appears in the interface, in the start window and in the next export.
- At the top right, the card shows “saved” or “unsaved”.
Import and export
- “Export backup” downloads the current complete state as a
.lodiaurafile. - “Import layout” brings in a LoDi-Aura project file or an older LoDi project file and takes it on as a layout of its own.
When importing, LoDi-Aura first checks the file and shows what's in it – interfaces, locomotives, tracks, blocks, signals and routes – before it is loaded. The file is placed in the projects folder as a layout of its own and opened; the layout you had open before stays as it is.
- Choose the fileClick “Import layout” and choose the file.
- CheckThe “Import layout?” dialog shows the contents. Under “Name in ‘My layouts’”, enter the name the layout should appear under.
- Decide if the name already existsIf the name already exists, choose “Create as new layout” or “Replace existing layout”.
- ImportClick “Import and open”.
My layouts
“My layouts” shows all projects in your layouts folder on this computer. Here you open layouts, create new ones or save the open one under a new name.
| Element | Effect |
|---|---|
| “Change folder…” | Moves the projects folder. LoDi-Aura asks for the path on the layout computer. |
| ↻ | Refreshes the list. |
| “Search layouts…” | Search field; appears when the list gets longer. |
| “Open” | Opens the layout. If there are unsaved changes, LoDi-Aura asks first. Instead of the button, the open layout carries the “open” badge. |
| “Convert to folder” | Only for a single file, see above. |
| 🗑 | Deletes the layout after asking you. This cannot be undone. The open layout cannot be deleted. |
| “Save as…” | Saves the open layout under a new name. If the name already exists, LoDi-Aura asks whether to overwrite it and makes a backup first. |
| “New layout…” | Creates a new layout (see below). |
Creating a new layout
- Open the dialogUnder “My layouts”, click “New layout…”.
- NameEnter a name under “Layout name”. The dialog rejects a name that already exists under “My layouts” – a new layout never replaces an existing one.
- GaugeChoose the “Gauge”. The default is “H0 · 1:87”.
- CreateClick “Create”.
You can choose from Z · 1:220, N · 1:160, TT · 1:120, H0 · 1:87, 0 · 1:45, 1 · 1:32 and G · 1:22.5. LoDi-Aura uses the gauge to convert km/h into cm/s. You can change it later under “System” › “Track plan” (see “Scale first”).
When you switch layouts
When you open another layout, create a new one, import one or restore a version, LoDi-Aura starts with a clean slate:
- First, LoDi-Aura disconnects the devices. The layout is then offline.
- A pressed “🛑 STOP” is released – it applies to the layout on which it was pressed.
- Signals set by hand, the lighting state, a running calibration run and running turntable sequences are gone. Driving orders from the previous layout no longer apply.
- Model time, calibration run measurements and learned RailCom directions come from the new layout.
Simply saving doesn't trigger any of this.
Versions on this computer
LoDi-Aura keeps a history of your layout on the layout computer – like a time machine. You'll find it under “System” › “Project” in the “Versions” card. You need neither a sign-in nor an internet connection for this.
| What | How it works |
|---|---|
| Automatic | At most every five minutes, LoDi-Aura creates a version by itself if something has changed. The twelve most recent are kept, after that one per day for 30 days. |
| By hand, with a name | Enter a name at the top, such as “before station rebuild”, and click “Save version”. Named versions are kept until you delete them. Create such a version before every major change. |
| Compare | Clicking a version shows on the right what was different since the version before it and what “Back” would change compared with now – locos, cars, trains, blocks, signals, command stations, track plan, learned data and settings. |
| Back | “Back” restores the layout and learned data from that point in time. Turnout positions and train locations stay as they are now. Beforehand, LoDi-Aura saves the current state as “before going back” – so you can undo that too. Going back only works with the layout switched off. |
| ⋮ | More actions, such as renaming a version. |
If the open layout is replaced by “New layout…”, an import or “Save as…”, LoDi-Aura creates a version first. The versions are stored in the layout's folder. They are no substitute for a backup on another drive: still export your layout now and then, or back it up online.
Backing up online
If you are signed in to LoDi-Aura with your Lokstore account, LoDi-Aura also stores versions of your layout online. For this, the row of the open layout under “My layouts” has two small buttons with a database cylinder. The arrow shows the direction: up to back up, down to fetch.
| Button | Effect |
|---|---|
| Cylinder with arrow pointing up | Back this state up online now. The first time, LoDi-Aura asks what name the layout should have in your account. An unchanged version is not uploaded again. |
| Cylinder with arrow pointing down | Older versions. Opens a panel: at the top the “Back up this layout online” switch, below it every backed-up version with time, device and size and the “restore” button. If the layout isn't online yet, the button is grey. |
Backing up automatically
Once the layout is set up online, LoDi-Aura backs it up automatically every time you close it – that is, when you open another layout, create a new one or import one – and when you quit. Backing up never holds up quitting.
The info line of the open layout tells you the status:
| Info line | Meaning |
|---|---|
| Date and time | Time of the last online backup. |
| “(changed since then)” | Something has been changed since the last backup. |
| “nothing backed up yet” | The layout is set up, but there is no version yet. |
| “not set up” | The layout isn't online yet. You make the first backup by hand. |
| “off” | Online backup is switched off for this layout. You switch it back on under “Older versions”. |
| “not signed in” | LoDi-Aura isn't connected to the Lokstore account. |
| “unreachable” | The portal isn't responding at the moment. The backup will catch up next time. |
Setting it up when creating a layout
If you tick “Back up this layout online” in the “Create new layout” dialog, LoDi-Aura sets the layout up online straight away and backs up the first version. If a layout with this name already exists online, for example from another computer, the dialog refuses: choose a different name or download the existing layout. If the portal can't be reached at the moment, the layout is still created; the info line then says “not set up”, and you make the first backup by hand.
Restoring a version
“restore” replaces the open layout with the chosen version. Beforehand, LoDi-Aura asks you, stores your current version as a file in the projects folder and takes the layout offline.
On another computer, layouts that only exist online appear under “My layouts” with the “online only” label and the “Download” button. It fetches the most recent version to this computer, creates it as a new layout and opens it.
The same layout on several computers
If you work on the same layout on several computers, LoDi-Aura notices at startup and when opening if another computer has backed up a newer version in the meantime. A notice appears, and the layout shows the tag “⚠ newer state from …”.
Clicking it – or a refused backup – opens the choice:
- “Fetch state from …”: your version is first stored as a file in the projects folder.
- “Back up mine anyway”: your version becomes the most recent; the other one stays in the list of versions and can be restored.
- “Later”: do nothing.
Basic settings of the layout
Under “System” › “Track plan” you'll find the settings that apply to the whole layout: scale, display, speed defaults, RailCom and safety. They apply to the track plan and train control and are saved in the project.
The page is arranged in seven sections: Layout, Display, Driving, Feedback, Safety, Operation and At startup. Each row is explained behind a small expander, and the “Search settings …” field finds a setting even by a word from its explanation.
Settings marked “Administrator” can only be changed by an administrator.
Scale first
Set the gauge before you draw anything. It isn't cosmetic – it's the calculation anchor of the whole train control: it converts prototype km/h into layout centimetres per second. If it's wrong, not a single speed or braking calculation will be right afterwards.
| Setting (“Scale & size” card) | Meaning |
|---|---|
| “Track gauge / scale” | Your gauge, e.g. H0 1:87, N 1:160, G 1:22.5. |
| “Units” | “Centimeters (cm)”, “Millimeters (mm)” or “US — inches (in) and mph” – for the whole interface, including the track plan, Trains window, throttle, calibration run, sequence nodes and log. With US, LoDi-Aura also shows prototype speeds in mph; the speed levels of the Ks and Hl signals are then called 25, 40 and 60 mph. Display only: calculations, storage and driving are done in centimetres and km/h. The setting belongs to the layout. |
| “Turnout length (cm)” | How long an average turnout is on your layout. Applies to turnouts without their own dimension and is included in path lengths. |
| “Default block length (cm)” | The default for every newly created feedback sensor (200 cm), as long as no sensor provides a real length. Existing blocks keep their length. |
| “Plan size width”, “Plan size height” | How far the track plan extends, i.e. how far the view can pan. Tracks can be anywhere; if the size is set too small, part of the layout isn't deleted but can't be reached. “Measure plan size” works out the size from the layout. |
Display
| Setting (“Display” section) | Meaning |
|---|---|
| “Train scale (px/cm)” | Empty = automatic, from the layout. Purely visual, doesn't change the driving behaviour. |
| “Cable routing” | “Diagonal”, “Right-angled” or “Curved”: how the cables run to the modules in the track plan. Display only, applies to the whole layout. |
| “Block box size (×)” | Keeps the block boxes readable when you zoom out. |
| “Gliding train dead time (s)” | How many seconds the train in the track plan lags behind reality. Between two feedback sensors, LoDi-Aura calculates where the train currently is; if that puts it at the end of the block slightly too early, the train in the picture briefly waits there for the sensor. With a dead time, the track plan draws with a slight delay and smooths out such hiccups. Empty = 0.5 s, 0 = live. It makes no difference to driving. The blocks still change colour immediately; with a long dead time, the drawn train is therefore sometimes still in the old block. |
Speed defaults
The “Driving” section contains the speed defaults: standard values in km/h that can be overridden locally – at the turnout, at the station, on the train. There are also two settings for turnouts.
| Setting | Meaning |
|---|---|
| “Layout (km/h)” | The normal running speed when nothing else applies. |
| “Station (km/h)” | Speed within the station area. |
| “Hp2 · Slow speed (km/h)” | Applies when the route leads over a diverging turnout. The lower value wins. Is entered into turnouts that haven't been adjusted yet. |
| “Crawl to the stopping point (km/h)” | The speed at which the train rolls the last few centimetres up to the stopping point. Empty = old fixed value of 6 cm/s. |
| “Shunting move (km/h)” | Upper limit for shunting, for the whole layout (Stations, shunting and staging yards). |
| “Stop tolerance (m prototype)” | Within this distance of the stopping point, the train counts as arrived – in prototype metres, so the same value works in every gauge. Empty = old fixed value of 1.5 cm on the model. |
| “Turnout travel time (s)” | How long a turnout motor on the command station (DCC, Motorola) takes to throw; slow motor drives and servos need a few seconds. Only then does LoDi-Aura release the section for the train. Can be overridden per turnout in the inspector. Empty or 0 = don't wait. Turnouts on the LoDi-Shift-Commander don't need this value: LoDi-Aura reads their switching time from the device. |
| “Turnouts when the command station connects” | What LoDi-Aura does with a command station's turnouts as soon as it goes online. “Set last known position” (default): as LoDi-Aura last knew them; a turnout with no known position goes to its home position. “Set home position”: all to their home position. “Do not set”: nothing at all. The signals of this command station then show what the track plan shows. Turnouts in a booked route or under a train that LoDi-Aura knows about are left as they are. If the command station's track power is off, LoDi-Aura sets them as soon as it is switched on – for up to three minutes. |
To put all turnouts in their home position at the push of a button, use “🧰 Tools ▾” › “↺ Turnouts to home position” in the track plan. You set each turnout's home position in the inspector (Turnouts and signals).
RailCom
| Setting (“Feedback” section) | Meaning |
|---|---|
| “RC guard: immediate stop on wrong-way run/intruder (level 2)” – Administrator | On (default): a train that RailCom reports in the wrong place is stopped immediately. Off: you only get a warning (⚠ in the track plan), no automatic stop. The warning level is always active. |
| “Turnout guard: emergency stop if the turnout behind the stop block reports occupied” – Administrator | Only takes effect when the train itself is standing at the block boundary – then the occupancy behind it can only be the train itself: it has overrun the stopping point. Off = just a log entry. |
| “Learn the RC direction of the blocks from driving” – Administrator | Off (default): LoDi-Aura only reports when RailCom consistently shows the opposite direction on a block; the setting in the block inspector remains yours. On: LoDi-Aura reverses such blocks itself. Careful: a loco with a reversed decoder reports wrongly on every block – then LoDi-Aura learns the wrong thing. The calibration run calibrates independently of this. |
| “Relocate by RailCom” | LoDi-Aura always places trains from the depot: if the RailCom address of a depot train is reported steadily and unambiguously in an occupied block, that's where it is. This setting applies to trains that are already on the track plan: only once the sensor under the train has been clear for 5 seconds and its number has gone from there does the train follow it into the block where it reappears steadily – for example after you've moved a loco by hand. Trains with a driving order keep following the feedback sensors; a train with several locos only moves if all its numbers are read there. Off (default): a placed train is never moved by RailCom. |
Protection and short circuits
| Setting (“Safety” section) | Meaning |
|---|---|
| “Protection distance (cm)” | Behind the train, the route is only released once the end of the train plus this margin has passed. Protects you when only the loco reports occupancy. |
| “Protection time (s)” | In addition to the protection distance: how many seconds the section behind the train stays locked. |
| “Behavior on short circuit” – Administrator | “Stop affected trains (default)”, “Stop all trains” or “Report only”. If a booster channel reports a short circuit, the affected trains immediately get speed step 0 and continue by themselves as soon as power is back. |
Automation
| Setting (“Operation” section) | Meaning |
|---|---|
| “Detour automation” – Administrator | “Off — a waiting train stays put”, “Only when stopped (after ~10 s wait)” or “Immediately at the first blocked block”. If the way ahead stays blocked, the automation looks for a detour to the same destination; the part already travelled stays, and so does the direction, always. Free-roaming trains with no way to their destination turn around. Can be overridden per train (Trains form, “Detour”) – but “Off” here applies to all trains. |
| “When stopped, complete rebooking is allowed” – Administrator | Allows the automation, when stopped, to rebook the part of the route already travelled as well, instead of just the rest. |
| “Roamer wait time (s)” | How long a free-roaming train waits in front of an occupied station track before it moves out of the way onto a line block, freeing up its own block. Empty or 0 = 30 seconds. If it's set very high, two trains can hold each other up. |
Driving and Automation explain how the automation drives.
Program start
| Setting (“At startup” section) | Meaning |
|---|---|
| “Lights on locos always on” – Administrator | When connecting, LoDi-Aura switches on F0 (headlights) on all locos of trains that are standing on a block in the track plan. Locos in the depot stay dark. |
| “Exact simulation” – Administrator | Switches the dry run from the simplified to the exact simulation. Only change it while the simulation is not running (Trying it without a layout). |
| “Connect devices at startup” – Administrator | Connects the devices automatically when the program starts. “Online” only means that LoDi-Aura is talking to the hardware – you still decide whether anything moves, for example with “🟢 Start”. |

