About
MobaLedLib (Model Railway LED Library) is a comprehensive open-source hardware and software ecosystem designed to animate model railways with realistic lighting, sound, and motion effects. Built around Arduino Nano microcontrollers and addressable RGB LEDs (WS2811/WS2812), it enables hobbyists to add professional-grade effects — such as flickering fire, welding sparks, disco lighting, day/night cycles, and traffic signals — without deep programming knowledge thanks to its visual Program Generator tool. The platform supports both 5V and 12V setups and offers a growing range of custom PCBs including a main board (Hauptplatine), UNO-Shield, Extender, Pushbutton, Servo/MP3 Adapter, and Stepper driver boards. MobaLedLib integrates seamlessly with major model railway control protocols and software, including DCC, mfx, Selectrix, Z21, Rocrail, and iTrain. Advanced features include a Pattern Configurator for custom animations, a built-in Simulator for previewing effects before deployment, HSV color management, multiplexing, virtual LED channels, schedule functions, and turntable (Drehscheibe) control. Sound playback is supported via JQ6500 or direct-connected sound modules. The project is fully documented on its wiki and GitHub repository, with an active community, regular Stammtisch (meetup) events, and extensive 3D-printable enclosure designs. Ideal for model railway enthusiasts, electronics hobbyists, and makers looking to elevate their layouts.
Key Features
- No-Code Program Generator: A visual tool that lets users configure complex LED lighting effects and animations without writing a single line of code, lowering the barrier for model railway hobbyists.
- Wide RGB LED Support: Supports addressable LED strips and modules (WS2811, WS2812, PLCC-2) in both 5V and 12V configurations for flexible layout wiring.
- Model Railway System Integration: Integrates natively with DCC, mfx, Selectrix, Z21, Rocrail, and iTrain, enabling control of effects via existing railway command stations and software.
- Built-in Simulator & Pattern Configurator: Preview and fine-tune LED effects virtually before deploying to hardware, with support for custom animation patterns, multiplexing, and HSV color control.
- Servo, Sound & Motion Support: Controls servos, stepper motors, JQ6500 sound modules, and turntables, enabling full scene animation including moving figures, vehicles, and audio effects.
Use Cases
- Animating model railway building interiors and exteriors with realistic day/night lighting cycles and room-by-room light effects.
- Creating special scene effects such as flickering fire, welding sparks, construction site rotating beacons, and disco lighting for dioramas.
- Controlling traffic signals, street lighting, and vehicle headlights on model railway layouts via DCC or Z21 command stations.
- Adding synchronized sound and motion to model scenes, including moving figures (lumberjack, elevator) triggered by push buttons or schedule functions.
- Building a fully automated turntable (Drehscheibe) controller with stepper motors, DCC addressing, and LED lighting for engine sheds.
Pros
- Completely Free & Open Source: All software, firmware, and PCB designs are freely available on GitHub, making it accessible to hobbyists of any budget.
- Extensive Ecosystem & Community: A rich library of custom PCBs, 3D-printable enclosures, video tutorials, and an active community forum make it easy to get started and find help.
- No-Code to Advanced Flexibility: Beginners can use the Program Generator while advanced users can dive into full Arduino/C++ customization, catering to a wide range of skill levels.
Cons
- Steep Initial Learning Curve: Setting up the hardware (Arduino, custom PCBs, wiring) and understanding the ecosystem can be overwhelming for complete beginners with no electronics experience.
- Primarily German Documentation: Most of the wiki, forum, and community resources are in German, which can be a barrier for non-German-speaking users despite some English content being available.
- Hardware-Dependent: Requires purchasing or assembling physical PCBs and components, meaning there are real-world costs and hands-on assembly involved beyond the free software.
Frequently Asked Questions
What hardware do I need to get started with MobaLedLib?
At minimum you need an Arduino Nano, addressable RGB LEDs (WS2811 or WS2812), and a suitable power supply (5V or 12V). The MobaLedLib main board (Hauptplatine) or UNO-Shield simplifies wiring and is available in the MLL Online Shop.
Is MobaLedLib free to use?
Yes, MobaLedLib is completely free and open source. All software, the Program Generator, firmware, and PCB schematics are available on GitHub at no cost.
Does MobaLedLib work with my existing DCC/Z21 control system?
Yes. MobaLedLib integrates with DCC, mfx, Selectrix, Z21, Rocrail, and iTrain, allowing you to trigger and control lighting effects from your existing model railway command station or software.
Do I need to know how to program to use MobaLedLib?
No. The visual Program Generator allows you to configure and deploy effects without writing code. However, advanced users can also write custom Arduino sketches for full control.
Can MobaLedLib control more than just LEDs?
Yes. In addition to RGB LEDs, MobaLedLib supports servo motors, stepper motors, sound modules (e.g., JQ6500), turntable controllers, push buttons, and relay outputs, enabling full scene animation.
