• Introduction📌
• Technology Used🚀
• Overview⭐
• Features✨
• Input🎛
• Output🎉
• Getting Started💥
• Project Contributors🫂
• Contributing is fun🧡

The Random Disco Light Simulator is a fun and interactive project that brings the excitement of a disco dance floor to your screen. Whether you're a developer, a party enthusiast, or just curious, this simulator provides an engaging experience with dynamic lighting effects.

(back to top)

Click on "Randomize" button to fill the required fields randomly and then press "submit".

• Conic Mode

  • Imagine a spotlight sweeping across the room, creating vibrant cones of light.
  • The colors change dynamically as the spotlight moves, adding an electrifying effect.

• Radial Mode

  • Picture a pulsating ring of light expanding and contracting.

  • The radial pattern syncs perfectly with the beat, making you feel the rhythm.

    

• Linear Mode

  • Visualize colorful streaks of light moving in straight lines.

  • These streaks crisscross, intersect, and dance across the floor, transforming your space into a dynamic disco.

    

• Interactive Controls

  • Customize your experience with interactive controls. Set the number of colors, adjust the time interval for color changes, choose your preferred view type, and set a countdown timer for the duration of the simulation.

    

• Sound Effects

  • Enhance your disco light show with synchronized sound effects. Choose from a variety of soundtracks to match the vibe of your light display.

    

• Chatbot

  • Get instant assistance and friendly guidance with our new chatbot, available to help you every step of the way.

    

• Customizable Settings

  • Experiment with different settings to create your own unique disco light show. Change the music, adjust the visuals, and tweak the settings to find the perfect combination for your party or relaxation time.

Thank you for your interest in contributing to Random Disco Light Simulator! We welcome contributions and are excited to work with the community. This guide will help you get started. 😊

1. Navigate to the Random Disco Light Simulator repository.
2. Click the "Fork" button at the top right of the page.

1. Open GitHub Desktop.
2. Click on "File" > "Clone Repository".
3. Select the forked repository and choose the local path where you want to save it.
4. Click "Clone".

1. In GitHub Desktop, click on "Current Branch" and select "New Branch".
2. Name your branch descriptively, e.g., feature-add-animation.
3. Click "Create Branch".

1. In GitHub Desktop, click on "Repository" > "Open in Visual Studio Code" (or your preferred editor).

1. Make your changes in the code editor.
2. Save your changes.

1. In GitHub Desktop, you should see your changes listed.
2. Enter a summary for your commit and a detailed description if necessary.
3. Click "Commit to your-branch-name".

1. Click "Push origin" in GitHub Desktop to push your changes to your forked repository on GitHub.

1. Navigate to your forked repository on GitHub.
2. Click on the "Compare & pull request" button.
3. Ensure the base repository is sk66641/Random-Disco-Light-Simulator and the base branch is main.
4. Add a title and description for your pull request.
5. Click "Create pull request".

1. The repository maintainers will review your pull request.
2. You may be asked to make additional changes.
3. Once approved, your pull request will be merged into the main branch.

To keep your fork up-to-date with the original repository:

1. Add the original repository as a remote:

   git remote add upstream https://github.com/sk66641/Random-Disco-Light-Simulator.git

2. Fetch the latest changes:

   git fetch upstream

3. Merge the changes into your local branch:

   git checkout main
   git merge upstream/main

4. Push the updates to your fork:

   git push origin main

• Be Descriptive: When naming branches, committing changes, and submitting pull requests, be as descriptive as possible. Clear names and messages help maintainers understand the purpose of your changes. 🗂️
• Follow the Code Style: Ensure your code follows the project's coding standards. Consistency in code style helps maintain readability and maintainability. ✨
• Testing: Thoroughly test your changes to make sure they do not break existing functionality. Writing tests for new features is highly encouraged. 🧪

1. Check Existing Issues: Before opening a new issue, check if the bug has already been reported.
2. Open a New Issue: If the bug is new, open an issue on the Issues page.
3. Provide Details: Include as much information as possible, such as steps to reproduce the bug, expected behavior, and screenshots if applicable.

1. Check Existing Issues: Before suggesting a new feature, check if it has already been proposed.
2. Open a New Issue: If the feature is new, open an issue on the Issues page.
3. Provide Details: Clearly describe the enhancement and why it would be beneficial.

Thank you for contributing to the Random Disco Light Simulator! Your efforts help make this project better for everyone. 🎉🚀

Customize your disco experience with these inputs:

• Number of Random Colors: Select how many random colors you want to dazzle your senses.
• Gradient Colors: Choose your desired start and end colors for the gradient, setting the stage for an unforgettable light show.
• Time Interval: Control how frequently colors change with precision, down to the millisecond.
• View Type: Indulge in your preferred view mode—conic, linear, or radial—each offering a unique visual feast.
• Countdown Timer: Set the duration of your disco journey with a countdown timer, ensuring the party lasts as long as you desire.
• Sound Effect: Elevate your experience further with optional sound effects that sync harmoniously with the dazzling display.

Based on these inputs, the simulator will generate the selected view, creating a dynamic and colorful display.

Now, sit back, relax, and enjoy the dazzling display of lights as you experience your very own disco show! Let the party begin! 😄🌟

(back to top)

• Before creating an issue, use the search feature to check if a similar issue already exists.
• Issues are assigned on the basis of “first come, first served.” Others may get a chance if the issue gets stale and the assignee is inactive for over a week.
• Do not create a Pull Request until the issue has been assigned to you.
• Always mention the issue number for which the Pull Request is being created. You can use one of the following keywords in your PR description or comment to reference the issue: closes #123 fixes #123 resolves #123 implements #123
• Remember to follow this practice to streamline collaboration and keep the project organized! 😊

For detailed instructions on how to contribute to this project, please refer to this document file.

(back to top)