Thanks, will add that to the archive in the next update
It shouldnât be too difficult to install and run the op1repacker, but lets start with the basics: What operating system are you using on your computer?
OS 10.14.4! and thank your for your time Wavi!
Thanks! I donât have Mac OS but Iâll try to write a step by step guide here. Iâll probably improve it and eventually put it in the official documentation for the tool. In any case the essential steps are the same for every OS.
Mac OS step by step instructions for using op1repacker:
Step 1: Get the firmware file that you want to modify
First you need to have a firmware update file, hereâs how to get one.
- Recommended: Get the latest OP-1 firmware update file from TE website: downloads
- Experimental: If you want you can try older firmware files from the archive: GitHub - op1hacks/op1-fw-archive: An archive of (almost) all OP-1 firmware versions
Step 2: Get into the terminal
In this step weâll need to make sure python3 is installed since Python 3 is the programming language that op1repacker is written in. It might already be installed on your system but well check and install it if itâs not.
First weâll need to open the terminal:
-
Mac OS: Open the Terminal App on your system (more info about Terminal here: https://macpaw.com/how-to/use-terminal-on-mac)
-
Next lets see if python3 is installed.
In the terminal type the following command and press enter:
python3 --version
If the output looks something likePython 3.X.X
then you have python3 and can continue to step #3. For example:
Python 3.6.7
If you get an error from the command above (something like command not found: python3
youâll need to install Python 3 yourself. I would recommend checking out one of the following guides:
- How to Install Python 3 on Mac - Saint
- Installing Python 3 on Mac OS X â The Hitchhiker's Guide to Python
Drop a message on the forum or an issue in the op1repacker GitHub repository if you need more info about installing python3 on Mac OS.
Step 3: Install the op1repacker tool
- In the terminal run the following command:
pip3 install op1repacker
- Alternatively try
pip install op1repacker
if that doesnât work. You might also have to addsudo
to the beginning of the command if it says something like permission denied.
- Alternatively try
- You should now have the latest version of the tool.
- To make sure the tool works run the following command:
op1repacker -v
If the installation worked youâll get a version number. For example:
0.2.2
Step 4: Create your custom firmware
- In the terminal, go to the directory where your firmware file is. If the firmware file is in your home directory run the following command:
cd ~
- If the firmware is in some other directory you can navigate to it in the terminal this:
cd /path/to/folder
Now is the fun part, modding the firmware. The commands below use the latest firmware op1_235
as an example. Change the filename If you are using a different firmware version.
-
First unpack the firmware file by running:
op1repacker unpack op1_235.op1
-
Now you can mod the unpacked firmware. The available mods are described here: GitHub - op1hacks/op1repacker: đ Tool for unpacking, modifying and repacking firmware for the OP-1 synth by Teenage Engineering. For example to enable all the available modifications run:
op1repacker modify op1_235 --options iter presets-iter filter subtle-fx gfx-iter-lab gfx-tape-invert gfx-cwo-moose
You of course can leave any of the mods out if you donât want all of them.
-
Now that the mods are done you can get your installable custom firmware file.
Repackage the unpacked firmware with this command:
op1repacker repack op1_235
Now your folder should have the file op1_235-repacked.op1
. Use this file and run the normal OP-1 firmware update with it to get the mods. Enjoy!
Hope that helps, let me know how it goes and if you need more help!
this is amazing!! Iâm learning so much more about navigating my machine thank you!! but unfortunately Iâve run into an issue, maybe you can find an error in my command input?
Codys-MacBook-Pro:~ codygadsby$ pip3 install op1repacker
Requirement already satisfied: op1repacker in /Library/Frameworks/Python.framework/Versions/3.7/lib/python3.7/site-packages (0.2.2)
Requirement already satisfied: svg.path in /Library/Frameworks/Python.framework/Versions/3.7/lib/python3.7/site-packages (from op1repacker) (3.0)
Requirement already satisfied: setuptools in /Library/Frameworks/Python.framework/Versions/3.7/lib/python3.7/site-packages (from svg.path->op1repacker) (40.8.0)
You are using pip version 19.0.3, however version 19.1 is available.
You should consider upgrading via the âpip install --upgrade pipâ command.
Codys-MacBook-Pro:~ codygadsby$ op1repacker -v
0.2.2
Codys-MacBook-Pro:~ codygadsby$ cd ~
Codys-MacBook-Pro:~ codygadsby$ cd /path/to/folder
-bash: cd: /path/to/folder: No such file or directory
Codys-MacBook-Pro:~ codygadsby$ cd ~
Codys-MacBook-Pro:~ codygadsby$ cd
Codys-MacBook-Pro:~ codygadsby$ cdâŚ
-bash: cdâŚ: command not found
Codys-MacBook-Pro:~ codygadsby$ cd âŚ
Codys-MacBook-Pro:Users codygadsby$ cd op1_235.op1
-bash: cd: op1_235.op1: No such file or directory
Codys-MacBook-Pro:Users codygadsby$ cd âŚ
Codys-MacBook-Pro:/ codygadsby$ cd/
-bash: cd/: No such file or directory
Codys-MacBook-Pro:/ codygadsby$ cd /
Codys-MacBook-Pro:/ codygadsby$ op1repacker unpack op1_235.op1
The specified path âop1_235.op1â doesnât exist!
Codys-MacBook-Pro:/ codygadsby$ cd âŚ
Codys-MacBook-Pro:/ codygadsby$ cd âŚ
looks like maybe u need to âcdâ or change directory to the actual folder your .op1 firmware file is
so like if your file is in documents
your command might look like âcd /users/admin/documentsâ
use Finder to figure out the correct path to where you saved your .op1 file
or conversely u could move the .op1 file to the home directory and then cd ~
Ok thank you so much I will keep fidgeting with it
I figured it out!!! Literally thank you guys so much !!!
Awesome! Can I ask which mods you used, if any? And what are your thoughts on them?
I used the ones in the instructions tbh! the Iter mod is a lot of fun, there is going to have to be a lot of experimenting in my part. I did notice the patches do not show up in the initial menu list, but they do show up when holding shift and then selecting the instrument. The filter effect is something I have been desperately trying to get my hands on for transition purposes. I would like to find a way to animate the ITER synth a bit more just for superficial value. also the tape inversion is clearly superior.
This tool is essential to me! Iâve been using it for a while, but recently repacked firmware with:
- tape on top
- filter
- subtle FX
I could do without most of these, but the tape on top makes things so much easier to see. Thanks for such a great tool!
https://drive.google.com/file/d/1tcR2qBm114z-YNgVsIT0p8WxpNYqIOBT/view?usp=drivesdk
A link to a song I made with the new stuff
A link to the rough cut mix
https://drive.google.com/drive/folders/1-8i0A8P_88nPEYXWgVh2PB4rYmfqgO8r
So this isnât working for me. Iter only shows up on Shift+T1. There are no presets. Pressing Shift + preset slot shows the old list of synths with Iter missing - which then wipes it from the slot.
FWIW all the other Mods seem to be working fine. I followed the procedure posted by @wavi several posts up.
Thatâs normal. You wonât have any presets until you save a preset that uses Iter.
Yeah I did that and the synth only shows up if I select with Shift+T1 or loading the snapshot and still no additional presets.
Was under the impression the latest custom firmware was meant to add iter presets given the âpresets-iterâ inclusion.
Yeah It should add the presets with the presets-iter
option. Can you check what version of the tool you have by running:
op1repacker -v
0.1.4 - thatâs my problem isnât it?
How do we get it to update?
I tried using pip install op1repacker and get the following:
Requirement already satisfied: op1repacker in /usr/local/lib/python3.6/site-packages (0.1.4)
Requirement already satisfied: svg.path in /usr/local/lib/python3.6/site-packages (from op1repacker) (3.0)
Requirement already satisfied: setuptools in /usr/local/lib/python3.6/site-packages (from svg.path->op1repacker) (36.5.0)
Yep, presets came in version 0.2.1, you can upgrade with the following command:
sudo pip3 install op1repacker --upgrade
Great - all seems to be working now! Thanks for your help!
@wavi what presets did you use for iter? Did any of mine make the cut? I havenât had a chance to install the update yet.