DDPlan - A modern menubar application built with Electron, Angular and dvbjs that provides real-time timetables for trams, buses and trains in Dresden, Germany.

Light Theme	Dark Theme

• 🚌 Real-time departure information for Dresden public transport
• ⭐ Favorite stops management
• 🌙 Light and dark theme support
• 🔍 Smart stop search with autocomplete
• 📱 Clean, modern interface

Ready to use DDPlan? Download the latest version for your platform:

📥 Download Latest Release

Available for:

• 🍎 macOS - .dmg installer
• 🐧 Linux - .AppImage, .deb, .rpm packages
• 🪟 Windows - .exe installer

Note: The app is not code-signed, so you may need to allow it in your system's security settings when running for the first time.

• Node.js (version 18 or higher recommended)
• npm or yarn package manager

1. Clone the repository

   git clone https://github.com/4gray/ddplan.git cd ddplan

2. Install dependencies

   npm install

npm start # or npm run start:ng

This starts the Angular development server at http://localhost:4200

npm run start:dev

This runs both Angular dev server and Electron in development mode with hot reload.

npm run start:electron

This builds the Angular app and starts Electron.

npm run build # or for Electron npm run build:ng

npm run package:electron

This creates distributable packages for your current platform.

For specific platforms:

# macOS npm run package:electron -- --mac # Linux npm run package:electron -- --linux # Windows npm run package:electron -- --win

npm run watch

This project uses GitHub Actions for automated building and packaging:

• Pull Requests: Automatically builds and tests the app for all platforms
• Tagged Releases: Creates release artifacts for macOS, Linux, and Windows
• Manual Builds: Can be triggered via workflow dispatch

The CI/CD pipeline:

1. Builds the Angular app
2. Runs linting checks
3. Packages Electron apps for all platforms
4. Uploads build artifacts
5. Creates GitHub releases for tagged versions

src/ ├── app/ │ ├── components/ # Angular components │ │ ├── favorites/ # Favorites management │ │ ├── header/ # App header │ │ ├── plan-list/ # Departure times display │ │ ├── search-field/ # Stop search functionality │ │ ├── settings/ # App settings │ │ ├── sidebar/ # Navigation sidebar │ │ └── welcome-screen/ # Initial welcome screen │ ├── interfaces/ # TypeScript interfaces │ ├── services/ # Angular services │ ├── app.config.ts # App configuration │ ├── app.ts # Main app component │ └── store.ts # Signal-based state management ├── assets/ # Static assets └── styles.scss # Global styles 

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

This project is open source. Please check the LICENSE file for details.

Note: This application is not officially affiliated with Dresden's public transport operator (DVB). It's a community project that uses publicly available transport data.