Throttle — DEJA.js Guides

Guide

DEJA.jsThrottle

Walk through a complete session — connect to your command station, add a locomotive, control speed and direction, throw turnouts, and trigger effects.

Video walkthrough coming soon

Make sure you've completed the Getting Started guide — your server should be running and your command station connected.

Navigation

Navigating the App

Two persistent navigation elements are visible on every screen.

🔝 Header Bar

System-level controls and status at a glance.

Menu — Opens the side navigation drawer

App Logo — Tap to go home

Layout Chip — Active layout — tap to switch

Device Status — Connected device count

User Profile — Account menu

Emergency Stop — Immediately halts all trains

🔽 Bottom Navigation

Color-coded icon buttons for quick access. Customize which items appear in Settings.

Throttles — Multi-train grid view

Effects — Sound and lighting effects

Locos — Locomotive roster

Routes — Track route execution

Turnouts — Switch control

Signals — Signal aspect monitoring

Connect

Open Throttle in your browser. The home screen shows your command station's connection status. Green means you're ready to go.

🔌Automatic connection to your DEJA.js server

🟢Status indicators for server, devices, and track power

🕐Speedometer widgets for active throttles

Connection setup referencedocs

Add a Locomotive

Tap the + button on the throttle list to add a locomotive to your session. Enter the DCC address and a name.

🔢Enter DCC address (1–9999) and locomotive name

🏷️Assign a road name (BNSF, UP, CSX, NS, and more)

🖼️Set an image for the locomotive avatar

⚡Appears immediately in the throttle list

☁️ Configured in DEJA Cloud

Full locomotive management happens in DEJA Cloud — configure decoder functions (F0–F28), build consists, and toggle onboard sound.

Roster referencedocs

Select a Locomotive

The throttle list shows all locomotives in your session. Tap one to open full throttle control.

🎴Grid of active throttles with speed, name, and avatar

🔀Drag tiles to reorder (persists between sessions)

🎮Quick control buttons on each tile

📱Responsive — 1 column on mobile, 2+ on desktop

Throttle list referencedocs

Control Speed & Direction

Everything you need to drive. Set speed, change direction, and stop — all from one screen.

🎚️Speed slider (0–126 DCC steps) on desktop/tablet

🔘5-button speed controls (+5, +1, Stop, −1, −5)

↔️Direction — REV / IDLE / FWD (zero speed only)

🛑Brake control (0–10) for gradual deceleration

👉Swipe left/right between active throttles

🅿️Park button — stops the loco and releases it

Throttle control referencedocs

Use Functions

Tap the function button to open the speed dial. Toggle lights, horn, bell, and 25+ decoder features.

🎛️Speed dial with up to 29 function buttons (F0–F28)

💡F0: Headlight, F1: Bell, F2: Horn/Whistle

🔧F3–F28: Decoder-specific (brake, coupler, sounds)

🔗Consist display shows linked multi-unit groups

☁️ Configured in DEJA Cloud

Function labels, icons, and visibility are configured per locomotive in DEJA Cloud.

Functions referencedocs

Operator Station

Conductor Mode

A three-pane layout designed for large screens. Throttle list, active throttle, and turnouts — all in one view.

🖥️Three-pane layout: throttle list + active throttle + turnouts

🚂Select any loco from the left panel to control it center

🔀Throw turnouts from the right panel

📱Panes stack vertically on mobile

Conductor mode referencedocs

Layout Control

Control Your Entire Layout

Beyond driving trains, Throttle gives you control over every aspect of your layout. These features are configured in DEJA Cloud and controlled here in real time.

Turnouts

Throw switches with a tap

Control every turnout on your layout. Tap to toggle between straight and divergent — color changes instantly to show state. Multiple view modes let you operate the way you prefer.