Sim RaceCenter Director is your mission-critical, on-premise execution engine—the nerve center bridging cloud-based Race Control with your local race center hardware and software ecosystem (OBS, iRacing, and beyond).
Think of it as the broadcast control room for high-performance sim racing operations. This Electron-powered application runs locally on your race center PC, providing secure, real-time orchestration of streams, telemetry, and race events.
- 🔐 Secure Cloud Bridge — Azure AD authentication with local execution
- 🎥 OBS Integration — Broadcast control at your fingertips
- 🏎️ iRacing Telemetry — Real-time race data streaming
- ⚡ High-Performance Architecture — TypeScript + Electron + React
- 🌐 Cross-Platform — Windows, Linux AppImage support
- Security Design & Architecture — Read how we handle authentication and secure token storage.
Before entering the pit lane, ensure you have:
- Node.js 18+ (Download)
- npm or pnpm package manager
- Git for version control
-
Clone the repository
git clone https://github.com/margic/director.git cd director -
Install dependencies
npm install
-
Configure environment
cp .env.example .env # Edit .env with your Azure AD and Race Control credentials -
Start development mode
npm run dev
# Build the application
npm run build
# Create distributable packages
npm run distOutput locations:
- Windows:
release/Sim RaceCenter Director Setup.exe - Linux:
release/Sim RaceCenter Director.AppImage
Development Mode:
npm run devThis starts the Vite dev server and launches the Electron application with hot-reload enabled.
Production Mode:
Run the built executable from the release/ directory after building.
- Authentication — Sign in with your Azure AD credentials
- Cloud Sync — Director establishes secure connection to Race Control
- Local Integration — Configure OBS, iRacing, and other integrations
- Go Live — Execute broadcast operations from the control panel
| Command | Description |
|---|---|
npm run dev |
Start development environment with hot-reload |
npm run build |
Compile TypeScript and build production assets |
npm run dist |
Create platform-specific installers |
|
Frontend Layer
|
Backend Layer
|
┌─────────────────────────────────────────┐
│ Cloud Race Control (Azure) │
│ (Command Center) │
└──────────────┬──────────────────────────┘
│ Secure Bridge
│ (Azure AD Auth)
┌──────────────▼──────────────────────────┐
│ Sim RaceCenter Director (Local) │
│ ┌──────────────────────────────┐ │
│ │ Electron Main Process │ │
│ │ - Auth Service │ │
│ │ - IPC Handlers │ │
│ └──────────┬───────────────────┘ │
│ │ │
│ ┌──────────▼───────────────────┐ │
│ │ React Renderer │ │
│ │ - Control Dashboard │ │
│ │ - Broadcast Management │ │
│ └──────────────────────────────┘ │
└──────────────┬──────────────────────────┘
│
┌────────┴────────┐
│ │
┌─────▼─────┐ ┌─────▼─────┐
│ OBS │ │ iRacing │
│ Control │ │ Telemetry │
└───────────┘ └───────────┘
| Feature | Status | Description |
|---|---|---|
| 🔐 Azure AD Auth | ✅ Active | Secure cloud authentication |
| 🎥 OBS Integration | ✅ Active | Broadcast scene control |
| 🏎️ iRacing API | ✅ Active | Live telemetry streaming |
| 📊 Dashboard UI | ✅ Active | React-based control interface |
| 🌐 Cross-Platform | ✅ Active | Windows + Linux support |
We're always looking for skilled engineers to join the pit crew. Whether you're interested in improving the control interface, optimizing broadcast integrations, or enhancing telemetry features—your contributions are welcome.
- Fork the repository
- Create a feature branch (
git checkout -b feature/telemetry-enhancement) - Commit your changes (
git commit -m 'Add advanced telemetry overlay') - Push to your branch (
git push origin feature/telemetry-enhancement) - Open a Pull Request
- 📝 Follow TypeScript best practices
- 🧪 Write tests for new features (when test infrastructure exists)
- 📖 Update documentation for user-facing changes
- 🎨 Match the existing code style
- ✅ Ensure builds pass before submitting PRs
- 🐛 Issues: GitHub Issues
- 💬 Discussions: GitHub Discussions
- 📺 Updates: YouTube @simracecenter
This project is licensed under the GNU General Public License v3.0.
See LICENSE for full details.
Built with ⚡ by the Sim RaceCenter Team
Race Director. Race Control. Race Smart.