nilskr/jd08patchmanager

Python GUI program to copy selective patches from one Roland JD-08 .svd file to another

JD08PatchManager

Python GUI program to copy selective patches from one Roland JD-08/JX-08 .svd file to another.

INTRODUCTION

With the JD-08/JX-08 synthesizers, Roland has decided not to allow saving of separate patches, nor to implement SysEx dump functionality to achieve the same. This means that it is virtually impossible to share newly created patches with others.

At the time of writing (October 2023), the only way to make a backup of one's own patches is an elaborate procedure described in e.g.

https://www.sweetwater.com/sweetcare/articles/roland-jd-08-factory-reset/

The problem with this procedure, besides it being tedious, is that all patches are grouped in one binary .svd file. So it is hard to merge/sort patch edits made by oneself or others at various times.

That's where this tool comes in. One can open two .svd files and copy patches from one to the other.

Usage

IMPORTANT: while the tool can be used to manage .svd files of both JD-08 and JX-08 models, currently it has no knowledge of the internal structure of the patches, nor does it check for which synth the file is meant. So in theory it is possible to copy JD-08 patches into a JX-08 backup file and vice versa. This is probably a recipe for disaster, so DON'T do it!

Patches are copied from one list/file to the other by selecting the position where the patch should be copied to (in the target list), selecting the patch to be copied (in the source list), and then clicking the appropriate button to copy the patch left to right or vice versa.

After the patch has been copied, the selection on the target list will automatically move to the next item for your convenience. At the end of the list, it will wrap around to the first item.

Patches can be renamed by clicking the button of pressing F2 while the patch list has the focus.

Double-clicking an item in the source list also copies the patch, just like using the space bar (while focus is on the source list and a slot is selected in the destination list).

Edits will be in memory only unless Save is clicked explicitly.

CTRL-click on Save provides "Save as" functionality.

While the file hasn't been saved, one can revert the selected patch or all patches to the state in which the .svd file was loaded. No other undo functionality is provided, so make sure you want to save the file as edited.

One or two .svd file names can be passed on the command line so they get opened at startup.

From version 1.1 on, a patch (diff) viewer is available by typing 'd' after selecting a patch to view. The window can be kept open - consequent typing of 'd' will re-use the window. It is possible to filter the displayed data using the checkboxes at the top.

NOTE: the correctness of displayed information remains to be verified. Also keep in mind that at present the software doesn't check if one or both selected .svd files happen to be JX-08 files. If so, the displayed patch data is very likely to be inaccurate/misleading.

INSTALLATION

Disclaimer: I'm developing on Windows, so Mac/Linux users, forgive me (and report!) if any OS specific issues are encountered.

This application was developed on Python 3, so I'm not sure if if will work on older versions. The libraries sys, os, and tkinter should come bundled with the Python install, so a requirements.txt file is currently not present.

Windows

If you are running Windows and you don't have Python installed, you may use the binary release attached to the GitHub project page.

Linux

On Linux (tested on Mint 21.1 Cinnamon) the commands to run the application are:

sudo apt install git-core python3-tk
git clone https://github.com/NilsKr/JD08PatchManager.git
cd JD08PatchManager/
python3 patchmanager.py

MacOS

To be described. Procedure will be similar to the Linux one.

CONTRIBUTIONS

Drop me a line if you want to contribute code or if you want to report a but or you have ideas for useful features.

CONTACT

You can reach me at: nkronert at hotmail dot com

LICENSE

Copyright (C) 2023 Nils Kronert

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.

https://github.com/NilsKr/JD08PatchManager

The patch (diff) viewer introduced in version 1.1 uses information from JD-08.hpp as present in: JDTools - Patch conversion utility for Roland JD-800 / JD-990 2022 by Johannes Schultz License: BSD 3-clause https://github.com/sagamusix/JDTools See JD-08.patchdef

As the licensing information mentions, this software comes WITHOUT ANY WARRANTY. In the unlikely case where the Roland JD-08 or JX-08 considers a file edited by this software to be corrupt and bricks itself, I cannot be held responsible.

On that positive note, have fun! Cheers, Nils

jd08patchmanager's Issues

Navigating with arrow keys does not use selection for copy

If you navigate the left window up and down with the arrow key, the grey box moves with the keys, but if you click ">>" it will only copy what has been selected with a mouse click.

Error on Debian 11

I tried to load a backup on Debian 11.8 and got this error:

~/git-repos/JD08PatchManager$ python patchmanager.py 
Value not found for defaultdir. Returning default .
Configuration written
File size of /home/lentferj/Dokumente/Roland JD-08/JD08Backup_Factory.svd in Bytes is 2000908
Exception in Tkinter callback
Traceback (most recent call last):
  File "/usr/lib/python3.9/tkinter/__init__.py", line 1892, in __call__
    return self.func(*args)
  File "/home/lentferj/git-repos/JD08PatchManager/patchmanager.py", line 216, in onBrowse
    self.tryFile(fileName)
  File "/home/lentferj/git-repos/JD08PatchManager/patchmanager.py", line 187, in tryFile
    self.populateList()
  File "/home/lentferj/git-repos/JD08PatchManager/patchmanager.py", line 435, in populateList
    self.patchList.insert('end', self.getPatchNumber(i) + " " + self.getPatchName(data, i))
  File "/home/lentferj/git-repos/JD08PatchManager/patchmanager.py", line 411, in getPatchName
    offs = self.getPatchOffset(data, index)
  File "/home/lentferj/git-repos/JD08PatchManager/patchmanager.py", line 360, in getPatchOffset
    return self.getPatchSectionOffset(data) + 16 + index * 0x800 # 16 is the size of the patch section metadata
  File "/home/lentferj/git-repos/JD08PatchManager/patchmanager.py", line 352, in getPatchSectionOffset
    offs = struct.unpack("l", section[8:12])[0]
struct.error: unpack requires a buffer of 8 bytes

$ python --version
Python 3.9.2

$ dpkg -l | grep python3-tk
ii  python3-tk:amd64                                            3.9.2-1                          amd64        Tkinter - Writing Tk applications with Python 3.x

Feature request: add short cut keys for ">>" and "<<" actions

When working on consolidating larger collections it would be nice if you could use keys on the computer keyboard for moving patches from left to right and vice versa.

Thanks for considering!