Skip to content
Rodrigo Torres edited this page Aug 31, 2025 · 8 revisions

Welcome to the wiRedPanda Wiki

wiRedPanda Logo

wiRedPanda is a free, open-source digital logic circuit simulator that makes learning and teaching digital circuits fun and accessible. Whether you're a student, educator, or hobbyist, wiRedPanda provides an intuitive environment to design, simulate, and understand digital logic circuits.

Quick Start

πŸŽ“ For Users & Learners

🀝 For Contributors

Features

✨ What makes wiRedPanda special:

  • Intuitive Interface: Drag-and-drop circuit design with real-time simulation
  • Educational Focus: Perfect for learning digital logic fundamentals
  • Cross-Platform: Available on Windows, Linux, and macOS
  • Open Source: Free forever, with community-driven development
  • Multilingual: Available in multiple languages
  • Extensive Library: Logic gates, flip-flops, displays, and more

Learning Path

New to digital logic? Follow this structured approach to master the fundamentals:

🎯 Phase 1: Binary Logic Fundamentals

Estimated Duration: 2-3 weeks

Master the building blocks of digital systems:

  • Number Systems: Binary, Decimal, Hexadecimal, Octal conversions
  • Boolean Algebra: Logic operations, truth tables, De Morgan's laws
  • Basic Gates: AND, OR, NOT, NAND, NOR, XOR
  • Binary Arithmetic: Addition, subtraction, two's complement

Practice Projects: Build basic gates, create truth tables

🎯 Phase 2: Combinational Logic

Estimated Duration: 3-4 weeks

Learn circuits without memory:

  • Multi-level Logic: Combining gates for complex functions
  • Multiplexers & Demultiplexers: Data routing and selection
  • Encoders & Decoders: Data conversion circuits
  • Adders & Subtractors: Arithmetic circuit design

Practice Projects: Full adder, 4-bit calculator, BCD decoder

🎯 Phase 3: Sequential Logic

Estimated Duration: 4-5 weeks

Explore circuits with memory and timing:

  • Latches & Flip-Flops: SR, D, JK, T flip-flops
  • Registers: Data storage and shift operations
  • Counters: Up/down, binary, BCD counters
  • State Machines: Finite state machine design

Practice Projects: Digital clock, sequence detector, traffic light controller

Project Gallery

Get inspired by these project ideas, organized by difficulty:

🟒 Beginner Projects

  • Half/Full Adder - Learn basic arithmetic circuits
  • 3-input Majority Gate - Practice Boolean logic
  • 7-Segment Display Driver - Connect logic to visual output
  • Simple Calculator - 2-bit addition with display

🟑 Intermediate Projects

  • BCD to 7-Segment Decoder - Number system conversion
  • 4-bit Binary Counter - Sequential logic with clock
  • Multiplexed Display - Time-sharing techniques
  • Simple ALU - Basic arithmetic and logic unit

πŸ”΄ Advanced Projects

  • Digital Clock - Complete timing system
  • Memory System - RAM/ROM implementation
  • CPU Components - Instruction decoder, register file
  • Communication Protocols - UART, SPI simulation

Getting Help

Need assistance? Here are your resources:

  • πŸ“– Documentation: Browse the wiki pages for detailed guides
  • πŸ› Bug Reports: Report issues on GitHub
  • πŸ’¬ Discussions: Join the community
  • πŸ“§ Contact: Reach out to the development team

πŸ”§ Common Issues & Quick Fixes

Installation Problems

  • Qt version conflicts β†’ Use Qt6 for latest features, Qt5 for compatibility
  • Missing dependencies β†’ Follow platform-specific setup in Development Setup
  • Build errors β†’ Ensure CMake and compiler versions match requirements

Usage Issues

  • Circuit not simulating β†’ Check for unconnected inputs or invalid elements
  • Unexpected behavior β†’ Review Simulation Guide for timing and feedback concepts
  • Translation problems β†’ Visit Translation Guide for Weblate usage

Contribution Challenges

  • Git conflicts β†’ Check Git Guide for conflict resolution
  • Code not compiling β†’ Verify environment setup and dependencies
  • Pull request feedback β†’ Join discussions for guidance

Contributing to wiRedPanda

Join our community and help make wiRedPanda even better:

πŸ§‘β€πŸ’» Code Contributions

  • Setup: Follow our development environment guide
  • Guidelines: Check coding standards and contribution workflow
  • Areas: UI improvements, new elements, performance optimizations
  • Process: Fork β†’ Develop β†’ Test β†’ Pull Request

🌍 Translations

  • Weblate: Use our web-based translation platform
  • Languages: Help us reach more students worldwide
  • Process: No technical skills required, just language fluency

πŸ“ Documentation

  • Wiki: Improve tutorials, add examples, fix typos
  • Tutorials: Create learning materials and project guides
  • Videos: Educational content and feature demonstrations

🎨 Design & UX

  • Icons: Design new element icons and UI improvements
  • Themes: Create new visual themes
  • Usability: Suggest and implement UX improvements

πŸ“’ Spread the Word

  • Star the Project: Give us a ⭐ on GitHub to show your support
  • Share wiRedPanda: Tell friends, classmates, and colleagues about this tool
  • Social Media: Share your projects and help us reach more learners

Community Showcase

Share your amazing wiRedPanda projects with the community!

Want to feature your project here? Create a discussion in our Cool Projects section with:

  • Project name and description
  • Screenshot or demo
  • .panda file for others to explore
  • Learning objectives (for educational projects)

Stay Connected


Ready to dive into digital logic? Download wiRedPanda and start building circuits today! πŸš€

With wiRedPanda, digital circuits are no longer intimidatingβ€”they're exciting, educational, and fun!


Made with ❀️ by the wiRedPanda Community
Licensed under GPL-3.0 | Β© 2025 GIBIS-UNIFESP