Torus Train Ops User Guide

Torus Train Ops User Guide

Torus Train Ops turns your layout into an operating railroad. You describe the places, industries and equipment you already have; it works out what traffic that railroad would generate, writes the orders, assigns the cars, and hands each crew member the work in front of them.

The short version: you build your railroad once, then start a session. Each session, orders are generated from your consignments, you assign cars and jobs, and your crew works those jobs until the work is done.

Prefer video? Watch the complete Torus Train Ops How-To Series — eleven short videos that build and run the Cedar River Railroad, the same sample railroad this guide uses.

New to operations? How to run a model railroad operating session explains car forwarding, switch lists and the jobs a crew works, with or without software.

Help is built in. Everything in this guide is also inside the application: Trainmaster → Help & Documentation opens the Help Center with the same guides. Questions, problems or feedback — email support@railworksstudio.com any time.

The Operations Center on the Cedar River Railroad. The seven screens run across the top; the three workspaces — Distribution Desk, Yardmaster, Crew Workspace — open from the cards.

Getting Started

Installing Torus Train Ops, activating your licence and getting your crew connected. It assumes you know model railroading. It does not teach operations; it explains how Torus thinks, so what you already know maps onto what’s on screen.

System requirements

  • Windows 10 or 11 (64-bit), or Linux Mint, Ubuntu or another 64-bit Linux that installs .deb files (see Installing on Linux)
  • About 200 MB of free disk space
  • A local WiFi or wired network, if you want phones, tablets or other computers to join as crew

Torus Train Ops runs entirely on your own computer and local network. No internet connection is needed for day-to-day use, including running a full session with a crew. The only exceptions are activating your licence — a one-time step — and the optional update check at startup. Offline, the update check is skipped and everything else carries on normally. You do need a WiFi network for crew devices. See Connecting crew devices.

Installing

These steps are for Windows. On Linux, see Installing on Linux.

  1. Download the installer from the link provided after your purchase.
  2. Double-click it to run.
  3. Windows may show a blue “Windows protected your PC” screen. This is normal for newly published software and is not a sign anything is wrong. Click More info, then Run anyway.
  4. The installer runs automatically and creates a Torus Train Ops shortcut on your desktop and in your Start Menu.
  5. Open it from that shortcut.

If your antivirus flags the installer, this is a known false positive that new, unsigned software sometimes triggers. Torus Train Ops does not collect or transmit any of your layout data anywhere except your own devices on your own network.

Activating your licence

The first time you open the application, a window tells you your 30-day trial has begun. Everything is unlocked during the trial, and no account or internet connection is needed. Click Continue to start using Torus.

If you have bought Torus, enter your licence key:

  1. Find the key in the email receipt from your purchase.
  2. Copy it and paste it into the box under already purchased? on that first window. Later on, click Enter License Key at the top of the application instead; it is there for the whole trial.
  3. Click Activate. Activating needs an internet connection once.

The window says Torus Train Ops is activated and stays until you close it, so you know it worked. If the key is not activated, a red box says why — the key was refused, there was no connection, or the key is already on as many computers as it allows — and what to do next. On the first window you can still click Continue with the Trial and enter the key later.

When the trial ends, Torus asks for a key before it opens. Your railroad is safe and unchanged, and entering a key unlocks it straight away. Create Backup on that window saves a copy of your railroad first, if you want one.

Once activated, your licence is remembered on this computer. You won’t be asked again unless you reinstall Windows or move to a different machine.

First launch: your trial has begun. Click Continue, or paste your licence key under already purchased? and click Activate.

Each licence activates a limited number of computers, shown on your purchase page. To move Torus to another computer, free this one first with Deactivate License — see Danger Zone. If you can’t get to the old computer, email support and we’ll free the slot for you.

Windows Firewall

The first time it runs, Windows may ask whether it can communicate on your network.

  • Click Allow
  • Make sure Private networks is ticked

This happens once, and it’s required for crew devices to connect.

If a crew device still can’t connect, search Windows for Allow an app through Windows Firewall and make sure Torus Train Ops has Private ticked. Your layout network should be set to Private too (Settings → Network & internet → Wi-Fi → your network). There’s no need to turn the firewall off.

Signing in and choosing a role

Each person signs in with their name and a role. Roles decide what that person can see and do, so a whole crew can work from their own devices at once.

RoleWhat they can do
OperatorRun assigned trains and work their cars
DispatcherBuild the work, issue orders and assign crews; everything an Operator can do
TrainmasterConfigure the railroad, change settings, restore backups — full access
Signing in: your name, then a role — Operator, Dispatcher or Trainmaster.

The Trainmaster role can be protected with a PIN, set in Trainmaster → Security. On a fresh install there is no PIN.

Keep your Trainmaster PIN somewhere safe. There is no automatic “forgot PIN” recovery — contact support if you get locked out.

Connecting crew devices

The application runs a small server on the computer it’s installed on. Any phone, tablet or laptop on the same network can join as crew — nothing to install on those devices.

  1. Open Torus Train Ops on the layout computer.
  2. Go to Trainmaster → Connect Crew Devices and read the address shown there — something like http://192.168.1.5:3000.
  3. On the crew device, open a browser and enter that address.
  4. Sign in with a name and role.

Changes made on any device appear on all the others automatically.

Trainmaster → Connect Crew Devices: the address a crew device enters, or a QR code to scan instead.

Every device must be on the same network as the host computer. If one can’t connect, check that your router isn’t isolating devices from each other — this is sometimes called “AP isolation” or “client isolation”.

This is designed for a private network — the one your layout room’s router creates. Avoid running it on public or open WiFi, such as at a show or a club open house, where other people’s devices share the network.

No WiFi where your layout is? Torus doesn’t need the internet, just a WiFi network that the computer and the phones can share. If your layout is in a barn, shed or basement out of reach of your home WiFi, an inexpensive WiFi router plugged in near the layout is all it takes. It doesn’t need an internet connection. Set it up once with your phone, connect the layout computer and your crew’s phones to it, and you’re running. The phones may say “No Internet”. That’s fine; tell them to stay connected. Use the router’s main network, not its Guest network, because guest networks keep devices from seeing each other.

Optional: keep the address from changing. Your router may give the layout computer a different address from time to time, which means a new QR code. If you’d like it to stay the same, so you can print the QR code and pin it up for your crews, look in your router’s settings for Address Reservation (sometimes called DHCP reservation) and reserve one for the layout computer. You can also set a static IP in Windows itself; searching “how to set a static IP Windows 11” will find current instructions.

Where your data lives

Your layout database, photos and backups all live in one folder:

%APPDATA%\Torus Train Ops

Paste that into the File Explorer address bar to open it. Backups are in the backups subfolder. On Linux the folder is ~/.config/Torus Train Ops; see Installing on Linux.

Uninstalling does not delete this folder, so your railroad and its backups survive reinstalling or upgrading.

Backups

Save a backup before any big change and at the end of every session. It takes seconds and it’s the best protection you have.

  1. Go to Trainmaster → Backup & Restore.
  2. Type a name — after-session-3, for instance — and click Save Backup.
  3. To restore, click Restore from File and choose the backup.

Backups are plain files, so you can copy them to a USB drive or cloud storage for a second copy.

Trainmaster → Backup & Restore: name a backup and click Save Backup. Restore from File opens your backups folder — the Cedar River Railroad sample is waiting there too.

Warning: restoring replaces everything currently in the application. Save a backup of your current state first.

Adding photos

Locomotives and cars can each carry a photo.

  1. Edit any locomotive or car.
  2. Click the 📁 button beside the photo field.
  3. Browse to your photo — it’s copied into your data folder automatically.

Supported formats: JPG, PNG, GIF, WebP.

Tip: name photo files after the road number — BRW-487.jpg, NS-7511.png — so they’re easy to find.

Taking the photo with your phone

Your phone can be the camera. Nothing is installed on it, and the picture goes straight to the layout computer over your own WiFi — never online.

  1. On the layout computer, add or edit a car or locomotive and type its reporting mark or number. Torus names the photo file from them.
  2. Click the 📱 button beside the photo field. A QR code appears in the form.
  3. Scan the code with your phone’s camera. The phone must be on the same WiFi as the computer.
  4. Tap Take Photo on the phone and take the picture. It appears in the form on the computer.
  5. Click Save. The photo is kept only when you save; Cancel drops it.

Adding several cars in a row? Click Save & Add Another instead of Save. A blank form opens and the phone stays connected, ready for the next car. Save & Add Another is on the forms for a new car or locomotive, with or without a phone.

Uninstalling

Go to Windows Settings → Apps, find Torus Train Ops and uninstall. On Linux, see Installing on Linux.

Your layout data and backups are not deleted. Back them up first if you want to keep them.

Installing on Linux

The steps above are written for Windows. This part covers only what is different on Linux. Everything else, from connecting your crew to backups, photos and the rest of this guide, works the same.

What you need

  • A 64-bit PC running Linux Mint, Ubuntu, or another Linux that installs .deb files. Torus was tested on Linux Mint 22.
  • About 300 MB of free disk space.
  • A local WiFi or wired network, if you want phones, tablets or other computers to join as crew.

The Linux download is not for Fedora or a Raspberry Pi. They use a different kind of install file.

Installing

  1. Extract the download: right-click the zip file and choose Extract Here.
  2. Double-click torus-train-ops_1.1.0_amd64.deb. The package installer opens.
  3. Click Install and type your computer password when asked.
  4. When it finishes, close the installer.

Linux asks for your password any time software is installed or removed. That’s normal. Using Torus itself never asks for it.

If double-clicking doesn’t offer to install, right-click inside the folder, choose Open in Terminal, and type:

sudo apt install ./torus-train-ops_1.1.0_amd64.deb

Opening Torus

Open your applications menu and look for Torus Train Ops. In Linux Mint it’s under Accessories. Right-click it to add it to your panel or desktop.

Activating your licence

The first time you open Torus, a window tells you your 30-day trial has started. If you’ve already bought Torus, enter your key under Already purchased? and click Activate. Activating needs an internet connection once.

If you buy during the trial, click Enter License Key at the top of the application and enter your key then.

Crew devices and the firewall

Out of the box, Linux Mint and Ubuntu don’t block crew devices, so phones and tablets connect with no changes.

If you’ve turned on the firewall yourself, allow Torus’s port. In a Terminal, type:

sudo ufw allow 3000/tcp

Where your data lives

Your layout database, photos and backups all live in one folder:

~/.config/Torus Train Ops

To open it, open Files, click Home, and press Ctrl + H to show hidden folders. Then open .config, then Torus Train Ops. Backups are in the backups folder. For photos, the Open Photo Folder button in Torus takes you straight there.

Uninstalling does not delete this folder, so your railroad and its backups survive reinstalling or upgrading.

Photo file names

Linux treats capital and small letters as different. GATX4456.JPG and GATX4456.jpg are two different names. If a car’s photo shows on Windows but not on Linux, check that the capitals in the file name match.

Moving your railroad from Windows

  1. On Windows, save a backup (Trainmaster → Backup & Restore).
  2. Copy the backup file and your images folder (from %APPDATA%\Torus Train Ops) to a USB drive.
  3. On Linux, click Restore from File and choose the backup on the USB drive.
  4. Click Open Photo Folder in Torus and copy your photos into it.

Updating

Install the new .deb the same way. It replaces the old version, and your railroad stays.

Uninstalling

Right-click Torus Train Ops in your applications menu and choose Uninstall. Or, in a Terminal:

sudo apt remove torus-train-ops

Your layout data and backups are not deleted.

Installation troubleshooting

The application won’t open

Check the taskbar — only one copy can run at a time, and a second attempt will do nothing if one is already running.

A crew device can’t connect

  • Confirm both devices are on the same network.
  • Check the address on the device matches exactly what the Trainmaster page shows, including the :3000 port.
  • Some routers isolate devices from one another for security; check that setting if nothing else explains it.
  • Make sure the layout network is set to Private in Windows, and that Torus Train Ops has Private ticked under Allow an app through Windows Firewall.
  • Check the crew device is on the router’s main network, not the Guest network.

The licence won’t activate

  • Check the key was copied completely, with no trailing space.
  • Activation needs a brief internet connection.
  • If the message says License activation limit reached, the key is already on as many computers as it allows. Use Deactivate License on one of them (Trainmaster → Danger Zone), or contact support to free a slot.

Do I need an internet connection?

Only to activate your licence. Running sessions is entirely local. You do need a WiFi network so crew devices can reach the layout computer, and it doesn’t have to be connected to the internet.

How do I move Torus to a new computer?

Save a backup and copy it across. On the old computer, use Trainmaster → Danger Zone → Deactivate License. On the new one, install Torus, enter your key, and restore the backup.

Where is my data?

On Windows, in %APPDATA%\Torus Train Ops, alongside photos and backups. On Linux, in ~/.config/Torus Train Ops. Uninstalling doesn’t delete it.

How Torus Works

Its concepts, its workflow, and the order everything happens in.

How Torus thinks, before the detail below. Nothing loads from YouTube until you press play — or watch it on YouTube.

Core concepts

Six ideas carry the whole application.

Locations

A Location is a place on your layout — a town, a yard, a junction, an interchange. Locations nest: a Yard can sit inside a Town, which is how “Millbrook Yard, at Millbrook” is expressed. Settlements (Towns, Cities) are the parents; railroad features (Yards, Junctions, Interchanges) are the children.

A Yard, Interchange or Junction can list its tracks by name — Track 7, Arrival, RIP. This is optional. Leave the list empty and nothing changes; fill it in and Torus can say which track a car is standing on. See Yard tracks.

Industries

An Industry is anywhere a car is worked — a mill, an elevator, a team track, a yard office. Each belongs to one location and has spots: the places a car actually stands. Every spot has a name the crew will read, how many cars fit, and what it is for — Receive / Unload, Ship / Load, Ship & Receive, or Off Spot. Spots on the same physical track share an optional Track Name, so they read together on paperwork: Track 1 · Shipping A.

An industry declares what it receives and what it ships, in commodities. That is what makes traffic possible.

Industries: Riverside Building Supply selected — the jobs that serve it, its one track with two spots, and the cars standing on them. Industry Status sits at the right-hand end of the Operations card; the header holds Edit and Delete.

An industry’s profile reads top to bottom: Operations beside Additional Operating Notes (a long note shows four lines, with Show more), then Tracks & Spots full width, then Commodities beside Rolling Stock, and About This Industry at the foot, holding the description.

Commodities and Car Types

A Commodity is what moves — lumber, grain, coal. A Car Type is what carries it, in AAR codes (XM boxcar, LO covered hopper). Commodities know which car types can carry them, so a boxcar is never assigned to a load that needs a tank car.

Rolling Stock and Locomotives

Your actual equipment. Each car has a road number, a car type, a home location (where it belongs) and a current location (where it is now). Locomotives are assigned to jobs as power.

Torus also gives every car a short tag, such as A21, that you can put on the car so it can be found from the aisle. See Car tags.

Consignments

A Consignment is a standing traffic pattern: this industry regularly ships this commodity to that industry, this many cars at a time. Consignments are rules; they don’t move anything themselves.

This is the piece newcomers most often miss. You don’t have to create orders by hand. You describe recurring traffic once, and each session fresh orders are written from those rules. Get your consignments right and your railroad generates its own work indefinitely. You can still write an order yourself whenever you want one — see Making your own orders.

Routes & Jobs

A Job — a train — has its Locations Served and, optionally, assigned power. A job can pick up a car standing at any of its locations, and either deliver it — when the destination is one of its locations too — or set it out at another of its locations for a later job to take on. The order of the list is only the order the stops appear on switch lists and job briefs; a job may work them in any sequence.

How they fit together

  1. Consignment the rule
  2. Order this session
  3. Assigned to a Car and a Job Distribution Desk
  4. Worked by a crew Crew Workspace
  5. Closed

Follow along with the Cedar River Railroad

A small sample railroad ships with the application: the Cedar River Railroad, a 1980s Midwest short line with three towns, seven industries and two jobs. Go to Trainmaster → Backup & Restore → Restore from File and choose Cedar River Railroad - Sample.json, then close and reopen. It’s the fastest way to see how a finished railroad is put together, and it’s the railroad used in the how-to videos and in this guide.

Warning: restoring replaces everything currently in the application. Back up your own work first — see Backups.

Build Your Railroad

Build Your Railroad holds nine cards in three groups. Build them in this order — each depends on the ones before it.

Build Your Railroad: nine cards in three groups — Foundation, Equipment, Work — in the order to build them.

Foundation

The first three cards, in order. Nothing loads from YouTube until you press play — or watch it on YouTube.

  1. Railroad Profile — name, road name, era, scale. Cosmetic, but it appears on printed paperwork.
  2. Locations — every town, yard, junction and interchange. Create settlements first, then the railroad features inside them. A Yard, Interchange or Junction has an optional list of track names on its form; see Yard tracks.
  3. Car Types — the AAR types you run. A standard set is already there; add or edit as needed. This is the one card that opens a dialog rather than a page of its own, and the same dialog is reachable from the Car Type field on any car. A type’s code is what every car, consignment and commodity refers to it by, so once anything uses a code it can’t be changed — the name and description still can. A code nothing uses yet can be changed freely (GB to GON, say).
Car Types: XM is on the roster, so its code is locked — the name and description can still be edited.

Equipment

What the railroad hauls, and the cars and engines that carry it. Nothing loads from YouTube until you press play — or watch it on YouTube.

  1. Commodities — what your railroad hauls, and which car types can carry each.
  2. Rolling Stock — your cars. Bulk-import from a spreadsheet or JMRI rather than typing; see Import & Export.
  3. Locomotives — your engines, with home locations.
Rolling Stock with CRR 1001 selected: the drawer shows its type, its home, where it stands now — down to the track and spot — the order it is on, and what it carries.

Work

Where cars are worked — tracks, spots, and what each industry receives and ships. Nothing loads from YouTube until you press play — or watch it on YouTube.

The recurring traffic, and the trains that move it. Nothing loads from YouTube until you press play — or watch it on YouTube.

  1. Industries — where cars are worked. For each: its location, its spots — a name, a capacity and a purpose each — and what it receives and ships. Every spot needs a name, and no two spots at the same industry may share one — beyond that, name them however you like: Receiving, WBST1 and 12 are all fine. Spots that make up one physical track take the same Track Name, which is optional. Renaming a spot later carries the cars standing on it along. An industry’s description is capped at 150 words — the editor counts as you type and will not save more — while operating notes have no limit.
  2. Consignments — the recurring traffic between industries. This is where the railroad comes alive. Leave Car Type blank for All compatible car types, and switch a pattern off with Inactive rather than deleting it.
  3. Routes & Jobs — the trains, and the stops each one makes.
Edit Industry — Millbrook Farmers Elevator: where it is, what it receives and ships, and its spots — each with a name, what it is for, and how many cars it holds.
The editor counts the description as you type.
Edit Consignment: the Farmers Elevator ships grain to the Riverside Barge Terminal in covered hoppers — how many cars, how often, and how long loading and unloading take.
Routes & Jobs: the Cedar River Local — its route, CRR 101 as power, its briefing, and the permissions that decide what it may pick up and deliver.

Yard tracks

A Yard, Interchange or Junction can list the tracks it has. The list is optional, and it is names only — a track has no capacity and no purpose to set.

  1. Go to Build Your Railroad → Locations and edit the Yard, Interchange or Junction.
  2. Under Yard Tracks (or Interchange Tracks, or Junction Tracks), add a name for each track — Track 7, Arrival, whatever your crew calls it.
  3. Save.

Once a location lists tracks:

  • Setting a car out there offers the tracks, so the crew can say which one the car went on. They can also leave it at No track assigned.
  • The Yardmaster list shows the track under the place name. A Dispatcher or Trainmaster can click the track and pick another one when a car is shifted inside the yard. That move is written in the Wheel Report as a track change.
  • The car editor has a Track field for a car whose Current Location lists tracks.
  • The Location Profile shows each track and how many cars are on it.

The track shows on screen. Printed switch lists are unchanged. Renaming a track carries the cars standing on it along. Staging and Terminal locations do not take a track list, and industries keep their own spots, as before.

Car tags

A road number is hard to read from the aisle, most of all in the smaller scales. A tag is a short code — a letter and two digits, like A21 — that Torus gives every car. Put it on the car’s roof, or anywhere you like, and a crew can find A21 at a glance.

  • Torus gives the tags. Every car has one, and a new car gets the lowest tag nobody holds. Tags can’t be edited, so a tag already on a car stays right. A car keeps its tag when you restore a backup.
  • Where you see it: on the Rolling Stock list under the car’s photo, in the car’s details, and on the car form.
  • Print Tags, on the Rolling Stock page (Trainmaster), gives two choices. Print tag sheet opens the print window with every car’s tag, sized to cut out for an HO car; use the print window’s scale for bigger or smaller. Export tag list (CSV) saves a file with every car’s tag and car number, for a label program.
  • On paper switch lists: turn on Trainmaster → Railroad Operations → Car Tags on Paper Switch Lists and each car’s tag prints in small type under its reporting mark. It is Off until you turn it on.

Tags are optional to use. The reporting mark and number are still the car’s identity; the tag is only a help in finding it. Locomotives don’t have tags.

Start small, name things your way

Tip: start smaller than you think. Three industries and two jobs produce a real, working session you can learn from in an evening, and nothing has to be redone when you add the rest of the layout later.

Names are yours. Locations, industries, tracks, commodities and jobs can be called anything — full names, abbreviations or plain numbers — and renaming one later updates it everywhere. The one thing that behaves like a key is a car type’s code, above.

Can I rename things once the railroad is running?

Yes. Names aren’t what the railroad runs on — rename a location, industry, track, commodity or job and everything follows. The exception is a car type’s code, which is locked while anything uses it.

Distribution Desk

A session is one operating day. It starts here, where the railroad’s traffic becomes actual work.

This is where consignments become orders. A consignment is the general idea that an industry regularly ships something somewhere. An order is an actual shipment that needs an actual car and an actual job. The Desk is where you manage car orders, waybills and train assignments before pickup: you see the orders, assign the equipment, assign the job that will handle them, and watch each order’s readiness change as it’s prepared for movement.

The flow to keep in your head is simple: a consignment creates an order; the order gets a car and a job; the crew works it; the order is closed. That’s the heart of Torus.

Where consignments become the session’s orders. Nothing loads from YouTube until you press play — or watch it on YouTube.

The Distribution Desk at the start of a session: one order still Open, two with a car and a job assigned, and Issue Car Orders and Auto Assign at the top.

Issue the orders

Go to Operations Center → Distribution Desk and click Issue Car Orders. This opens a new session and writes its orders in one step: your consignments are read, today’s traffic is decided, and the orders appear on the Desk. You’ll be told how many were issued.

For a one-off move that no consignment covers, Manual Order writes a single order by hand: from industry, to industry, commodity, car type, and optionally the job. It’s marked M on the Desk.

What the Desk shows

Each row is one order — one car movement:

  • Consignment — what’s moving, from which industry to which, and the reference to quote (WB-…). A Return badge marks an empty going home.
  • Required Car — the car type the order needs, or Any.
  • Assigned Car — the road number, with the car’s own status under it. Click the number to open the car.
  • Assigned Train — the job that will work it.
  • Readiness — what the order needs next (below).
  • Action — Assign, and Del for an order that hasn’t been picked up yet. Once a car is picked up, the order must be worked, not deleted.

The chips above the list filter by readiness and show a count of each:

ReadinessMeaning
OpenNeeds a car
Awaiting TrainHas a car, needs a job to work it
Awaiting DepartureHas a car and a job; waiting for the crew to pull it

Readiness is a reading of the order, not a status of its own: an order showing Awaiting Train or Awaiting Departure is Applied in the status table below. Awaiting Train is where a return order from Send Empties Home lands — it arrives with its car already attached and needs only a job.

Click anywhere on a row to open the order: its status, the car and where it’s standing, the job handling it, and a timeline of everything recorded against it.

Once the assigned car is picked up, the order leaves the Desk — the railroad is now working that movement. The crew works the train in the Crew Workspace, and Yardmaster tracks and manages the order from there. Consignments in Progress, opposite the chips, opens those orders read-only.

Assign cars and jobs

Every new order starts Open — it knows what needs to move and where, but not which car or which train.

Assign each order by hand from the Desk, or click Auto Assign to match suitable cars and jobs across all unassigned orders at once. An order with both a car and a job becomes Applied, ready for a crew.

To assign by hand, click Assign on the row. The Assign Car & Train dialog offers:

  • Train — the jobs whose Locations Served include the pickup location. Jobs that can’t take the order are listed under Not eligible with the reason: the pickup isn’t in its Locations Served, or the job isn’t permitted to pick up there or deliver to the destination. If no job serves the pickup at all, the dialog says No job serves that location: in Routes & Jobs, edit a job and add the location to its Locations Served.
  • Car — cars that are Available (or set out and waiting for their next train), of the required type, able to carry the commodity, and not already on another active order. Each is listed with its type, status and where it’s standing.
  • Receiver’s Requested Spot — optional, and only the consignee’s working spots are offered. Name the spot the receiving customer has asked for — the door, the dock, the pit — and it prints on the switch list and the waybill, and the crew’s Set Out dialog opens on it once the car is on its way there. Left Unspecified, the crew chooses.

Choose a job and a car and click Save Assignment. A job is required; a car can be left for later.

Assign Car & Train for an Open order: only jobs whose route includes the pickup are offered, and only cars of the right type.

Auto Assign works only on orders with no car. For each one it picks the car and the job together — a job can only be chosen once it’s known where the car is — preferring a car whose home is the pickup location, since that car needs no empty move. It tells you how many were assigned and how many were skipped for want of a matching car or job.

Changing an assignment

Click Assign again on an order that already has a car or a job. The dialog opens with the current choices selected; pick a different job or a different car and save. The car it was taken off goes back to Available.

The car is locked once it has been picked up — the dialog shows Car is active — cannot be changed — because from that moment it’s in the crew’s consist. Re-crewing a car that’s already rolling is done from Yardmaster, not the Desk.

Order statuses

StatusMeaning
OpenWritten, but no car and no job yet
AppliedA car and a job are assigned; ready to be worked
In TransitThe car has been picked up and is moving
WorkingThe car is at its destination being loaded or unloaded
ClosedDone

On the Desk, an Applied order shows as Awaiting Train or Awaiting Departure, depending on whether it has its job yet — see What the Desk shows.

Why an order might not assign

If Auto Assign leaves an order Open, it’s usually one of two things:

  • No suitable car — nothing Available of a car type that can carry the commodity.
  • No job reaches the car — no job has the location where a suitable car stands among its Locations Served, or the jobs that do aren’t permitted to work it.

A full destination is handled a step earlier: when a session is issued, an industry with no free spot on its working tracks isn’t sent more cars that session, so those orders never appear. The Unfulfilled Traffic report names the reason for each one.

Making your own orders

Consignments write the orders for you, but you can write one yourself at any time — for a one-off move, or because you like to build every train by hand.

  1. On the Distribution Desk, click Manual Order.
  2. Choose the From Industry, the To Industry and the Commodity.
  3. Car Type can stay at All compatible car types, or name one.
  4. Assign to Train is optional. Choose a job now, or leave it for later.
  5. Click Save.

The order appears on the Desk as Open, marked M. It is for one car; make another order for each extra car. From there it is like any other order: click Assign to pick its car and job, or let Auto Assign do it, and a crew works it the same way. If no session has been started yet, saving a manual order starts one.

Do I have to create orders by hand?

No. Write consignments once and each session generates its own orders. You can, though: Manual Order on the Distribution Desk writes one order for one car. See Making your own orders.

Crew Workspace

Crews open the Crew Workspace, pick their train and work it. Each pickup and set-out is recorded as it happens.

Picking a train and working it, move by move. Nothing loads from YouTube until you press play — or watch it on YouTube.

Pick up and set out

A crew picks a train on the left and works it on the right. Each move is recorded as it’s made: a pickup marks the car On Train; a set-out spots it and asks whether it’s properly spotted.

The Crew Workspace: pick a train on the left; its work is on the right, grouped by stop, with Pick Up and Set Out for each car.

The dialog opens on where the car is going next: an empty bound for its shipper opens on the shipper, a loaded car on its consignee, and an empty going home on its home location with no industry. If the train does not go there, it opens on a yard or interchange along the route, again with no industry. The crew still chooses — Set Out Location, then Industry, then Spot. Above them the dialog names where the car is headed: Loading required at for an empty for loading, and Final receiver for the customer at the end of the trip.

Set Out: choosing the spot shows how much room is left before you confirm.
The Riverside Turn’s work on a phone.

Car statuses

StatusMeaning
AvailableFree to be assigned
AssignedSpoken for by an order, not yet moved
On TrainPicked up, riding in a train
At IndustrySpotted at its destination
ReleasedWork finished, waiting to be pulled
Held at Yard / InterchangeSet out at a yard or interchange with no industry chosen — waiting for a job to take it on
Held en RouteSet out with no industry chosen somewhere that is neither of those — a town, a junction, staging. Parked partway, waiting for a job to take it on

Two further facts travel with a car: its lading — Loaded or Empty — and, when it’s at an industry, its placement: Properly Spotted or Off Spot.

A car assigned to an order is Empty until it is picked up as its load at the shipper. Until then Torus calls it an Empty for loading: the car’s details read Empty, with For loading: and the commodity and shipper underneath, and switch lists send it to its shipper. See What a switch list line says.

A car may also carry a note about its condition, shown in place of its placement: Awaiting Spot (see Off Spot and Awaiting Spot), or Bad Order and Out of Service (see When a car can’t be worked).

Off Spot and Awaiting Spot

Off Spot is a placement: whether a car standing at an industry is on a spot where its work can actually happen. It only applies to a car at an industry — on a train, or Held at Yard or Interchange, the question does not arise.

A car can be Off Spot by choice: parked on the industry’s Off Spot track, usually because the working spots were full (see When the track is full on arrival). At its destination the car has arrived but the work has not started: the order stays In Transit until the car is properly spotted, nothing loads or unloads, and the car waits there to be moved onto a working spot. Its pill reads Off Spot.

Awaiting Spot is something else: a hold reason, marking a car that was left somewhere it cannot do its order’s work. Torus sets it in these cases, all at an industry:

  • Wrong industry — set out at an industry that is neither the order’s origin nor its destination.
  • Wrong spot function — a spot that cannot do the work the order needs, such as a ship spot for a car that has to unload. Set Out asks Check Spot Usage first; Set Out Anyway marks the car.
  • Wrong commodity — a spot whose commodity list excludes this load. The same check, and the same outcome.
  • Misplaced… — a Dispatcher or Trainmaster stops work on a car that was put to work in the wrong place. See When a car was set out in the wrong place.

While a car is Awaiting Spot:

  • no loading or unloading runs;
  • its status stays At Industry;
  • its order stays In Transit, waiting for a job to move it;
  • wherever Torus shows the car’s condition the pill reads Awaiting Spot rather than Off Spot — Awaiting Spot is checked first;
  • it still counts as off spot, so Industry Status lists it under Off spot.

The mark clears by itself on a correct set-out, onto a spot that can do the work. Picking the car up clears it too, as does deleting the order before the car is picked up.

Awaiting Spot always means Off Spot, but not every Off Spot car is Awaiting Spot: a car parked on an Off Spot track by choice is simply Off Spot.

When the track is full on arrival

Room is checked when orders are issued, not when the train pulls in, so a crew can still find the track full — another job got there first, or a car that should have been pulled wasn’t. The set-out dialog shows how much room each spot has. A full spot is a warning, not a refusal: the note reads Spot full, and Confirm Set Out asks before setting a car out over capacity — the layout is the truth, so a crew that finds room, or makes it, can still put the car there. Otherwise the crew has the same choices a real crew has:

  • Use the industry’s overflow track, if it has one. The car is delivered but sits Off Spot, and comes back onto a switch list for the spotting move once a job is assigned to it.
  • Set it out at a yard or interchange with no industry chosen. The car is Held at Yard or Held at Interchange, the order stays In Transit, and the car waits — on the Yardmaster board under Not Assigned — until you assign a train to continue the movement: a different job, or the same job in a later session. Nothing moves it automatically; the timing is yours. See When the destination can’t take the car.
  • Set it out anyway, if there really is room on the layout. Confirm Set Out asks first, and the car is then spotted where the crew chose and starts its work as normal.

Whichever the crew chooses, the order is not lost and no work is invented.

A full spot warns rather than blocks — Confirm Set Out asks before the car goes on over capacity.

My car is at the right industry but the order isn’t closing.

Check the placement. A car set out Off Spot has arrived but isn’t properly spotted, so its work isn’t complete. If the pill reads Awaiting Spot, the car is somewhere it cannot do the order’s work — the wrong industry, or a spot whose function or commodity does not match — and the order is still In Transit. See Off Spot and Awaiting Spot.

The track was full when my train arrived. What now?

See When the track is full on arrival: use the overflow track, set the car out at a yard or interchange and give it a job when you’re ready, or — if there really is room — confirm the set-out when the dialog asks.

Can I run without a crew?

Yes. Sign in as Trainmaster and work the jobs yourself — everything behaves the same solo.

Yardmaster

Work already rolling — routing, handoffs, and moving the railroad on a session.

Yardmaster is where you manage car routing, handoffs and train assignments while the railroad operates. The crew works the trains in the Crew Workspace; Yardmaster manages and tracks the active orders while they’re being worked. You can see where every car is and what it’s doing, and whenever a car needs another train to continue its movement — from a yard, an interchange, or wherever it was set out — this is where you assign the job that will make it.

Keeping work moving once it is rolling. Nothing loads from YouTube until you press play — or watch it on YouTube.

Yardmaster: CRR 3001 Held at Yard at Cedar Junction under Not Assigned, with the jobs that could take it on. Send Empties Home and Advance Session are at the top.

What the board shows

Each row is one car and the order it’s on:

  • Car — road number and type. Click the number to open the car.
  • Current Location — the location and industry, with the track and spot beneath. At a Yard, Interchange or Junction that lists its tracks, a Dispatcher or Trainmaster can click the track and pick another one; see Yard tracks.
  • Car Status — what the car is doing: Loading, Unloading, Held at Yard, Held at Interchange, Off Spot, or Ready to Pull.
  • Train — the job currently assigned, in the job’s colour; click it to show only that job’s cars. A car with no job assigned reads Not Assigned. Beneath it, the jobs that could take the car are listed, best first — these are suggestions only; nothing is assigned until you assign it.
  • Destination — where the car is going, and the waybill reference. Click the reference to open the waybill (or, for an empty going home, the Empty Car Return slip).
  • Load — the commodity, or the car’s lading if the order names none.
  • Action — Assign.

A row marked at its left edge is a car waiting on a decision: held at a yard or interchange, standing off spot, or ready to pull. A car that is loading or unloading isn’t marked.

The chips filter the board. In Transit and Working are the order’s status; Not Assigned shows every car with no job currently assigned, whichever status its order is in. Click anywhere on a row to open the order — the same view the Desk opens.

Set-outs and the train assignment

When a crew sets a car out, the car is no longer on that train, so its job assignment is cleared and the row reads Not Assigned. At an industry the car may then be loading or unloading; that’s correct — it’s being worked, and no train is assigned to it. When the car later needs another movement, you assign it to the job that will make it.

Loading and unloading

Loading and unloading are counted in operating sessions, as set on the consignment — not in clock time. The work completes in either of two ways:

  • its session count reaches zero as sessions advance (through Issue Car Orders or Advance Session), or
  • a Dispatcher or Trainmaster clicks Complete Now on the car in Industry Status to complete it immediately.

When loading completes, the car is released and loaded, and Yardmaster shows it as Ready to Pull — it’s waiting for a job to take it on. When unloading completes, the car is released and empty, and the order closes. Getting the empty home is a separate movement, handled according to Return Car Behavior in Railroad Operations: with Generate Orders, immediately, or manually with Send Empties Home.

Industry Status

Industry Status is its own page, showing the loading and unloading in progress at every industry. It has no button in the top menu bar. You reach it two ways:

  • From the Operations Center, click an industry row in the Industry Activity panel. The panel lists the top five; the “N more” line is not clickable.
  • From Industries, select an industry and click Industry Status, at the right-hand end of its Operations card. It opens Industry Status with that industry already selected; an industry with nothing on site reads No cars to work at this industry right now.

The left side lists the industries that have cars on site, each with its On site, Loading and Unloading counts, and an Off spot count when there is a car off spot to report. The right side is the selected industry’s work area: one row per car, with the work it is doing and how far along it is — ↓ Unloading · 2 sess, for example.

Two kinds of car are deliberately absent: cars at staging, and a car standing in a Yard location that is not being worked.

Any role can open Industry Status. What you can do there depends on the role: an Operator sees each car and its progress, while a Dispatcher or Trainmaster also gets Complete Now and Misplaced… on a row. (On Industries, Industry Status is open to every role; Edit and Delete, in the header, stay Trainmaster-only.)

Industry Status: Riverside Building Supply, with CRR 1001 unloading and one session left to run.

The ⓘ at the end of a row explains both buttons without leaving the page.

The row’s ⓘ: Complete Now finishes the work without advancing the session; Misplaced… stops it and frees the order.

When a working car’s row is too wide for the window, its badge and buttons move onto a second line, under the car.

When a car was set out in the wrong place

A crew sets a car out somewhere it does not belong — an empty spotted at its destination instead of its shipper, say — and Torus starts loading or unloading it there. The crew reports it, and a Dispatcher or Trainmaster clicks Misplaced… on that car in Industry Status and confirms Stop Work.

That stops the work. The car stays where it is, and:

  • its status stays At Industry and it is marked Awaiting Spot, the same hold Torus uses for a car set out where it cannot do its work;
  • the same order and waybill go back to In Transit with no job;
  • nothing is loaded or delivered, and no return order is made;
  • the movement log records car misplaced at place.

Putting it right is ordinary work rather than a correction screen. The Dispatcher assigns a job to that same order on Yardmaster; the car appears on the crew’s switch list as a pickup, off spot; the crew sets it out at the correct industry; work starts there and the Awaiting Spot mark clears by itself.

Misplaced… is only offered while the car is still loading or unloading. Once the work has finished the order has closed, and recovering the car means writing a manual order.

When a car can’t be worked

Out of Service sidelines a car that needs attention — a coupler to fix, a wheel out of gauge. Tick the box in the car editor and Torus gives that car no work at all, no new loads and no trip home, until you clear it. Rolling Stock shows a badge on the car, and Out of Service is one of the status filters, so the shop list is one click away.

A car that is already on an order cannot be switched out of service — its load still has to be delivered, so the box is greyed out. That car gets Bad Order instead.

Bad Order is for a car that fails during a session. The crew sets it out where it stands and reports it; a Dispatcher or Trainmaster clicks Bad Order… on that car on the Yardmaster board. The waybill stays open. Then one of two things happens:

  • Clear Bad Order — it was repaired where it stood, and it carries on with the same order.
  • Transfer load… — the order and its load move to another available car of the same type, and the waybill goes with the load, exactly as a card is moved to a substitute car on the prototype. The broken car goes home empty and Out of Service.

Out of Service is yours to set and clear, on a car with nothing against it. Bad Order is what happens to a car mid-job, and it always ends either repaired or replaced.

When the destination can’t take the car

If the working spot at the destination is full, Torus warns before the set-out rather than refusing it. The crew can put the car on anyway, over capacity, or choose another option:

  • The industry’s Overflow track, if it has one. The car is set out Off Spot at the destination, and the order stays In Transit — an order goes to Working only once its car is properly spotted. Assign a job to it when a spot opens; that job moves the car onto the working track, and the work begins there.
  • A yard or interchange, with no industry chosen. The car is Held at Yard or Held at Interchange, the order stays In Transit, and the car waits under Not Assigned until you assign a train to continue the movement — a different job, or the same job in a later session.

Nothing moves the car automatically; the timing is yours.

Handoffs

A handoff is a normal part of operating: a job that isn’t taking the car all the way sets it out at a yard or interchange it’s permitted to hand off at. The order stays In Transit, the job assignment clears, and the car sits under Not Assigned until you assign the next job from where the car now is. Same order, same car, same waybill from origin to destination.

Assigning a job from the board

Click Assign on the row. It’s the same Assign Car & Train dialog the Desk uses. Jobs are judged from where the car is standing now, not from the order’s origin — so for a car held at an interchange, the jobs offered are the ones that call there and can carry it on. Jobs that can’t are listed under Not eligible with the reason. If the car has moved from where its order began, the dialog opens as Re-assign and says where the car is now. The car itself can’t be changed once it has been picked up; only the job can.

To put several cars on one job at once, click Multi Re-assign. The toolbar becomes a selection bar and each row gets a checkbox.

  1. Tick the rows you want, or Select All over the current filter.
  2. Click Assign Train.
  3. Choose the job. A job that can’t work every selected car is shown as not permitted for the selection.

Exit leaves selection mode without changing anything.

Multi Re-assign: the toolbar becomes a selection bar — Select All, Clear, Exit — and each row gets a checkbox. Assign Train appears once something is selected; here all three cars are ticked.

Advance Session and Send Empties Home

There is no “close session” step. When the work is done, the Session Closeout report summarises what happened, and the next session begins the next time you click Issue Car Orders — closed orders are cleared at that point.

If you want to move the railroad on a session without issuing new orders — to let loading and unloading progress, for instance — use Advance Session on the Yardmaster page. Send Empties Home there creates return orders for empty cars away from home.

Save a backup at the end of every session.

The Yardmaster toolbar: Multi Re-assign, Send Empties Home and Advance Session, with the board’s filter chips beneath.

Rules the application enforces

Some things are refused outright, with an explanation rather than a silent failure:

  • A car can’t be on two active orders at once.
  • You can’t delete a location, industry, car or job that still has live work against it.
  • An industry holding cars or live work can’t be moved to another location.
  • A spot with cars standing on it can’t be removed from its industry — move the cars first.
  • A spot an open order has asked for as its Requested Spot can’t be removed either — change the Requested Spot on that order first.
  • A car type’s code can’t be changed while any car, consignment, commodity or open order uses it.
  • Every spot needs a name, unique within its industry.

Two Setup edits that are allowed, and what they do to the cars involved: renaming a spot keeps every car on it; changing a car’s Current Industry clears its spot unless the new industry has a spot of the same name.

Why can’t I delete this location?

Something still depends on it: industries, cars, or a job whose route includes it. The refusal message names what.

Can I change my railroad mid-session?

Yes, with care. Setup changes take effect immediately, but an industry holding live work can’t be moved, and deleting anything with work against it is refused.

Switch Lists, Car Cards & Waybills

More than one way to put the same work in front of a crew.

The paperwork, on screen or printed. Nothing loads from YouTube until you press play — or watch it on YouTube.

Choosing how crews see their work

Trainmaster → Railroad Operations decides what a crew is handed. Two settings, and the first outranks the second:

  • Switch List Format — Digital Work Order, worked on screen, or Paper Switch List, a printed sheet.
  • Crew Workspace Format — Digital Workspace or Car Cards & Waybills.

Car Cards & Waybills and Paper Switch List can’t both be on. The card rack is worked on screen, so choosing Car Cards & Waybills puts switch lists back to the Digital Work Order and greys the paper option out. Pick one: the crew reads a switch list, or it reads a packet of cards.

Trainmaster → Railroad Operations: the workspace and switch list formats, the paper style and printed size, and Printed Switch Lists & Waybills with both print-all buttons.
The Digital Work Order: the job's work on screen, stop by stop.
The Paper Switch List for the same job, ready to print.

What a switch list line says

A switch list is one job’s work. Each line names the car, where this job picks it up, and where the car has to get to. The digital switch list and the printed one follow the same rule:

The car isFromToContents
Empty for loading — assigned to an order, not yet loadedWhere this job picks it upIts shipperEMPTY
LoadedWhere this job picks it upIts receiverThe commodity
Empty going homeWhere this job picks it upIts home locationEMPTY

On screen the same three read Empty for loading → shipper, commodity → receiver and Empty → home.

From is where the car is standing when this job lifts it. That is the shipper only when the car starts there; a car another job left at a yard is listed from the yard.

To is where the car is headed, which may be beyond this job’s last stop. When the job can’t take the car all the way, the crew sets it out at one of the job’s own locations for the next job; the Set Out dialog offers those places.

Orders, waybills and car cards are unchanged: they always show the whole shipment, shipper to receiver.

Car Cards & Waybills

The traditional paperwork model, on screen. The left pane holds the job’s packet of car cards; selecting a card pulls the waybill attached to it. A car card belongs to the car; a waybill belongs to the shipment. They are deliberately never merged.

The arrangement is the same on a phone — the rack on the left, the waybill on the right — with a sideways swipe between the two rather than a different layout to learn.

Car Cards & Waybills: the job's packet on the left, a car card with its waybill pocket, and the pulled waybill on the right.

Printing

Printing lives where the paperwork does; there is no separate print centre.

  • Switch lists — with the Paper Switch List format on, the crew’s sheet has a Print button in the Crew Workspace. To print every job’s list for the current session at once, use Print All Switch Lists under Trainmaster → Railroad Operations. The paper style is chosen there too.
  • Waybills — in the Car Cards & Waybills workspace, Print Waybills on a job’s packet prints every waybill in it. Print All Waybills, under Trainmaster → Railroad Operations, prints every waybill for the current work on every job — on any railroad, not only one running Car Cards & Waybills. A single waybill prints from the order itself: open the order from the Distribution Desk or Yardmaster, choose Waybill…, then Print.
  • Waybill cards — a printed waybill is a 2 × 3 inch card sized for a car-card pocket, nine to a Letter page with corner crop marks, and each job starts a new page. Print at Actual size (100%) or the cards come out the wrong size.
  • Car cards and blank forms: Torus prints waybills but not car cards. Printable car cards sized for these waybills, plus blank switch lists in the Modern, Heritage and Office Printout styles, are free on the switch list, car card and waybill templates page.
  • Reports — every report has its own Print button. See Reports.
  • Crew-device QR code — Print QR under Trainmaster → Connect Crew Devices.

Running a session on paper

Paper isn’t all or nothing. There are two ways operators use it:

  • Crews on paper, the desk on screen. Set Switch List Format to Paper Switch List. Crews read printed sheets while the Dispatcher keeps the Yardmaster board open and records the work as the night goes on.
  • Nothing but paper. Print the railroad’s whole night, put the computer away, and run it off clipboards. Torus is told what happened afterwards.

For both, the printed sheet is the plan: Torus takes it that the plan happened, and asks only for what didn’t. That is what Worked as Printed is for, and it is why a paper night costs one screen at the end instead of a screen all evening.

While the night is running Torus knows nothing about it. The Yardmaster board, Industry Status and every report still show where the cars stood when you printed. A session has no clock either, so you can close the application after printing and record the night the next morning — the session will be where you left it.

Print All Switch Lists does work on a digital railroad, and prints the same sheet in the same paper. There is rarely a reason to: a railroad working on screen has its work on screen. The printed sheet appears in the Crew Workspace only when the format is Paper Switch List.

  1. Issue the orders and assign the cars and jobs on the Distribution Desk.
  2. Print All Switch Lists under Trainmaster → Railroad Operations prints every train’s list for the session in one go. Print All Waybills does the same for the waybills.
  3. Run the session on paper. Crews mark their sheets up as they work.
  4. Afterwards, open Worked as Printed… on Yardmaster, beside Advance Session. Every job of the session is listed, each line already reading as printed — picked up, and set out where the car was going. Report only what went differently: left behind, still on the train, set out somewhere else, or on another spot. Then press Record once.

How many times round you go depends on how the work is divided. If each order is worked end to end by one job — the local lifts the car at the shipper and spots it at the receiver — one pass covers the whole night: print, run, record, done. That is the ordinary case.

If a car changes trains during the night — a through freight leaves it at the interchange and the yard switcher takes it from there — record the night in rounds. Record the first sheets, assign the waiting cars to their next job on Yardmaster, print again, and record again, until nothing is waiting. Each round, Print All Switch Lists prints only the jobs that have new work, so a job’s earlier lines are not printed a second time. The number of rounds is the length of the longest chain of hand-offs rather than the number of hand-offs: every first leg prints together, and every second leg prints together in the round after it.

On a railroad that runs nothing but paper, those rounds happen before the session rather than after — a round’s sheets can’t be printed until the round before it has been recorded. That is Pre-Session Processing, below.

Every move recorded that way goes through exactly the same path as a pickup or set-out clicked by hand, so loading, unloading, handoffs, the movement log and the reports all behave as they would have. A line the same job already worked on screen this session is shown as done and skipped, so there is no harm in opening the report twice. Posting it is a Dispatcher’s or Trainmaster’s job, like the rest of the office work — the crew’s own Pick Up and Set Out are untouched.

Torus works out the next session’s traffic from where the cars actually are, so record the session before you issue the next one.

Pre-Session Processing

Pre-Session Processing lets you prepare an entire operating session before crews begin running trains.

Using Print All Switch Lists and Worked as Printed (on Yardmaster, beside Advance Session), you generate switch lists, record the movements as completed, assign cars awaiting their next movement on Yardmaster, and repeat the process until all planned work is accounted for.

The result is a complete set of printed switch lists, ready to distribute to crews before the operating session begins.

If a crew works something differently, correct it afterward with Misplaced, Bad Order, a fresh Pick Up or Set Out, or the car editor. There is no undo for a recorded move.

Note: This workflow records movements in Torus before they physically occur on the railroad.

Reports

What the session leaves behind, and how to read it. Nothing loads from YouTube until you press play — or watch it on YouTube.

The six reports

Reports holds six printable views:

ReportAnswers
Yard InventoryWhat’s standing where, right now
Industry Work ReportWhat each industry is waiting for
Wheel ReportEvery car movement, in order
Unfulfilled TrafficWhat didn’t get done, and why
Operations AnalysisWhether your consignments ask for more than the railroad can carry, and what to change (Trainmaster only)
Session CloseoutA summary of the session just finished
Reports: Yard Inventory open, with its filters, Print and Export CSV.
Session Closeout: what was done this session, and what carries over to the next.

Each report opens with its own filters where they apply — by location, train or session — and every one has Print and Export CSV at the top, so a view can go to paper or into a spreadsheet as it stands.

Operations Analysis

A check-up on your traffic settings, for the Trainmaster. It compares the carloads your consignments will generate over the next 10 sessions with what your tracks and cars can realistically move, and shows:

  • The summary — expected carloads, about how many can move, and whether demand exceeds capacity.
  • Setup problems, each with the fix — for example, a customer with no spot that can receive.
  • Every consignment with its expected carloads, what can move and what stands in its way: a full industry, not enough cars, or a setup problem. Choose Needs attention to see only the ones with a problem.
  • Recommendations — for each full industry or short fleet, the smallest change to Cars Min/Max or Order Interval that would bring it within capacity.
  • Job warnings — a job working at its limit session after session, for information.

Each figure says where it came from. From history means it was worked out from what your crews have actually done in recent sessions; From settings means there isn’t enough history yet, so it comes from your consignment and industry settings. A new railroad starts mostly From settings and moves to From history as you operate.

The report changes nothing itself. Make a change in Consignments (or add a spot or more cars), then press Refresh to see the effect.

Movement history

Movement history is captured at the moment of the move and never recalculated, so a report of last session still says what was true then.

What happens to unfinished work at the end of a session?

It stays open and carries forward — nothing is discarded. The Session Closeout report lists what was left. Closed orders are cleared when the next session is issued, so the board stays current.

Trainmaster

Settings, backups, and how the railroad operates. Visible to the Trainmaster role only.

The Trainmaster page. Railroad Operations on the left; Backup & Restore, Photos & Images and Security on the right. Help & Documentation and the Danger Zone sit below.

Railroad Operations

Decides what a crew is handed: Switch List Format and Crew Workspace Format. See Choosing how crews see their work.

Return Car Behavior is your choice of when Torus creates the movement that sends an empty car back toward its Home Location:

  • With Generate Orders — the return is created the next time you click Issue Car Orders.
  • Immediately — the return is created as soon as the outbound movement is complete and the car is empty and ready to go back.
  • Manually — Torus waits until you click Send Empties Home on the Yardmaster page.

Switch List Paper Style picks the look of the printed sheet: Modern, Heritage, Office Printout, Conductor’s Copy or Work Order. Print All Switch Lists uses this style whichever Switch List Format is chosen. Printed Switch Lists & Waybills holds Print All Switch Lists and Print All Waybills side by side, for every job in the current session at once.

Printed Switch List Size chooses how much of the sheet a printed switch list gets. Half page prints it two-up with the Job Brief beside it, to be folded; Full page gives the switch list the whole sheet, with larger type and boxes, and the Job Brief a page of its own. The Work Order style always prints full width.

Car Tags on Paper Switch Lists is Off or On. On prints each car’s tag in small type under its reporting mark. See Car tags.

Security

The Trainmaster role can be protected with a PIN, set here. On a fresh install there is no PIN. Keep it somewhere safe — there is no automatic “forgot PIN” recovery; contact support if you get locked out.

Connect Crew Devices

The address crew devices use to join, and a QR code to scan. See Connecting crew devices.

Backup & Restore

Save a backup before any big change and at the end of every session; restore from a file. See Backups. The sample railroad is restored from here too — see Follow along with the Cedar River Railroad.

Photos & Images

Locomotives and cars can each carry a photo. See Adding photos.

Danger Zone

The last card on the Trainmaster page holds the red buttons. Each one’s own confirmation says what it does.

Warning: Reset Railroad and Clear ALL Data affect every connected device immediately, and neither can be undone — save a backup first (Trainmaster → Backup & Restore). If you later need the previous railroad back, restoring that backup is the way.

The Danger Zone card on an activated copy: Reset Railroad, Clear ALL Data and Deactivate License.

Reset Railroad clears the operating activity — every order, session, assignment and movement — and puts the railroad back at the start. Everything you built stays: the layout, locations and industries, the roster, consignments, jobs and routes, and all settings. Each car is returned to its Home Location, empty and Available, ready for new operations.

Keep session count and order rotation is ticked by default in the confirmation. Left ticked, the session number, the session records, the movement log, waybill numbering and each consignment’s place in the rotation all survive — so resetting before a session still gives you different traffic than last time. Untick it and those go too, and the next Issue Car Orders begins again at Session 1.

A car with no Home Location has nowhere to be returned to, so it’s left with no current location. Give every car a Home Location before using Reset Railroad.

Clear ALL Data (Start Over) does what it says: it clears all railroad data — locations, industries, cars, locomotives, car types, consignments, jobs, orders, sessions and settings — so you can start over with an empty railroad. You’ll be asked to type CLEAR to confirm. The standard AAR car types are cleared too; if you want them back, Restore AAR Defaults in Car Types puts them in again.

In short: Reset Railroad starts operations over on the railroad you built. Clear ALL Data starts the railroad over.

Deactivate License frees this computer’s activation so your licence key can be used on another computer. It shows only on the layout computer itself, on an activated copy. Torus asks first, needs an internet connection to do it, and then restarts — back into the trial if yours is still running, or asking for a key if it has ended. Your railroad is not touched. To use Torus on this computer again, enter your key again. If the activation can’t be released, Torus says so and your licence stays as it was.

Import & Export

If you already have your roster somewhere else — a spreadsheet you’ve been keeping, an export from JMRI, or data from another program — you don’t need to type it all into Torus Train Ops by hand. Rolling Stock and Locomotives can both be bulk-imported from a plain CSV file.

This section walks through the whole process: preparing your file, mapping its columns to Torus fields, reviewing and fixing anything that needs attention, and completing the import. It also covers exporting a CSV from JMRI specifically, since that has a couple of extra steps worth knowing about.

This is entirely optional. If you’d rather enter cars and locomotives one at a time through the normal Rolling Stock and Locomotives screens, that works perfectly well too — importing is just a shortcut for bringing in a lot of data at once.

The whole run: preparing the file, mapping columns, fixing what the preview flags. Nothing loads from YouTube until you press play — or watch it on YouTube.

Preparing your file

The importer reads plain CSV (comma-separated values) files. This matters because some common spreadsheet formats look similar but are actually completely different file types internally — using the wrong one is the single most common thing to trip up an import.

From Excel, Google Sheets, or LibreOffice

  1. Open your spreadsheet.
  2. Use Save As (Excel/LibreOffice) or File → Download (Google Sheets).
  3. Choose CSV (Comma-separated values) as the file type specifically — not .xlsx, not .ods, not .numbers.

A native LibreOffice (.ods) or Excel (.xlsx) file is actually a small ZIP archive internally, not plain text. Torus will detect this and tell you clearly if you accidentally upload one instead of a real CSV.

From JMRI

JMRI has two separate things both loosely called a “roster,” and it’s easy to use the wrong one:

  • DecoderPro’s “Export Complete Roster” (File menu) — a ZIP bundle meant only for moving your DCC programming roster to another JMRI installation. It is not usable for importing here.
  • Operations’ Locomotives/Cars window → Tools → “Export to file” — this is the one you want. It creates a real CSV file.

If you’ve only ever used DecoderPro for programming decoders and never touched JMRI’s Operations module, your locomotives won’t be in Operations’ roster yet. One extra step first:

  1. In JMRI, open Tools → Operations → Locomotives.
  2. In that window’s own Tools menu, choose Import Locomotives from Roster — this pulls your existing DecoderPro locomotives into Operations.
  3. Still in that same window, go to Tools → Export to file. This creates a real CSV, saved into JMRI’s operations\Export folder.

For rolling stock (cars), the equivalent is JMRI’s Operations → Cars window → Tools → Export to file — no extra import step needed there, since cars normally already live in Operations.

Starting an import

  1. Go to Build Your Railroad → Rolling Stock (or Locomotives).
  2. Click Import from File.
  3. Drop your CSV file onto the window, or click it to browse for the file.
Rolling Stock on a desktop: Import from File and Export CSV beside + Add Car.

If the file isn’t a valid CSV — a spreadsheet saved in its native format, or JMRI’s wrong export type — Torus will tell you specifically what’s wrong instead of showing confusing garbled text.

Importing and exporting are desk work, so Import from File and Export CSV appear on a computer or a tablet rather than on a phone. The phone roster keeps its search, its filters and + Add Car — everything a crew needs at the layout — and the file work waits for a bigger screen.

Mapping your columns

Every source file organizes its columns a little differently, so the next screen shows exactly what columns your file has and lets you say what each one means. Torus makes a reasonable first guess for common column names, but always double-check it.

For each column, choose what it maps to from the dropdown — or leave it as Ignore this column if it’s not something Torus needs. JMRI files especially tend to have many columns with no use here, like Load Count or RFID Code.

Combining two columns into one field

Some sources — JMRI included — split what Torus treats as a single Road Number into two separate columns, like “Road” (e.g. LVR) and “Number” (e.g. 1446). Map both of those columns to Road Number and they will be combined automatically.

Since different files list these columns in different orders, a Swap Order control appears automatically whenever two or more columns map to the same field, showing exactly how they’ll combine — for example 1446 LVR instead of the correct LVR 1446. One click flips the order.

Mapping columns: Road and Number both mapped to Road Number, and the Swap Order control showing how they will combine.

This combine-order control is easy to miss on a long file with many columns — it’s pinned near the bottom of the screen with a gold border specifically so it stands out. If you’ve mapped two columns to the same field, look for it before continuing.

Reviewing before you import

Once your columns are mapped, click Continue to Preview. This screen shows every row from your file and exactly what will happen to it — nothing is saved until you click the final Import button.

Row statuses

StatusMeaning
NewWill be created as a new car or locomotive
UpdateThe Road Number already matches something here, so the existing record is updated instead of creating a duplicate. Spacing, hyphens and capitalization don’t matter — BRW-1001, BRW1001 and brw 1001 all match a car stored as BRW 1001
Fix neededSomething needs your attention before this row can be imported
The preview: rows marked New, Update and Fix needed. A value that matched nothing shows exactly what the file said.

What an update changes

When a row updates a car or locomotive you already have, only the columns that are mapped and filled in are changed. An unmapped column, or an empty cell, leaves the stored value alone. One consequence worth knowing: a car the file moves to a different town comes off the industry it was standing at there.

Home Location, Current Location, and Commodity

These three fields are dropdown-only in the preview — you can never type a value directly into them. This is deliberate: they only work if they match something that already exists exactly, and typing leaves room for a typo that fails silently. Picking from the dropdown makes a mismatch structurally impossible.

If your file’s value doesn’t match anything, the dropdown shows exactly what your file said — for example ⚠ "Coal-Grain" — no match, pick one: — so you know what to look for, and can choose the closest real match or go create that Commodity or Location first if it’s genuinely new.

For new cars, Current Location defaults to whatever Home Location resolves to, if your file doesn’t separately provide one — the sensible starting point for a car just entering the roster. If your file does specify a Current Location but it doesn’t match anything, that still shows up as needing your attention rather than being silently overridden.

Fixing many rows at once

For a home or current location that’s the same across a block of rows:

  1. Click the row number of the first row in the block.
  2. Shift-click the row number of the last row to select the whole range.
  3. Pick the correct value from the dropdown in the first selected row.
  4. Click Fill Down for that field — it applies to every row in your selection.

Repeat for each block that shares a value. For scattered rows with no repeating pattern, click each one and pick from its dropdown; there’s no way to batch those, since each one is genuinely different.

If Current Location should simply match Home Location for every row, Copy Home → Current (all rows) does that in a single click.

Rows 2–4 selected: Fill Down applies the top row's value to the rest.

Duplicates and rows you don’t want

If the same Road Number appears more than once within your file itself — an accidental double entry, for instance — both rows are flagged, naming which other row number they conflict with.

Every row also has a Skip checkbox. Check it and that row won’t be imported, whatever its status — useful for a retired car, or for resolving a duplicate by excluding the one you don’t want. Skipping one side of a flagged duplicate automatically clears the warning on the row you’re keeping.

Completing the import

Once everything looks right, click Import. A backup is saved automatically first, every time, before anything changes — so if this turns out to be the wrong file entirely, restoring that one backup from Trainmaster → Backup & Restore undoes the whole thing in one step, rather than deleting cars one by one.

The final summary tells you exactly what happened: how many were created, how many existing records were updated, and how many were left out — whether because they still needed fixing or because you chose to skip them.

Exporting your data

Both roster screens have an Export CSV button beside Import from File:

  • Build Your Railroad → Rolling Stock → Export CSV
  • Build Your Railroad → Locomotives → Export CSV

The file that comes out is a plain CSV you can open in any spreadsheet — useful for a printed roster, for editing many records at once and importing them back, or simply as a second copy of your data outside the app. Names and descriptions that contain commas or quotation marks are fine; they come through whole in both directions.

Because an export re-imports cleanly, “export → edit in a spreadsheet → import” is a practical way to make bulk changes that would be tedious one record at a time.

An export covers the roster only. For a complete copy of your railroad — locations, industries, consignments, jobs, orders and history — use Trainmaster → Backup & Restore instead.

“This doesn’t look like a valid CSV file”

You likely selected a spreadsheet’s native format (.xlsx, .ods) or JMRI’s DecoderPro roster bundle instead of a real CSV. Re-export using Save As → CSV or, for JMRI, Operations → Tools → Export to file.

A dropdown field won’t match anything

The dropdown shows the exact text your file had for that field. Check that the Location or Commodity actually exists yet under that name — if it doesn’t, either create it first in Build Your Railroad or pick the closest existing match.

I imported the wrong file

Go to Trainmaster → Backup & Restore → Restore from File and choose the backup saved right before the import — its name starts with before-import_. Restoring it undoes the import completely.

Prefer a copy you can print or keep on a tablet?

Thanks for choosing Torus Train Ops. We hope it helps make every operating session more organized, more realistic, and more enjoyable.
— Brian & Diana, Founders, Railworks Studio