Skip to content

Throttle Web App for DCC-EX CommandStation via direct serial connection using the Chrome web browser, or with DEJA.js (DEJA Server) connected to a DCC-EX CommamndStation.

License

Notifications You must be signed in to change notification settings

jmcdannel/DEJAThrottle

Repository files navigation

DEJA Throttle

Current Release: v0.1.0-alpha

Vue.js 3 Web App to control DCC locomotives with 🛰️ DEJA.js and DCC-EX EX-CommandStation.

Size Limit CLI Size Limit CLI Size Limit CLI Size Limit CLI

🚀 Open DEJA Throttle Take 'er for a spin 🚗. Open in Chrome on a computer 💻 with a USB DCC-EX CommandStation, run trains 🚂! Or, try emulator mode to see how easy it is. Better yet, go big-brain 🧠, dive in and install 🛰️ DEJA.js SERVER on a PC/MAC/Linux/Pi 💻 connected to a DCC-EX CommandStation and unleash all the potential of the DEJA Cloud and instant wireless throttle control📲 on any modern device with a browser.

  • 🤯 Emulator Mode Available
  • 🧠 Install as an app? Click YES for premium experience
  • 💄 Beatiful UI, Dark Mode FTW
  • 🔥 Blazing fast on Vercel, frequent deployments, PRs welcome
  • 🟪 Chonky A$$ Buttons for fat fingers and panic stops

🚀 Getting Started

📦 Prerequisites

There are 3 ways to use DEJA Throttle.

  1. 🛰️ DEJA.js (✨preferred✨)
  • Install and configure 🛰️ DEJA.js on a 💻 PC/Mac/Linux/Pi connected via USB to a DCC-EX EX-CommandStation
  • Open DEJA Throttle - in any modern browser 🔥.
  • Select "DEJA.js" from the connection menu
  • Enter the layout name you used in the .env (Environment Variable) [ LAYOUT_ID ] when installing DEJA.js
  • Select the USB Port the DCC-EX Command Station is connected to.
  • 🎯 Drive Trains, 👑 Rule over your tiny world!
  1. Direct USB Connection (🔗limited🔗)
  • Requires Chrome web browser.
  • Browser must be on 💻 PC/Mac/Linux/Pi connected via USB to a DCC-EX EX-CommandStation - you can't open this on your phone or tablet and walk around a layout room. But you can with ✨🛰️ DEJA.js✨!
  • Open DEJA Throttle
  • Select "USB Serial" from the connection menu
  • Click "Connect" and select the USB port connected to your DCC-EX CommandStation.
  • 🎯 Drive Trains!
  1. Emulator (💄demo the app💄)
  • Open DEJA Throttle
  • Select "Emulator" from the connection menu.
  • Click "Connect" and enter any DCC Address to see how the throttle works and operates.
  • 🎯 (pretend to) Drive Trains!
  • No communication is actually sent to a DCC-EX CommandStation.

📦 Local Installation

Want to run this on your own? Fork it, clone it, PR it. Just don't sell it.

pnpm install
pnpm run start

🧩 Usage

🚀 Open DEJA Throttle Take 'er for a spin. Docs someday...

🗺️ Roadmap

  • Connect DEJA Cloud
  • Enable Turnouts, Outputs (Effects)
  • Enable multiple throttles
  • Read throttle state from DCC-EX
  • Light/Dark/Custom themes
  • much, much more...

🛠️ Built With

Vue TypeScript Tailwind DaisyUI MQTT Vite pnpm ESLint Prettier Autoprefixer

About

Throttle Web App for DCC-EX CommandStation via direct serial connection using the Chrome web browser, or with DEJA.js (DEJA Server) connected to a DCC-EX CommamndStation.

Resources

License

Stars

Watchers

Forks