WS2812 LED Control APP Guide Python app 

#Instructions for Users

0. Copy Paste WS2812_LED_APP folder to ~home/pi (recommended)

1. Open your terminal in the WS2812_LED_APP folder.
or open terminal and follow commands
cd ~/WS2812_LED_APP

2. Make the scripts executable:
chmod +x setup.sh run_app.sh

3. Install setup following command
./setup.sh
wait for complete

4. Run App with command
./run_app.sh
or 
Open/Execute App from Desktop shortcut

5. Folder Structure (Project files):

ws2812/ (Main folder)

	led_app.so (Your compiled binary)

	main.py (The launcher)

	setup.sh (The installer script)

	run_app.sh (The execution script)

	README.txt (The instructions above)












Based on your instructions and the provided video guide, here is the clear setup process for the WS2812 LED Control App.
WS2812 LED Control App Setup Guide
Follow these steps to install and run the LED controller on your Raspberry Pi.
1. Preparation
 * Download: Download the project files from GitHub.
 * Location: Copy the WS2812_LED_APP folder and paste it into your home directory: /home/pi/ (recommended).
 * Hardware: Ensure your WS2812 LED strip is connected to GPIO Pin 18 [00:10].
2. Installation Steps
 * Open Terminal: Navigate to your project folder:
   cd ~/WS2812_LED_APP

 * Make Scripts Executable: Give the system permission to run your setup and app scripts [04:17]:
   chmod +x setup.sh run_app.sh

 * Run Installer: Execute the setup script:
   ./setup.sh

   * The installer will automatically update the system, install Python dependencies, and create a virtual environment [04:32].
   * Wait until the terminal displays "SETUP COMPLETED SUCCESSFULLY!" [04:58].
3. How to Run the App
You can launch the application in two ways:
 * Desktop Shortcut: Double-click the "LED Control" icon now visible on your Raspberry Pi desktop [05:40].
 * Manual Command: Run it directly from the terminal inside the folder:
   ./run_app.sh

4. Using the App
 * Control: Click color buttons (Red, Green, Blue, etc.) to light the LEDs [00:26].
 * Settings: Click the Gear icon (⚙) next to any color to change its label, "On Time" (seconds), or choose a custom color using the picker [00:40].
 * Auto-Save: Your settings are automatically saved in a JSON format, so they remain the same even after restarting the app [01:10].
Project Folder Structure
After a successful installation, your ws2812/ folder will contain:
 * led_app.so
 * main.py: The application launcher.
 * setup.sh: The one-time installer.
 * run_app.sh: The script to execute the app with necessary permissions.
 * README.txt: A copy of these instructions for offline use.
Official Video Guide: Watch here
YouTube video views will be stored in your YouTube History, and your data will be stored and used by YouTube according to its Terms of Service












May required if not already installed
sudo apt update
sudo apt upgrade -y
sudo apt install -y \
python3 \
python3-venv \
python3-dev \
python3-tk \
build-essential


































Comments











Post a Comment