Car Roster
Power Pool
Freight Cars
Waybill Pool
Layout Status
Virtual Dispatcher
Quick Op Session
Demo Layout
Locations
Industries
Commodity β Car Type
Car Types
Fast Clock
Operations Mode
Dispatcher
Help
Build your fleet by photographing each car β AI instantly identifies the car type, reporting marks, road number, and color.
- Click + Add Car via Photo to photograph or upload an image. AI fills in all fields automatically.
- Click ποΈ Select From Library to pick from previously uploaded photos.
- Use β¨ Generate Stylized Illustration to create an artistic rendering of your car.
- Click + Add Car Manually to enter car details without a photo. Select a car type and, if a default image has been assigned to that type, a banner will offer to use it automatically.
- Cars without a personal photo display their car type's default image on the roster grid, detail view, and operations list β if one has been assigned in Layout Setup β Car Types.
- Click any car card to open its full details: waybills, movement history, location.
- Edit or delete a car from its detail view. Deleting a car removes all associated waybills and movement history.
Waybills route cars between locations. Each car can have up to 4 sequential waybill slots β a full operating cycle.
- Open a car's detail view and use the Waybills tab to add, edit, or reorder waybill slots.
- Each waybill defines: origin, destination, industry, commodity, and whether the car travels loaded or empty.
- Use Generate Waybills (Waybills tab) to automatically create waybills from your layout industries.
- Use Auto-Assign to match unassigned waybills to available cars by type and routing logic.
- Define commodity rules (e.g. grain β covered hopper) in Layout Setup to guide auto-assignment.
- At session end, each car's active waybill slot advances automatically to the next slot.
Define the geography of your model railroad: locations, industries, car types, and commodity rules.
- Locations have four types: Yard (staging hub), Industry (car destination), Staging (off-layout staging), Storage (parked cars awaiting assignment).
- Industries are attached to locations and have a role:
- Consumer β receives loaded cars inbound; define inbound car types and inbound commodities.
- Producer β ships loaded cars outbound; define outbound car types and outbound commodities.
- Transload β both receives and ships; configure both inbound and outbound fields.
- Use β¨ AI Suggest next to any industry name to let AI fill in role, commodities, and accepted car types automatically. AI reuses existing commodity names where possible.
- Car Types β add or remove car types available in the roster. Each car type can have a default image assigned from the Photo Library; this image is shown for any car of that type that has no personal photo.
- Bundled default images in
static/images/car-types/are assigned automatically at startup (named by car type, e.g.boxcar.png). - Use Set image on any car type row to pick a different image from the Photo Library.
- Use Clear to remove the assignment; the bundled default will be restored on next server restart.
- Bundled default images in
- Commodity β Car Type mappings tell the auto-assign system which car type to use for each commodity.
- Use β¨ next to any commodity to get an AI suggestion for the correct car type.
- Use β Seed Defaults to populate a starter set of commodityβcar-type mappings.
- Configure the Fast Clock start time and speed in the Fast Clock section at the bottom.
Run a realistic ops session from plan to wrap-up. The Quick Op Session tab drives the session lifecycle.
- Click π Start Quick Op Session to generate the session's switch list from current car positions and waybills.
- The switch list is divided into three groups: Set out from staging (cars arriving at industries), Cars to spot (storage cars needing placement), and Pick up for staging (cars departing industries).
- For each car, tap Done when the car has been moved to its destination, or CP (Car Placement) to temporarily park it at another location.
- Click any car thumbnail to open its full detail view mid-session.
- When all cars are worked, click β¬ End Session. Waybill slots auto-advance and car locations update.
- CP cars require you to assign a location before the session can end.
- Use β Cancel Session to abandon a session without saving any moves.
- Session state persists across browser refresh β pick up where you left off.
The fast clock simulates prototypical railroad time during a session. A 4Γ clock means 15 real minutes = 1 model hour.
- Configure Start Time and Speed in Layout Setup β Fast Clock section.
- Speed options: 1Γ (real time), 2Γ, 4Γ, 6Γ, or 12Γ.
- The clock starts automatically when you begin a session. If another session is already running (on another browser or tab), the existing clock continues β it is not reset.
- Click βΈ to pause the clock; click βΆ to resume.
- Click βΊ to reset the clock back to the configured start time. All connected browsers re-sync within 15 seconds.
- Clock state is stored on the server β refreshing the page resumes the clock from the correct model time.
- The clock stops automatically when the session ends or is cancelled.
WAYPOINT uses AI in several places to reduce manual data entry. Most AI features are included with your subscription β no configuration needed to get started.
- Car identification β Upload a photo of a car and AI identifies type, reporting marks, road number, and color. Included with your subscription.
- Industry suggest β The β¨ AI Suggest button in the industry form fills in commodities, car types, and role based on the industry name. Included with your subscription.
- Commodity suggest β The β¨ button in the commodity mapping form suggests the correct car type for any commodity. Included with your subscription.
- Stylized illustration β The β¨ AI panel on the car add/edit form generates an artistic rendering of your car. Requires a paid Gemini API key β enter yours in the Settings tab to enable this feature.
- Bringing your own API key β If you have your own Gemini, Claude, or OpenAI API key, you can enter it in the Settings tab. Your key is used instead of the shared key and counts against your own quota. A paid Gemini key is required for stylized illustration.
- AI calls automatically retry on transient provider errors (rate limits, overloads) before failing.
Use Import Cars in Layout Setup β Data to bulk-load your roster from a CSV file or a JMRI roster XML export.
- Column order does not matter β the importer matches columns by header name.
- Required columns (rows missing either are skipped):
- Reporting marks β header:
reporting_marks,road,marks, orrailroad - Car number β header:
car_number,number,no, ornum
- Reporting marks β header:
- Optional columns:
- Car type β header:
car_type,type, orkind - Color β header:
colororcolour
- Car type β header:
- Example minimal CSV:
road,number
UP,12345
BNSF,98765 - Import shows a preview before committing. Choose Skip duplicates or Replace for cars already in the roster.
- For JMRI XML, export your roster from JMRI (File β Export Roster) and import the resulting
.xmlfile directly.
The Photo Library stores all uploaded images and bundled car type defaults. Access it from Layout Setup β Data β Photo Library.
- Click β¬ Load File(s) to upload one or more images at once β select multiple files in the file picker.
- Images marked in use (blue badge) are attached to a car. Images marked default (green badge) are the bundled car type defaults.
- To delete uploaded images, click thumbnails to select them (a checkmark appears), then click π Delete Selected and confirm. Default images cannot be selected for deletion.
- π Purge Unused removes all uploaded images not currently assigned to any car or car type default in one step.
- Images assigned to a car or set as a car type default are always protected from purge.
- When opened via Set image in Car Types, clicking a thumbnail assigns it as the default for that car type and closes the library.
The Virtual Dispatcher builds capacity-aware consists and manages multiple trains simultaneously from the Operations tab.
- Building a consist β select an origin (staging yard) and a location; a hint line shows a running count as soon as all three dropdowns are filled in. Click + Build Consist. The dispatcher finds cars at the origin whose waybill points into the location (setouts), and cars already in the location whose waybill points back to a yard (pickups).
- Review before committing β + Build Consist and βΊ Rebuild both show a preview of the car list and any warnings first. Click β Confirm & Build (or Confirm Rebuild) to commit it, βΊ Regenerate to recompute from scratch, or Cancel to back out β nothing is saved until you confirm. Rebuilding keeps the consist's train identity and power assignment.
- Removing a car β click the β on any car row in the preview to leave it off this consist. This only works before you confirm; once a consist is built, its car list is fixed until the next Rebuild.
- Multiple consists β you can build as many consists as needed. Each appears as a collapsible card. Cars claimed by one consist are automatically excluded from others.
- Capacity & CP placement β available spots = capacity β cars currently in location + cars being picked up this run. If a car's specific track or industry is too full on top of that, it still rides along rather than being left at origin, with a warning that it will need temporary CP (Car Placement) once the crew gets there.
- Max train length β set a layout-wide cap on how many new cars can board a train in Layout Setup β Dispatcher. Cars already in the area being picked up or re-spotted don't count against this limit.
- Train identity β expand a consist card to assign a train number, name, departure time, engineer, and conductor. Click Save Identity to persist.
- Assign power β expand the card and select locomotives (and optionally a caboose). The same locomotive cannot be assigned to two consists. Start Session is disabled until at least one locomotive is assigned.
- Operations mode β set the layout protocol in Layout Setup (Free, TT&TO, or TWC). This changes the label on the special instructions field in each consist card.
- Starting a session β click Start Session on a consist card to hand it off to the Quick Op workflow. Setouts appear as arrivals; pickups appear as departures.
- Layout Status β the strip at the top of the Operations tab shows current car counts for every location and yard. Click any row to expand and see individual cars with their destinations.
Export and restore your entire layout β locations, industries, cars, waybills, photos, and movement logs β in a single ZIP file.
- Use Export Backup in the Layout Setup Data section to download a complete snapshot.
- Use Import Backup to restore from a ZIP. This replaces all current data.
- Backups are useful for sharing layouts with other operators or recovering from errors.
- Each car's detail view shows its last 5 movements with timestamps and notes.
Try these steps in order if something isn't working as expected.
- Sign out and back in. Your login session can expire silently. Signing out and back in issues a fresh token and fixes most "data not loading" issues.
- Try an incognito / private window. Open a private window, go to your layout URL, and log in fresh. If things work there, the problem is a stale session or cached state in your normal browser β clearing your browser cache will fix it.
- Check you're on the right URL. Make sure the address bar shows your layout's subdomain (e.g.
yourname.waypoint-ops.com). Bookmarks to the wrong URL can land you on a different layout. - Check the browser console for errors. Right-click anywhere on the page β Inspect (or press F12) β click the Console tab β refresh the page. Screenshot any red errors and send them to support.
- Check the network tab. Still in DevTools, click the Network tab β refresh β type
/api/in the filter box. Look at the Status column. Any response that isn't 200 (green) points to the problem β screenshot it and send to support.
If none of the above help, email support@waypoint-ops.com with a description of what you see and any screenshots from steps 4β5.