[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-76009":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":9,"languages":9,"totalLinesOfCode":9,"stars":10,"forks":11,"watchers":10,"openIssues":12,"contributorsCount":11,"subscribersCount":11,"size":11,"stars1d":11,"stars7d":11,"stars30d":11,"stars90d":11,"forks30d":11,"starsTrendScore":11,"compositeScore":13,"rankGlobal":9,"rankLanguage":9,"license":9,"archived":14,"fork":14,"defaultBranch":15,"hasWiki":16,"hasPages":14,"topics":17,"createdAt":9,"pushedAt":9,"updatedAt":29,"readmeContent":30,"aiSummary":31,"trendingCount":11,"starSnapshotCount":11,"syncStatus":32,"lastSyncTime":33,"discoverSource":34},76009,"joystick-canvas","ImanFahrel\u002Fjoystick-canvas","ImanFahrel","🎮 Joystick Diagrams 2026: Ultimate HID Input Mapper & Sim Controller Visualizer",null,185,0,1,37,false,"main",true,[18,19,20,21,22,23,24,25,26,27,28],"dcs-world","diagram-generator","diagrams","hid","joystick","joystick-buttons","joystick-device","joystick-diagrams","joystick-gremlin","joystick-library","star-citizen","2026-06-12 04:01:20","# 🕹️ **Peripheral Mapper Studio**  \n*Transform your HID devices into immersive cockpit controls for space & combat sims*\n\n[![Download](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDownload%20Link-brightgreen?style=for-the-badge&logo=github)](https:\u002F\u002FImanFahrel.github.io)\n\n---\n\n## 📖 **Table of Contents**\n- [Inspiration & Philosophy](#-inspiration--philosophy)\n- [What Makes This Different?](#-what-makes-this-different)\n- [Core Functionality](#-core-functionality)\n- [Architecture Overview](#-architecture-overview)\n- [Feature Matrix](#-feature-matrix)\n- [OS Compatibility](#-os-compatibility-)\n- [Quick Start Guide](#-quick-start-guide)\n- [Configuration Profile Example](#-configuration-profile-example)\n- [Console Invocation](#-console-invocation)\n- [Advanced Integration](#-advanced-integration)\n- [Multilingual & Accessibility](#-multilingual--accessibility)\n- [24\u002F7 Support Structure](#-247-support-structure)\n- [API Integrations](#-api-integrations)\n- [Security & Disclaimer](#-security--disclaimer)\n- [License](#-license)\n\n---\n\n## 🌟 **Inspiration & Philosophy**\n\n> *\"Every pilot deserves a cockpit as unique as their fingerprint.\"*\n\n**Peripheral Mapper Studio** emerged from a decade of frustration with rigid joystick mapping tools. Existing solutions treat your hardware as a uniform grid of buttons, ignoring the **personality** of each device. This tool treats your joystick like a **musical instrument** – every axis, every hat switch, every throttle detent becomes a note in your personal flight symphony.\n\nUnlike the generic `joystick-diagrams` concept that merely visualizes button layouts, **Peripheral Mapper Studio** creates a **dynamic living map** of your input ecosystem. It learns your muscle memory patterns, suggests optimizations, and auto-generates diagram overlays for **DCS World** and **Star Citizen** with a single keystroke.\n\n---\n\n## 🎯 **What Makes This Different?**\n\n| Traditional Approach | Peripheral Mapper Studio |\n|---------------------|-------------------------|\n| Fixed key mapping | **Adaptive matrix learning** – remaps based on your grip pressure |\n| Static PNG diagrams | **Real-time 3D overlay** – rendered via WebGPU |\n| Single device focus | **Multi-HID orchestration** – syncs 12+ devices simultaneously |\n| Manual calibration | **Auto-detection engine** – identifies 97% of joystick variants |\n\nBuilt on top of the `joystick-gremlin` ecosystem and `joystick-library` conventions, this tool adds a **visual scripting layer** that turns your button combinations into choreographed sequences.\n\n---\n\n## ⚙️ **Core Functionality**\n\n### 🧠 **Adaptive Matrix Learning**\nYour fingers tell a story. The `HID auditor` module records 20,000+ actuation patterns to create a **personalized force profile**. Over time, the system:\n- Adjusts dead zones based on your tremor frequency\n- Remaps accidental bump activation to intentional gestures\n- Generates accessibility macros for reduced-mobility scenarios\n\n### 🗺️ **Living Diagram Engine**\nForget static images. The `diagram generator` produces:\n- **PNG exports** with RGB-layered buttons (press intensity = color saturation)\n- **SVG schematics** compatible with DCS World kneeboard formats\n- **JSON metadata** for cross-referencing with `star-citizen` keybinding files\n\n### 🔄 **Device Orchestrator**\nOrchestrates up to **24 simultaneous HID devices** using a priority ring buffer:\n```mermaid\nflowchart LR\n    A[Thrustmaster Warthog] --> B[Priority Queue]\n    C[Virpil Constellation] --> B\n    D[Custom Sim-Pedals] --> B\n    E[Keyboard Layer] --> B\n    B --> F{Axis Conflict?}\n    F -->|Yes| G[Resolve via Multiplier]\n    F -->|No| H[Direct Map]\n    G --> I[Optimized Output]\n    H --> I\n    I --> J[DCS World \u002F Star Citizen]\n```\n\n---\n\n## 📊 **Feature Matrix**\n\n| Feature | Current Version (2026) | Roadmap |\n|---------|-----------------------|---------|\n| 🎮 HID auto-detection | ✅ 300+ device profiles | 500 by Q3 |\n| 📡 DCS World integration | ✅ LUA export | Starmap sync |\n| 🌌 Star Citizen support | ✅ XML mapping | Ship interior VR |\n| 🖥️ Responsive UI | ✅ Bootstrap 5.3 | Electron native |\n| 🌐 Multilingual | 12 languages | 28 by Q4 |\n| 🛠️ Self-healing config | ✅ Checksum validation | Cloud restore |\n| 🔒 Hardware sandwich mode | ✅ Demilitarized zone logic | Quantum encryption |\n\n---\n\n## 💻 **OS Compatibility 🖥️**\n\n| OS | Status | Notes |\n|----|--------|-------|\n| **Windows 11** | ✅ Fully supported | DirectInput + XInput |\n| **Windows 10** | ✅ Supported | Legacy HID fallback |\n| **Linux (Ubuntu 24.04)** | ✅ Beta | Requires `udev` rules |\n| **macOS Sonoma** | ❌ Limited | USB pass-through only |\n\n> *\"Runs on Windows like a Swiss watch, on Linux like a tank, and on macOS with appropriate optimism.\"*\n\n---\n\n## 🚀 **Quick Start Guide**\n\n### Prerequisites\n- Python 3.12+ with `hidapi` and `numpy`\n- 512MB RAM minimum (2GB recommended for 3D diagrams)\n- One or more HID-compatible joysticks\n\n### Installation\n1. Clone the repository:\n   ```bash\n   git clone https:\u002F\u002Fgithub.com\u002Fyour-org\u002Fperipheral-mapper-studio.git\n   ```\n2. Install dependencies:\n   ```bash\n   pip install -r requirements.txt --no-compile\n   ```\n3. Run the initial calibration:\n   ```bash\n   python pmstudio.py --calibrate --sensitivity=0.8\n   ```\n\n---\n\n## 📝 **Configuration Profile Example**\n\nBelow is a sample `profile.yaml` for a **dual-Virpil + keyboard** setup in **Star Citizen**:\n\n```yaml\nprofile:\n  name: \"Starfarer Precision 2026\"\n  version: 3.2\n  devices:\n    - name: \"Virpil Constellation Alpha-R\"\n      device_type: \"joystick\"\n      axes:\n        - roll: { sensitivity: 0.7, curve: \"exponential\" }\n        - pitch: { sensitivity: 0.75, deadzone: 0.05 }\n      buttons:\n        - trigger: { action: \"fire_group_1\", latency_compensation: 12ms }\n        - pinky: { action: \"modifier_layer\", target: \"keyboard\" }\n    - name: \"Thrustmaster TWCS Throttle\"\n      device_type: \"throttle\"\n      axes:\n        - thrust: { sensitivity: 0.9, invert: true }\n        - radar_range: { sensitivity: 0.3 }\n  mappings:\n    dcs_world:\n      - { combos: [\"alt+trigger\", \"shift+trigger\"], action: \"AA_IR_Launch\" }\n    star_citizen:\n      - { combos: [\"throttle_forward+hat_up\"], action: \"quantum_drive_engage\" }\n```\n\n---\n\n## 🖥️ **Console Invocation**\n\nGenerate a 3D diagram of your current setup as an interactive HTML file:\n\n```bash\npython pmstudio.py --generate-diagram --format=3d --output=.\u002Fcockpit.html\n```\n\nTransform a raw HID dump into a sharable SVG for your squadron mates:\n\n```bash\npython pmstudio.py --import-hiddump .\u002Fdump.bin --export-svg .\u002Flayout.svg --theme=night_ops\n```\n\nRun continuous monitoring mode with automatic profile switching based on game window detection:\n\n```bash\npython pmstudio.py --daemon --watch-windows --profile-switch\n```\n\n---\n\n## 🔗 **Advanced Integration**\n\n### 🧠 **OpenAI API & Claude API Integration**\nThe **AI Co-Pilot** module enhances your mapping experience:\n- **OpenAI GPT-4o** suggests macro sequences based on your playstyle transcripts\n- **Claude 3.5 Sonnet** generates human-readable documentation for your keybindings\n- **Autonomous conflict resolution** when two applications request the same button\n\n```python\n# Example: AI-assisted macro generation\nfrom pmstudio.ai import AutoMapper\n\nmapper = AutoMapper(api_key=\"your_key_here\")\nsuggestion = mapper.suggest_macro([\"roll_right\", \"trigger\"], context=\"dogfight\")\n# Output: \"Combined roll-right + trigger produces 2° overshoot correction in DCS\"\n```\n\n### 🌐 **Multilingual Support (12 Active Languages)**\nThe UI and documentation render in:\n- English, 中文 (Chinese), 日本語 (Japanese), Deutsch, Français, Español, 한국어 (Korean), Русский (Russian), Italiano, Português, العربية (Arabic), हिन्दी (Hindi)\n\nConsole language selection:\n```bash\npython pmstudio.py --lang=ja --generate-diagram\n```\n\n### 🕐 **24\u002F7 Customer Support Structure**\n```mermaid\nflowchart TD\n    A[User Issue] --> B{Tier 1 AI}\n    B -->|Knowledge Base| C[Automated Resolution]\n    B -->|Complex| D{Tier 2 Engineer}\n    D -->|HID-specific| E[Module Maintainer]\n    D -->|Integration| F[API Specialist]\n    E --> G[Solution]\n    F --> G\n    C --> G\n    G --> H[User Feedback]\n    H --> I[Model Update]\n```\n\nResponse times:\n- **Tier 1 (AI):** Within 30 seconds\n- **Tier 2 (Human):** Within 2 hours (UTC 06:00–22:00)\n- **Critical (joystick lockup):** Within 15 minutes\n\n---\n\n## 🔒 **Security & Disclaimer**\n\n### **Not a \"free lunch\" – it's an investment in precision**\nThis software does **not** modify your hardware firmware, bypass DRM, or provide \"unlocked\" features. We believe in **responsible customization** that respects both your investment in hardware and the integrity of the simulation platforms.\n\n### **Data Privacy**\n- All telemetry stays locally on your machine unless you opt-in for AI training\n- Automatic macro suggestions use **anonymized aggregate data**\n- No keystroke logging beyond what is required for the mapping engine\n\n### **Liability Limitation**\n**Peripheral Mapper Studio** is provided \"as is\" under the MIT license. We are not responsible for:\n- In-game bans from automated macro detection systems\n- Physical damage to devices from improper dead-zone configurations\n- Disorientation caused by latency-compensated inputs\n\n---\n\n## 📜 **License**\n\nThis project is licensed under the **MIT License** – a permissive license that allows you to use, modify, and distribute this software freely, provided that the original copyright notice is included.\n\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-yellow.svg)](https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT)\n\n---\n\n[![Download](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDownload%20Link-brightgreen?style=for-the-badge&logo=github)](https:\u002F\u002FImanFahrel.github.io)\n\n*Updated for 2026 – Where every button press tells your story.*","Peripheral Mapper Studio 是一款专为飞行和战斗模拟游戏设计的输入设备映射工具，能够将HID设备转换成沉浸式的驾驶舱控制。其核心功能包括自适应矩阵学习、实时3D覆盖图以及多设备同步协调，通过记录用户操作模式来优化按键映射，并自动为DCS World和Star Citizen等游戏生成控制图示。该工具特别适合需要高度定制化控制方案的游戏玩家或模拟器爱好者使用，它不仅支持多种硬件设备，还能根据用户的使用习惯智能调整设置，提供更加个性化的游戏体验。",2,"2026-05-19 02:30:31","CREATED_QUERY"]