# LaunchPlex

**Repository Path**: R_system/launchplex

## Basic Information

- **Project Name**: LaunchPlex
- **Description**: Launchpad Platform for Light EXecution
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-02-25
- **Last Updated**: 2026-04-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LaunchPlex


## 简介
![launchplex](icon.png)

LaunchPlex(Launchpad Platform for Light EXecution)是一个基于Python开发的， 面向Launchpad Mini MK3的插件化运行时平台。

## 支持设备
- Launchpad Mini MK3

## 项目结构
```bash
  launchplex
    ├─config
    │  ├─permission
    │  │      admin.txt
    │  │
    │  └─start
    │          auto_start.txt
    ├─launchplex
    │      api.py
    │      key.py
    │      main.py
    │      message.py
    │      pad.py
    │      plugin_manager.py
    │      shader.py
    │      __init__.py
    └─plugins
        └─PluginManager
```
## 快速开始
1. 安装Python3.7+
2. 克隆本仓库
3. 安装依赖 `mido` `python-rtmidi`
4. 接入LaunchPad Mini MK3设备
5. 运行 `python launchplex/main.py`

## 插件开发
1. 在plugins目录下创建一个文件夹，文件夹名称即为插件名称。
2. 在插件目录下创建一个main.py文件，并编写插件逻辑。
3. 在插件目录下创建一个__init__.py文件，并编写插件信息。
4. 据需求添加插件权限 （一般插件无需添加）
5. 运行 `python launchplex/main.py`, 通过终端会话或PluginManager插件启动所开发的插件。

例如编写一个依次点亮所有按键的插件
  ```bash
    plugins
      └─light_all   # 假设插件名称为light_all
          main.py
          __init__.py
  ```
  ```python
  # main.py
  import launchplex as lpx  # 引入launchplex模块
  import time

  def main(ctx):  # 插件主函数， 参数ctx为插件上下文
      pad = lpx.LaunchpadKeyboard(context=ctx)  # 创建键盘对象
      while True:
          if if_stop:
            time.sleep(1)
          else:
              for i in range(8):
                  for j in range(8):
                      pad.shader.set_color(row = i, col = j, color = i * 8 + j) # 调用shader模块函数点亮按键
                      pad.update()  # 更新键盘
                      time.sleep(0.1)
              if_stop = True
  ```

  ```python
  # __init__.py
  from .main import *
  ```
## 反馈
https://gitee.com/R_system/launchplex