Skip to content

A native macOS patch manager / librarian for the Empress ZOIA effects pedal

License

Notifications You must be signed in to change notification settings

johnnyturpin-aow/zoia_lib_macOS

Repository files navigation

ZOIA Librarian for macOS

License: GPL v3

app screenshot

This is a native macOS Patch Manager / Librarian for the Empress Effects ZOIA / Euroburo modular effects unit. It is written in Swift/SwiftUI which is currently (and unfortunately) not cross-platform. It is a "spiritual" fork / companion to the cross-platform (python/qt) ZOIA Librarian which can be found here: https://github.com/meanmedianmoge/zoia_lib

There is no code shared between the two projects, though the original was invaluable in helping to figure out the ZOIA patch file format - we do share the common goal of making patch management for the ZOIA as easy as possible.

To learn more about ZOIA and its community, join the Discord chat server, Subreddit, and/or Facebook group.

This project depends heavily on the PatchStorage API, developed by Blokas: https://patchstorage.com/docs/.

This software is distributed under GNU General Public License 3.0. Please familiarize yourself with the Terms & Conditions of copyleft licenses like GPL (and others) here: https://www.gnu.org/licenses/gpl-3.0.en.html. ZOIA and its patch binary format are a trademark of Empress Effects, Inc. and are used with permission.

Neither the developers nor Empress Effects, Inc. are liable for any issues caused or raised by the use or modification of this application. By installing the application you agree to these terms.

A gentle reminder that both this project as well as the companion cross-platform project are currently developed and maintained completely independently from Empress Effects - by developers volunteering their own time.

If you would like to support the developers of this native macOS application, please feel free to leave a tip here Donate.

To contribute to the the developers of the original cross-platform version, please feel free to leave a tip here: Donate.

How to Install

The latest release .dmg installer can be found here: ZoiaLibMac-1.3

Overview Video

Developement Environment

This is a modern SwiftUI macOS native application. As such, it has some unfortunately hefty requirements (imposed by Apple not by the developers).

This application requires Xcode >= 13.3 to build and macOS Monterey to run


Documentation

A user guide with tips & tricks is available here User Guide

Documentation of the ZOIA binary format as well as original testing and design documents for the original project from Empress Effects can be found in the docuements folder of the companion project here: https://github.com/meanmedianmoge/zoia_lib/tree/master/documentation

Contributing

We welcome all contributions! If you want to see something added, either fork or clone the repo to get started. SwiftUI is currently a wild frontier / cutting edge technology from Apple, and as such, has bugs and quirks that require lots of trial and error. You have been warned. It is fun though.

Authors

  • Johnny Turpin

About

A native macOS patch manager / librarian for the Empress ZOIA effects pedal

Resources

License

Stars

Watchers

Forks

Packages

No packages published