/hydra-plus

a visual editing environment for hydra-synth

Primary LanguageVueMIT LicenseMIT

hydra+

GitHub package.json version Deploy to Firebase Hosting

hydra+ is a double-screen visual editing environment for hydra synth, designed for ease of use and to project live visuals without revealing any code.

👉 Live demo available here

If you have any questions, suggestions, or just want to report a bug, please use the Issues / Discussions tabs on Github.

Usable key combos:

  • update: Enter - works only when focused in a text input
  • undo: Ctrl/Cmd + Z
  • redo: Ctrl/Cmd + Y or Ctrl/Cmd + Shift + Z
  • toggle UI: Escape
  • visualizer mapping: https://github.com/glowbox/maptasticjs

Known issues:

  • initScreen doesn't work properly in visualizer
  • initScreen doesn't initialize working after refreshing the page
  • initScreen blocks window in add effect modal previews
  • Maptastic mapping is lost when screen size changes

Planned features:

  • UI for arrays
  • transition on updates
  • audio settings modal
  • BPM tapper
  • support for 3D scenes
  • MIDI integration
  • DMX integration
  • Philips Hue integration - work in progress
  • built-in extra shaders + option to add new ones from the GUI
  • [1.0] import / export configs
  • [1.0] customizable colors for GUI
  • [1.0] backend - ability to save files and configs

Installation & Usage

Prerequisites

Installation

  1. Clone the repository: git clone git@github.com:dahegyi/hydra-plus.git
  2. Install dependencies: npm install
  3. Run the development server: npm run dev

Usage

  • npm run dev - Runs the development server
  • npm run build - Builds the production version
  • npm run preview - Serves the production version locally
  • npm run prepare - Installs the Git hooks (runs automatically on npm install)
  • npm run lint - Runs ESLint and Stylelint
  • npm run lint:fix - Runs ESLint and Stylelint and fixes the errors

Deployment

The application is deployed automatically to Firebase Hosting on every push to the main branch.

Deployment without Github Actions:

  1. Build the production version: npm run build
  2. Deploy the dist folder to Firebase Hosting: firebase deploy

License

This project is licensed under the MIT License - see the LICENSE file for details.

Thankful for...