Reminder: You need to have Java installed on your computer to be able to run the Librarian. If you have the 32-bit version of Java you will only be able to run the 32-bit Librarian even if your OS is 64-bit. If you have a 64-bit Windows Operating System, please check this page for information on which version of Java you should download if you don’t already have it.
Librarian Version 4.01 is an update that fixes a bug in the previous Version 4.00.
The bug prevented the Librarian from correctly interpreting the ‘Heads’ data sent by the Blue Nebula for emulations with numbers between 5 and 15 that use the ‘coded’ ‘A’, ‘B’, ‘C’, ‘E’ and ‘F’ values. It caused the wrong head letter to be received by the Librarian and all head settings became ‘A’ instead of the correct letter value from the Blue Nebula patch. This incorrect value would have been saved in any patch files saved with the Save Patches button in the Librarian. If this patch data was subsequently sent back to the Blue Nebula using the Send All Patches button it will have corrupted the heads value in the Blue Nebula’s patches. You should check and correct the Heads settings in any affected patches and resend them to the Blue Nebula.
The Blue Nebula Firmware 3.02 does not require a fix for this bug, only the Librarian.
The updated software can be downloaded from the Latest Updates Here link above.
Make sure you download the correct version depending on your Windows Operating System: 32-bit or 64-bit. The 32-bit Librarian will work on 64-bit Windows systems but the 64-bit version of Librarian will not work on a 32-bit Windows OS.
The update for Mac OSX will be available as soon as possible.
Hi friends and followers. I know you’ve all been waiting patiently for Part 3 of the ‘Unexpected Journey’ but I’ve been away for a break in beautiful Alcudia in Majorca to recharge my personal batteries.
Part 3 is coming shortly but in the meantime I finally got my hands on a Mac thanks to my good friend David Jamieson and have been able to get the Librarian working on OSX El Capitan Version 10.11.4. It should work with OSX 10.9 or above.
If you don’t already have it installed, you will need to install the Java Runtime Environment (JRE), Version 8 or above. To install this go to the Oracle website here and choose the Mac OS X version. I chose the .dmg one and the latest version “Java SE Runtime Environment 8u92” and it installed without any problems.
You will need to download and install the CH340 driver as this is required to be able to connect via USB to the Blue Nebula and I found that the version on this website worked fine. Once you have downloaded the driver zip file double-click on “CH34x_Install.pkg” to install the driver. You may find that your Mac won’t allow the installer to run as ‘Gatekeeper’ requires apps to be signed so if your Mac won’t install it then do the following:
Go to System Preferences > Security & Privacy > General and click on the padlock at the bottom of the dialog box to enable changes. Under Allow apps downloaded from choose the “Anywhere” option. Close the dialog and the CH340 driver should now install when you double-click the “CH34x_Install.pkg” file. Important: Restart your Mac to activate the new driver.
Run the BN Librarian app by double-clicking it and, if you have a Blue Nebula connected to a USB port on your Mac, when you click on the Serial Port dropdown you should see an entry similar to what I’ve shown in the screenshot above: /dev/cu.wchusbserial* where * will be a number (1440 in the illustration) but this may differ on your computer.
That’s the serial port where your Blue Nebula is connected so click on it to get the Mac and Blue Nebula to start talking to each other. The Blue Nebula resets as usual and after a few seconds it will be ready to communicate with the Librarian running on the Mac.
The Mac OS X and Windows versions of the Blue Nebula Librarian can be downloaded from ‘Latest Updates Here’ on the menu bar above.
Thanks to Rolf and Steve for testing Librarian on Windows XP and Windows 7. We discovered a problem in that if there was only a single enabled COM port on the user’s computer the Librarian failed to connect to the attached EchoTapper. This has been resolved in the latest Version 2.50 of the Librarian and we can confirm that it works on Win XP and Win 7.
Click here to download the Windows (32 bit) Librarian version 2.50. The package should be unzipped to any convenient location on your computer where you will then find a folder called application.windows32. Open this and double click the .exe file to run the Librarian.
- If the Librarian only detects a single active COM port when it starts it will attempt to connect to it. If this is your Arduino then it will reset the Arduino and contact will be established. You can hit the EchoTapper’s Down button (or turn the encoder CCW) during the Welcome message or just wait and hit the Librarian’s Get Patches button to transfer patches from the Arduino to the Librarian.
- Of course it’s possible that you haven’t connected your Arduino yet so there may be a COM port but not the Arduino’s port. In this case the attempted connection will obviously fail. To update the list of COM ports hit the new orange Re-scan button (see screenshot) and you should now see a new port in the list which will be the one that your Arduino is attached to. Now select it from the drop down list and the connection will be established between the Librarian and the Arduino. As in 1, you can hit the EchoTapper’s Down button (or turn the encoder CCW) during the Welcome message or just wait and hit the Librarian’s Get Patches button. Please ensure you do not click the Re-scan button while your Arduino is still starting up after plugging it in as this may cause problems. Wait until the Welcome message has disappeared and the Arduino is then ready to rock and roll 😀
- If the Arduino is connected when you start the Librarian and you have more than one COM port, the Librarian will not attempt to make contact as it won’t know which COM port it should use. In this case you must select the correct COM port yourself from the Drop down list and this will initiate contact with the EchoTapper and you can then proceed as before.
Please use the Latest Updates Here link in the banner above, rather than the out of date links below.
Update 24th October 2013: Some bug fixes and extra features added. The links below now point to the latest Version (2.3) of the Editor/Librarian. The EchoTapper Version 3.20 Arduino code has not been changed so there’s no need to update your eTap2HW hardware. I’m looking for anyone using my Automation software with their eTap2HW-based echo units to try out this preliminary release of a software application which I am calling the EchoTapper Patch Editor/Librarian. I have written it in response to a number of requests from users of my automation code to enable them to back-up and re-arrange their User Patches, for example to create personal set lists. Although not yet having all the planned features included, the current version allows patches to be transferred to and from the eTap2HW via the USB connector on the Arduino Uno, and it also allows them to be saved to and loaded from disc. In it’s Editor role the software allows patches to be renamed and fully edited, for example, by changing the echo model and adjusting the echo parameters. It simulates the three main knobs on the ‘real’ eTap2HW control panel. In order to use the Librarian with your eTap2HW you will need to upgrade the EchoTapper automation software to version 3.20 or later. The Librarian requires you to have Java installed on your computer and versions of the Librarian are available for Windows 32, MacOS X and Linux. As I don’t have access to MacOS X or Linux, these versions have not been tested yet and the Windows version has only been tested on Windows XP Professional. I would appreciate feedback on the software running on any of these operating systems so if you are able to help please download the relevant version and leave your feedback in a comment, remembering to state what OS you are using and details of your experiences and suggestions for improvements, if any. Thanks and enjoy 🙂 Philip Librarian User Guide Automation Software Version 3.20 (There seems to be a problem with the old upload tool I previously recommended so please try XLoader which is available here and is very simple to use.) Librarian Windows Version Librarian Mac OS X Version (NB Please read the readme file for important information to enable it to run on the Mac) Librarian Linux 32 Version Librarian Linux 64 Version