Zen Studio Live lets you add and test Cronus Zen scripts directly in Chrome. You can start with a script from the built-in library or open an external .gpc file in the Editor.
This guide follows the current browser-based workflow.
What you need
- A Cronus Zen
- A USB data cable connected to the PROG port
- Google Chrome
- Zen Studio Live
- A script from the Scripts Library or an external
.gpcfile
If you still need to update the device or check the rest of the hardware setup, use the Cronus Zen full setup guide.
1. Connect Cronus Zen to Zen Studio Live
- Connect the Cronus Zen to your computer through the PROG USB port.
- Open Zen Studio Live in Chrome.
- Wait for Zen Studio Live to detect the device and load its details and Device Slots.
You do not need to install a desktop application for this workflow. If the device does not appear, check the troubleshooting section below before changing anything else.
2. Choose where the script comes from
Zen Studio Live supports two common starting points:
- Scripts Library: browse scripts available inside Zen Studio Live.
- External GPC file: open a
.gpcfile saved on your computer or available through a direct URL.
The next two sections show both paths.
3. Add a script from Scripts Library
- Open Scripts Library from the Zen Studio Live navigation.
- Search or browse until you find the script you want.
- Choose the action offered by that script:
- Download to editor opens an editable GPC script in the Editor.
- Send to slot adds supported library content to the Device Slots workflow.
- If the script opens in the Editor, use Build to check it and Build & Run to test it.
Not every library item has the same actions. Editable community GPC scripts can open in the Editor. Precompiled content can go straight to Device Slots.
4. Add an external GPC file in Editor
- Open Editor from the Zen Studio Live navigation.
- Use Open to choose a local
.gpcfile. - If you have a direct script URL, use Open from URL instead.
- Select Build to compile the script and check the results panel for errors.
- Select Build & Run to run the compiled script temporarily on the connected Zen.
Build & Run is the safest place to start. It lets you test the script before changing the saved Device Slot layout.
5. Add a Tunez script with Tunez Companion
If your script was created in Tunez, you can skip the GPC download and manual Editor setup.
- Install Tunez Companion from the Chrome Web Store.
- Build and save a script in Tunez.
- Open Zen Studio Live in Chrome and connect the Zen through the PROG port.
- Choose the saved script in Companion and click Send to Zen Studio Live.
- Companion opens or focuses Zen Studio Live, creates or reuses an Editor tab, inserts the generated GPC and starts Build & Run.
The result is the same testing step as the manual Editor path, without downloading the GPC file, opening it and starting Build & Run yourself.
See how Tunez Companion works.
6. Understand Build, Build & Run, and Program
These three actions are not interchangeable:
| Action | What it does | When to use it |
|---|---|---|
| Build | Compiles the GPC and reports errors | Check whether the script is valid |
| Build & Run | Compiles and runs the script temporarily | Test the script and its current settings |
| Program | Writes the current Device Slot layout to the Zen | Keep scripts in the Device Slots you selected |
Use Build & Run before Program whenever you are testing a new or updated script.
7. Save a tested script to a Device Slot
After the script works correctly in Build & Run:
- With Tunez Companion, enable Program after send only when you want to replace the current contents of Slot 1 with this script.
- To keep Slot 1 or use another slot, add the tested script manually through Zen Studio Live Device Slots:
- In the Editor, use Upload to Library to add the script to My Scripts when needed.
- Open Device Slots.
- Open the My Scripts tab and choose Send to slot for the script.
- Place it in the Device Slot you want.
- Select Program to write the current layout to the Cronus Zen.
The slot number is only the position you choose for that script. Use whichever Device Slot fits your own layout.
Replace or remove a script
Open Device Slots to manage the saved layout:
- Send a different script to a slot to replace its current content.
- Use the delete control on a slot to clear it.
- Select Program after the layout looks correct.
Troubleshooting
| Problem | Likely cause | What to do |
|---|---|---|
| Zen Studio Live does not detect the Zen | Wrong USB port or charge-only cable | Connect through the PROG port with a data cable, then reload Zen Studio Live in Chrome |
| Build reports an error | The GPC contains invalid or incompatible code | Read the first compiler error, restore the original file if it was edited, and build again |
| Build succeeds but the script does not run | Build was used instead of Build & Run | Select Build & Run while the Zen is connected |
| Script works during testing but disappears later | It was tested but not added to Device Slots | Add it to the Device Slot you want and select Program |
| Companion cannot send the script | Zen Studio Live is closed, the extension is unavailable, or the device is disconnected | Open Zen Studio Live in Chrome, reconnect the Zen, refresh Companion, and try again |
| Device Slots changed but the Zen still has the old layout | The new layout was not programmed | Review Device Slots and select Program |
For official device and firmware documentation, use the Cronus Zen guide.
FAQ
Do I need to install Zen Studio on my computer?
Not for this workflow. Zen Studio Live runs in Google Chrome. Open the web app, connect the Zen through the PROG USB port and wait for the browser to detect it.
What is the difference between Build, Build & Run, and Program?
Build checks whether the GPC compiles. Build & Run compiles and runs it temporarily for testing. Program writes the current Device Slot layout to the Zen.
Can I open a GPC file from a URL?
Yes. Open the Zen Studio Live Editor and use Open from URL when you have a direct URL to a .gpc file.
How do I keep a Tunez script in a Device Slot?
Companion sends the generated GPC to the Editor and starts Build & Run for testing. When you are ready to keep the script, manage it in Device Slots and use Program in Zen Studio Live.
Why is Zen Studio Live not detecting my Cronus Zen?
Check that the USB cable is connected to the PROG port and supports data. Charge-only cables cannot connect the Zen to the browser. Reconnect the cable, reload the page and try Chrome again.