{"id":51302754,"url":"https://github.com/u2n4/dualled-pro","last_synced_at":"2026-06-30T21:32:29.479Z","repository":{"id":368083880,"uuid":"1283457998","full_name":"u2n4/dualled-pro","owner":"u2n4","description":"๐ŸŽฎ Real-time RGB lightbar control for PS5 DualSense \u0026 PS4 DualShock 4 โ€” with a live 3D controller view, 10 lighting effects, battery alerts \u0026 profiles. Python/Tkinter.","archived":false,"fork":false,"pushed_at":"2026-06-29T00:28:49.000Z","size":33,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-29T02:12:44.420Z","etag":null,"topics":["3d","controller","desktop-app","dualsense","dualsense-controller","dualshock","gamepad","gaming","gui","hid","led","lightbar","playstation","ps4","ps5","python","rgb","rgb-lighting","tkinter","windows"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/u2n4.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-29T00:20:45.000Z","updated_at":"2026-06-29T00:28:53.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/u2n4/dualled-pro","commit_stats":null,"previous_names":["u2n4/dualled-pro"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/u2n4/dualled-pro","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/u2n4%2Fdualled-pro","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/u2n4%2Fdualled-pro/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/u2n4%2Fdualled-pro/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/u2n4%2Fdualled-pro/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/u2n4","download_url":"https://codeload.github.com/u2n4/dualled-pro/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/u2n4%2Fdualled-pro/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34984784,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-30T02:00:05.919Z","response_time":92,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["3d","controller","desktop-app","dualsense","dualsense-controller","dualshock","gamepad","gaming","gui","hid","led","lightbar","playstation","ps4","ps5","python","rgb","rgb-lighting","tkinter","windows"],"created_at":"2026-06-30T21:32:28.599Z","updated_at":"2026-06-30T21:32:29.466Z","avatar_url":"https://github.com/u2n4.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# ๐ŸŽฎ DualLED Pro\n\n### Real-time RGB lightbar control for PS5 DualSense \u0026 PS4 DualShock 4 โ€” with a live 3D controller view\n\n[![Python](https://img.shields.io/badge/Python-3.8%2B-3776AB?logo=python\u0026logoColor=white)](https://www.python.org/)\n[![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-555?logo=windows\u0026logoColor=white)](#-installation)\n[![License: MIT](https://img.shields.io/badge/License-MIT-22c55e.svg)](LICENSE)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-ff69b4.svg)](CONTRIBUTING.md)\n[![Made with Tkinter](https://img.shields.io/badge/UI-Tkinter-FFD43B?logo=python\u0026logoColor=333)](https://docs.python.org/3/library/tkinter.html)\n\n[![GitHub stars](https://img.shields.io/github/stars/u2n4/dualled-pro?style=social)](https://github.com/u2n4/dualled-pro/stargazers)\n\n**Pick any color, run a lighting effect, watch your battery โ€” and see it mirrored on a 3D model of your actual controller, in real time.**\n\n๐Ÿ‡ฌ๐Ÿ‡ง English ยท ๐Ÿ‡ธ๐Ÿ‡ฆ [ุจุงู„ุนุฑุจูŠ](#-ุจุงู„ุนุฑุจูŠ)\n\n![DualLED Pro โ€” PS5 DualSense with an animated RGB lightbar](assets/hero.png)\n\n\u003c/div\u003e\n\n---\n\n## โšก Easy install (no Python needed)\n\n**Don't have Python? No problem.** Open **PowerShell** and paste this **one line** โ€” it installs Python (if you don't have it), downloads the app, installs everything, and opens it automatically:\n\n```powershell\nirm https://raw.githubusercontent.com/u2n4/dualled-pro/main/install.ps1 | iex\n```\n\n\u003cdetails\u003e\n\u003csummary\u003e๐Ÿ‘‰ How do I open PowerShell?\u003c/summary\u003e\n\n1. Press the **Windows key**.\n2. Type **`powershell`**.\n3. Click **Windows PowerShell**, paste the line above, press **Enter**.\n4. Wait. The app opens by itself when it's done. โœ…\n\n\u003e If you see a message asking you to open a **new** PowerShell window, just close it, open PowerShell again, and paste the same line once more.\n\n\u003c/details\u003e\n\nTo run it again later, just paste the same line โ€” or use the shortcut printed at the end of the install.\n\n\u003e ๐Ÿ›  Manual install (for developers) is in [Installation](#-installation) below.\n\n---\n\n## โœจ Features\n\n- ๐ŸŽจ **10 lighting modes** โ€” Manual, Rainbow, Pulse, Flash, Breathing, Heartbeat, Wave, Gradient, Sequence, Random.\n- ๐Ÿ•น๏ธ **Live 3D controller view** โ€” a 3D PS5/PS4 model whose lightbar mirrors the real one **100% in sync**.\n- ๐Ÿ” **Auto-detects your controller** โ€” picks the correct PS5 (DualSense) or PS4 (DualShock 4) model automatically.\n- ๐Ÿ”‹ **Battery monitor \u0026 alerts** โ€” low-battery, plugged-in, and full-charge notifications.\n- ๐Ÿ’พ **Profiles** โ€” save and switch named color/effect presets instantly.\n- ๐ŸŒ **Bilingual UI** โ€” English \u0026 Arabic (ุงู„ุนุฑุจูŠุฉ), switchable at runtime.\n- ๐ŸชŸ **Fullscreen + tray** โ€” runs fullscreen, minimizes to tray instead of quitting.\n- ๐ŸŒŒ **Animated starfield background** (toggleable).\n- ๐ŸŽ›๏ธ **Headless / background mode** โ€” drive the lightbar with no window via the CLI.\n- ๐Ÿงฉ **Single file, zero build step** โ€” one `dualled_pro.py`, pure Python + Tkinter.\n\n\u003e **Scope, honestly:** DualLED Pro is focused on **lighting, battery, and presets**. It is *not* a music-reactive / macro / scheduling suite โ€” it does one thing and does it cleanly.\n\n---\n\n## ๐Ÿ“ธ Screenshots\n\n| 3D sync view | Effects \u0026 profiles |\n|---|---|\n| ![3D view](assets/screenshot-3d.png) | ![Effects](assets/screenshot-effects.png) |\n\n\u003c!-- Add real PNGs to assets/. Placeholders are fine until then. --\u003e\n\n---\n\n## ๐Ÿš€ Installation\n\n\u003e **Requires Python 3.8+** and a controller connected over **USB** (Bluetooth works too on most setups).\n\n```bash\n# 1. Clone\ngit clone https://github.com/u2n4/dualled-pro.git\ncd dualled-pro\n\n# 2. (recommended) virtual env\npython -m venv .venv\n# Windows:\n.venv\\Scripts\\activate\n# macOS / Linux:\nsource .venv/bin/activate\n\n# 3. Install dependencies\npip install -r requirements.txt\n\n# 4. Run\npython dualled_pro.py\n```\n\n**Minimal install** (just enough to run):\n\n```bash\npip install -U pydualsense hidapi psutil\npython dualled_pro.py\n```\n\n### Windows driver note (PS5 DualSense)\n\nFor `pydualsense` to talk to a DualSense, Windows needs the **WinUSB/libusb** driver bound to the controller. The simplest path is [Zadig](https://zadig.akeo.ie/): select the DualSense device โ†’ install **WinUSB**. (PS4 / generic HID controllers usually work without this.)\n\n---\n\n## ๐ŸŽ›๏ธ Usage\n\nLaunch the GUI:\n\n```bash\npython dualled_pro.py\n```\n\nRun **headless** (no window โ€” uses your last saved settings):\n\n```bash\n# Drive the lightbar in the background\npython dualled_pro.py --background\n\n# Auto-stop after 30 minutes, then turn the lightbar off\npython dualled_pro.py --background --stop-after 30 --off-on-exit\n```\n\n| Flag | Description |\n|---|---|\n| `--background` | Run without the UI, using the last saved color/mode. |\n| `--stop-after N` | Automatically stop after `N` minutes (background mode). |\n| `--off-on-exit` | Turn the lightbar off when exiting. |\n\nConfig and logs live in your OS app-data folder (`%APPDATA%\\DualLED_Pro` on Windows).\n\n---\n\n## ๐Ÿงฉ How it works\n\n```\nโ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” HID โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” color/effect โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”\nโ”‚ Controller โ”‚ โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–บ โ”‚ DualLED Pro โ”‚ โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–บ โ”‚ Lightbar โ”‚\nโ”‚ PS5 / PS4 โ”‚ โ—„โ”€โ”€โ”€โ”€โ”€โ”€โ”€ โ”‚ engine + UI โ”‚ โ”‚ (real RGB) โ”‚\nโ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ battery โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜\n โ”‚ mirror\n โ–ผ\n โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”\n โ”‚ Live 3D model โ”‚ same color, in sync\n โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜\n```\n\nA background engine thread computes the current color (solid or animated effect) and pushes it to the physical lightbar over HID, while the Tkinter UI renders a 3D controller whose lightbar is tinted with the exact same value.\n\n---\n\n## ๐Ÿค Contributing\n\nPRs and issues are welcome โ€” see [CONTRIBUTING.md](CONTRIBUTING.md). Good first contributions: more controller models in the 3D view, extra effects, packaging recipes (PyInstaller spec, `.app`/AppImage), and translations.\n\n## ๐Ÿ“œ License\n\n[MIT](LICENSE) ยฉ u2n4\n\n## ๐Ÿ™ Acknowledgements\n\nBuilt on [`pydualsense`](https://github.com/flok/pydualsense), [`hidapi`](https://github.com/trezor/cython-hidapi), and [`psutil`](https://github.com/giampaolo/psutil). Not affiliated with or endorsed by Sony. PlayStation, DualSense, and DualShock are trademarks of Sony Interactive Entertainment.\n\n---\n\n\u003cdiv align=\"center\" dir=\"rtl\"\u003e\n\n## ๐Ÿ‡ธ๐Ÿ‡ฆ ุจุงู„ุนุฑุจูŠ\n\n# ๐ŸŽฎ DualLED Pro\n\n### ุชุญูƒู‘ู… ู„ุญุธูŠ ุจุฅุถุงุกุฉ ูŠุฏ PS5 (DualSense) ูˆ PS4 (DualShock 4) โ€” ู…ุน ุนุฑุถ ุซู„ุงุซูŠ ุงู„ุฃุจุนุงุฏ ุญูŠ ู„ู„ูŠุฏ\n\nุงุฎุชุฑ ุฃูŠ ู„ูˆู†ุŒ ุดุบู‘ู„ ุชุฃุซูŠุฑ ุฅุถุงุกุฉุŒ ุฑุงู‚ุจ ุงู„ุจุทุงุฑูŠุฉ โ€” ูˆุดูˆูู‡ุง ูƒู„ู‡ุง ู…ู†ุนูƒุณุฉ ุนู„ู‰ ู†ู…ูˆุฐุฌ ุซู„ุงุซูŠ ุงู„ุฃุจุนุงุฏ ู„ู„ูŠุฏ ุงู„ูุนู„ูŠุฉ ู„ุญุธุฉ ุจู„ุญุธุฉ.\n\n### โœจ ุงู„ู…ุฒุงูŠุง\n\n- ๐ŸŽจ **10 ุฃูˆุถุงุน ุฅุถุงุกุฉ** โ€” ูŠุฏูˆูŠุŒ ู‚ูˆุณ ู‚ุฒุญุŒ ู†ุจุถุŒ ูˆู…ูŠุถุŒ ุชู†ูู‘ุณุŒ ู†ุจุถุฉ ู‚ู„ุจุŒ ู…ูˆุฌุฉุŒ ุชุฏุฑู‘ุฌุŒ ุชุณู„ุณู„ุŒ ุนุดูˆุงุฆูŠ.\n- ๐Ÿ•น๏ธ **ุนุฑุถ ุซู„ุงุซูŠ ุงู„ุฃุจุนุงุฏ ุญูŠ** โ€” ู†ู…ูˆุฐุฌ 3D ู„ู„ู€ PS5/PS4 ุฅุถุงุกุชู‡ ุชุชุฒุงู…ู† ู…ุน ุงู„ูŠุฏ ุงู„ุญู‚ูŠู‚ูŠุฉ 100%.\n- ๐Ÿ” **ูƒุดู ุชู„ู‚ุงุฆูŠ ู„ู†ูˆุน ุงู„ูŠุฏ** โ€” ูŠุนุฑุถ ุงู„ู†ู…ูˆุฐุฌ ุงู„ุตุญูŠุญ (PS5 ุฃูˆ PS4) ุชู„ู‚ุงุฆูŠุงู‹.\n- ๐Ÿ”‹ **ู…ุฑุงู‚ุจุฉ ุจุทุงุฑูŠุฉ ูˆุชู†ุจูŠู‡ุงุช** โ€” ุชู†ุจูŠู‡ ุนู†ุฏ ุงู†ุฎูุงุถ ุงู„ุดุญู†ุŒ ุงู„ุชูˆุตูŠู„ุŒ ูˆุงู„ุงูƒุชู…ุงู„.\n- ๐Ÿ’พ **ู…ู„ูุงุช ุชุนุฑูŠู** โ€” ุงุญูุธ ูˆุจุฏู‘ู„ ุจูŠู† ุฅุนุฏุงุฏุงุช ู„ูˆู†/ุชุฃุซูŠุฑ ู…ุญููˆุธุฉ ููˆุฑุงู‹.\n- ๐ŸŒ **ูˆุงุฌู‡ุฉ ุซู†ุงุฆูŠุฉ ุงู„ู„ุบุฉ** โ€” ุนุฑุจูŠ ูˆุฅู†ุฌู„ูŠุฒูŠุŒ ุชุชุจุฏู‘ู„ ุฃุซู†ุงุก ุงู„ุชุดุบูŠู„.\n- ๐ŸชŸ **ู…ู„ุก ุงู„ุดุงุดุฉ + ุชุตุบูŠุฑ ู„ู„ุดุฑูŠุท** ุจุฏู„ุงู‹ ู…ู† ุงู„ุฅุบู„ุงู‚.\n- ๐ŸŒŒ **ุฎู„ููŠุฉ ู†ุฌูˆู… ู…ุชุญุฑูƒุฉ** (ู‚ุงุจู„ุฉ ู„ู„ุฅูŠู‚ุงู).\n- ๐ŸŽ›๏ธ **ูˆุถุน ุฎู„ููŠ ุจุฏูˆู† ูˆุงุฌู‡ุฉ** ุนุจุฑ ุณุทุฑ ุงู„ุฃูˆุงู…ุฑ.\n- ๐Ÿงฉ **ู…ู„ู ูˆุงุญุฏุŒ ุจุฏูˆู† ุฃูŠ ุจู†ุงุก** โ€” `dualled_pro.py` ูู‚ุทุŒ ุจุงูŠุซูˆู† + Tkinter.\n\n\u003e **ุจุตุฑุงุญุฉุŒ ู†ุทุงู‚ ุงู„ุจุฑู†ุงู…ุฌ:** DualLED Pro ู…ุฑูƒู‘ุฒ ุนู„ู‰ **ุงู„ุฅุถุงุกุฉุŒ ุงู„ุจุทุงุฑูŠุฉุŒ ูˆุงู„ุฅุนุฏุงุฏุงุช ุงู„ู…ุญููˆุธุฉ**. ู…ูˆ ุจุฑู†ุงู…ุฌ ุชูุงุนู„ ู…ุน ุงู„ู…ูˆุณูŠู‚ู‰ ูˆู„ุง ู…ุงูƒุฑูˆู‡ุงุช ูˆู„ุง ุฌุฏูˆู„ุฉ โ€” ูŠุณูˆู‘ูŠ ุดูŠ ูˆุงุญุฏ ูˆูŠุณูˆู‘ูŠู‡ ู†ุธูŠู.\n\n---\n\n### ๐Ÿ“ธ ู„ู‚ุทุงุช ุงู„ุดุงุดุฉ\n\n| ุนุฑุถ ุซู„ุงุซูŠ ุงู„ุฃุจุนุงุฏ ู…ุชุฒุงู…ู† | ุงู„ุชุฃุซูŠุฑุงุช ูˆุงู„ุฅุนุฏุงุฏุงุช |\n|---|---|\n| ![3D view](assets/screenshot-3d.png) | ![Effects](assets/screenshot-effects.png) |\n\n\u003c!-- ุถูู ุตูˆุฑ PNG ุญู‚ูŠู‚ูŠุฉ ููŠ ู…ุฌู„ุฏ assets. --\u003e\n\n---\n\n### โšก ุงู„ุชุซุจูŠุช ุงู„ุณู‡ู„ (ุจุฏูˆู† ุจุงูŠุซูˆู† ูˆู„ุง ุฃูŠ ุดูŠ)\n\n**ู…ุง ุนู†ุฏูƒ ุจุงูŠุซูˆู†ุŸ ุนุงุฏูŠ.** ุงูุชุญ **PowerShell** ูˆุงู„ุตู‚ ู‡ุฐุง **ุงู„ุณุทุฑ ุงู„ูˆุงุญุฏ** โ€” ูŠุซุจู‘ุช ุจุงูŠุซูˆู† ู„ูˆ ู…ุง ู‡ูˆ ู…ูˆุฌูˆุฏุŒ ูŠุญู…ู‘ู„ ุงู„ุจุฑู†ุงู…ุฌุŒ ูŠุฑูƒู‘ุจ ูƒู„ ุดูŠุŒ ูˆูŠูุชุญ ุงู„ุจุฑู†ุงู…ุฌ ุชู„ู‚ุงุฆูŠุงู‹:\n\n```powershell\nirm https://raw.githubusercontent.com/u2n4/dualled-pro/main/install.ps1 | iex\n```\n\n**ูƒูŠู ุชูุชุญ PowerShellุŸ**\n1. ุงุถุบุท ุฒุฑ **Windows**.\n2. ุงูƒุชุจ **`powershell`**.\n3. ุงูุชุญ **Windows PowerShell**ุŒ ุงู„ุตู‚ ุงู„ุณุทุฑ ููˆู‚ุŒ ุงุถุบุท **Enter**.\n4. ุงุณุชู†ู‰. ุงู„ุจุฑู†ุงู…ุฌ ูŠูุชุญ ุจู†ูุณู‡ ู„ู…ุง ูŠุฎู„ู‘ุต. โœ…\n\n\u003e ู„ูˆ ุทู„ุนุช ู„ูƒ ุฑุณุงู„ุฉ ุชู‚ูˆู„ ุงูุชุญ ู†ุงูุฐุฉ PowerShell **ุฌุฏูŠุฏุฉ** โ€” ุณูƒู‘ุฑ ุงู„ู†ุงูุฐุฉุŒ ุงูุชุญ PowerShell ู…ุฑุฉ ุซุงู†ูŠุฉุŒ ูˆุงู„ุตู‚ ู†ูุณ ุงู„ุณุทุฑ.\n\nู„ุชุดุบูŠู„ู‡ ู…ุฑุฉ ุซุงู†ูŠุฉ ุจุนุฏูŠู†: ุงู„ุตู‚ ู†ูุณ ุงู„ุณุทุฑุŒ ุฃูˆ ุงุณุชุฎุฏู… ุงู„ุงุฎุชุตุงุฑ ุงู„ู„ูŠ ูŠุทู„ุน ู„ูƒ ุจู†ู‡ุงูŠุฉ ุงู„ุชุซุจูŠุช.\n\n### ๐Ÿš€ ุงู„ุชุซุจูŠุช ุงู„ูŠุฏูˆูŠ (ู„ู„ู…ุทูˆุฑูŠู†)\n\n\u003e ูŠุญุชุงุฌ **ุจุงูŠุซูˆู† 3.8+** ูˆูŠุฏ ู…ูˆุตูˆู„ุฉ ุนุจุฑ **USB** (ุงู„ุจู„ูˆุชูˆุซ ูŠุดุชุบู„ ุจุนุฏ ุนู„ู‰ ุฃุบู„ุจ ุงู„ุฃุฌู‡ุฒุฉ).\n\n```bash\n# 1. ุงู†ุณุฎ ุงู„ู…ุณุชูˆุฏุน\ngit clone https://github.com/u2n4/dualled-pro.git\ncd dualled-pro\n\n# 2. (ูŠููุถู‘ู„) ุจูŠุฆุฉ ุงูุชุฑุงุถูŠุฉ\npython -m venv .venv\n.venv\\Scripts\\activate\n\n# 3. ุฑูƒู‘ุจ ุงู„ู…ุชุทู„ุจุงุช\npip install -r requirements.txt\n\n# 4. ุดุบู‘ู„\npython dualled_pro.py\n```\n\n**ุชุซุจูŠุช ุณุฑูŠุน** (ุฃู‚ู„ ุดูŠ ูŠูƒููŠ ู„ู„ุชุดุบูŠู„):\n\n```bash\npip install -U pydualsense hidapi psutil\npython dualled_pro.py\n```\n\n\u003e **ู…ู„ุงุญุธุฉ ุฏุฑุงูŠูุฑ ูˆูŠู†ุฏูˆุฒ (ูŠุฏ PS5 DualSense):** ุนุดุงู† ู…ูƒุชุจุฉ `pydualsense` ุชูƒู„ู‘ู… ุงู„ูŠุฏุŒ ูˆูŠู†ุฏูˆุฒ ูŠุญุชุงุฌ ุฏุฑุงูŠูุฑ **WinUSB/libusb** ู…ุฑุจูˆุท ุจุงู„ูŠุฏ. ุฃุณู‡ู„ ุทุฑูŠู‚ุฉ ุนุจุฑ [Zadig](https://zadig.akeo.ie/): ุงุฎุชุฑ ุฌู‡ุงุฒ DualSense โ† ุซุจู‘ุช **WinUSB**. (ูŠุฏ PS4 / ุงู„ุฃุฌู‡ุฒุฉ ุงู„ุนุงู…ุฉ ุบุงู„ุจุงู‹ ุชุดุชุบู„ ุจุฏูˆู† ู‡ุฐุง.)\n\n---\n\n### ๐ŸŽ›๏ธ ุงู„ุงุณุชุฎุฏุงู…\n\nุดุบู‘ู„ ุงู„ูˆุงุฌู‡ุฉ:\n\n```bash\npython dualled_pro.py\n```\n\nุดุบู‘ู„ู‡ **ุจุฏูˆู† ูˆุงุฌู‡ุฉ** (ูŠุณุชุฎุฏู… ุขุฎุฑ ุฅุนุฏุงุฏุงุช ุญูุธุชู‡ุง):\n\n```bash\n# ุชุดุบูŠู„ ุงู„ุฅุถุงุกุฉ ุจุงู„ุฎู„ููŠุฉ\npython dualled_pro.py --background\n\n# ูŠูˆู‚ู ุชู„ู‚ุงุฆูŠุงู‹ ุจุนุฏ 30 ุฏู‚ูŠู‚ุฉุŒ ูˆูŠุทูู‘ูŠ ุงู„ุฅุถุงุกุฉ\npython dualled_pro.py --background --stop-after 30 --off-on-exit\n```\n\n| ุงู„ุฃู…ุฑ | ุงู„ูˆุธูŠูุฉ |\n|---|---|\n| `--background` | ูŠุดุชุบู„ ุจุฏูˆู† ูˆุงุฌู‡ุฉุŒ ุจุงุณุชุฎุฏุงู… ุขุฎุฑ ู„ูˆู†/ูˆุถุน ู…ุญููˆุธ. |\n| `--stop-after N` | ูŠูˆู‚ู ุชู„ู‚ุงุฆูŠุงู‹ ุจุนุฏ `N` ุฏู‚ูŠู‚ุฉ (ูˆุถุน ุงู„ุฎู„ููŠุฉ). |\n| `--off-on-exit` | ูŠุทูู‘ูŠ ุงู„ุฅุถุงุกุฉ ุนู†ุฏ ุงู„ุฎุฑูˆุฌ. |\n\nุงู„ุฅุนุฏุงุฏุงุช ูˆุงู„ุณุฌู„ุงุช ุชู†ุญูุธ ููŠ ู…ุฌู„ุฏ ุจูŠุงู†ุงุช ุงู„ู†ุธุงู… (`%APPDATA%\\DualLED_Pro` ุนู„ู‰ ูˆูŠู†ุฏูˆุฒ).\n\n---\n\n### ๐Ÿงฉ ูƒูŠู ูŠุดุชุบู„ ุงู„ุจุฑู†ุงู…ุฌ\n\n```\nโ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” HID โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” ู„ูˆู†/ุชุฃุซูŠุฑ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”\nโ”‚ ุงู„ูŠุฏ โ”‚ โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–บ โ”‚ DualLED Pro โ”‚ โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–บ โ”‚ ุงู„ุฅุถุงุกุฉ โ”‚\nโ”‚ PS5 / PS4 โ”‚ โ—„โ”€โ”€โ”€โ”€โ”€โ”€โ”€ โ”‚ ู…ุญุฑู‘ูƒ + ูˆุงุฌู‡ุฉ โ”‚ โ”‚ (RGB ูุนู„ูŠ) โ”‚\nโ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ ุจุทุงุฑูŠุฉ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜\n โ”‚ ุงู†ุนูƒุงุณ\n โ–ผ\n โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”\n โ”‚ ู†ู…ูˆุฐุฌ 3D ุญูŠ โ”‚ ู†ูุณ ุงู„ู„ูˆู†ุŒ ู…ุชุฒุงู…ู†\n โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜\n```\n\nุฎูŠุท (thread) ุจุงู„ุฎู„ููŠุฉ ูŠุญุณุจ ุงู„ู„ูˆู† ุงู„ุญุงู„ูŠ (ุซุงุจุช ุฃูˆ ุชุฃุซูŠุฑ ู…ุชุญุฑู‘ูƒ) ูˆูŠุฑุณู„ู‡ ู„ู„ุฅุถุงุกุฉ ุงู„ูุนู„ูŠุฉ ุนุจุฑ HIDุŒ ูˆุจู†ูุณ ุงู„ูˆู‚ุช ูˆุงุฌู‡ุฉ Tkinter ุชุฑุณู… ูŠุฏ ุซู„ุงุซูŠุฉ ุงู„ุฃุจุนุงุฏ ุฅุถุงุกุชู‡ุง ุจู†ูุณ ุงู„ู„ูˆู† ุจุงู„ุถุจุท.\n\n---\n\n### ๐Ÿค ุงู„ู…ุณุงู‡ู…ุฉ\n\nุงู„ู€ PRs ูˆุงู„ู€ issues ู…ุฑุญู‘ุจ ููŠู‡ุง โ€” ุดูˆู [CONTRIBUTING.md](CONTRIBUTING.md). ุฃููƒุงุฑ ู„ู„ู…ุจุชุฏุฆูŠู†: ู†ู…ุงุฐุฌ ูŠุฏ ุฅุถุงููŠุฉ ููŠ ุงู„ุนุฑุถ 3DุŒ ุชุฃุซูŠุฑุงุช ุฌุฏูŠุฏุฉุŒ ูˆุตูุงุช ุชุบู„ูŠู (PyInstaller / `.app` / AppImage)ุŒ ูˆุชุฑุฌู…ุงุช.\n\n### ๐Ÿ“œ ุงู„ุชุฑุฎูŠุต\n\n[MIT](LICENSE) ยฉ u2n4\n\n### ๐Ÿ™ ุดูƒุฑ\n\nู…ุจู†ูŠ ุนู„ู‰ [`pydualsense`](https://github.com/flok/pydualsense) ูˆ [`hidapi`](https://github.com/trezor/cython-hidapi) ูˆ [`psutil`](https://github.com/giampaolo/psutil). ุบูŠุฑ ุชุงุจุน ู„ุดุฑูƒุฉ Sony ูˆู„ุง ู…ุนุชู…ุฏ ู…ู†ู‡ุง. PlayStation ูˆ DualSense ูˆ DualShock ุนู„ุงู…ุงุช ุชุฌุงุฑูŠุฉ ู„ู€ Sony Interactive Entertainment.\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fu2n4%2Fdualled-pro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fu2n4%2Fdualled-pro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fu2n4%2Fdualled-pro/lists"}