Skip to content

Home

Jump to bottom
tschartz edited this page Nov 3, 2023 · 5 revisions

pyrp360 Welcome to the pyrp360 wiki!

Introduction

PyRP360 is a Linux bank manager for the DigiTech RP360 & RP360XP pedalboard. It currently supports :

  • factory banks loading from device
  • user banks loading from device
  • saving user banks to device
  • importing preset from file (.rp360p files)
  • exporting preset to file

Tested on Ubuntu & Arch Linux

Requirements

Dependencies

To run PyRP360 you'll need

  • Python 3
  • PyGOBject (pip install PyGObject)
  • PySerial (pip install pyserial)

Groups

Ubuntu

You also need to be a member of the dialout group (sudo usermod -a -G dialout your_user)

Arch Linux

Replace group 'dialout' by 'uucp'.

Permission

The right permissions need to be set on /dev/ttyACM* in order to access the device.

Launching

To launch PyRP360, change to PyRP360 directory and run this command : python3 pyrp360.py

How it works

PyRP360 communicates with the device by sending specific commands using serial port through USB. see https://github.com/tschartz/pyrp360/blob/master/commands.py Device usually responds with a json-like message depending on the context of the query command.

System commands are mandatory to get the device in a 'ready-to-listen' state. They are automatically executed when you press the Connect button. Once device is ready, query commands on presets or FX can be achieved, like retrieving a preset with its FX and values, or writing back to device preset or FX values. As we are on serial and a request/response scheme, you have to process each response before emitting another command otherwise the device could become unresponsive or left in an unknown state.

RP360 has a 99 presets factory bank and another 99 presets user bank. Both of them are loaded when you press the Connect button. Once loaded, the current active preset on the device is loaded on screen.

UI

UI is built from a Glade file (pyrp360.glade) and the current active preset is loaded from the device. Each preset FX is then built dynamically on basis of the presets file (presets.json) containing a description of each FX present on the device with their corresponding unit, min and max values. A test file (test1.rp360p) can be used to import preset from file.

Clone this wiki locally