Skip to content

vigraph/vg-ui-web

Repository files navigation

ViGraph Web UI

This is the Web user interface of the ViGraph system, providing a drag-and-drop circuit diagram metaphor for creating ViGraph applications. It connects to a ViGraph engine which actually runs the application.

ViGraph was created in 2017 by Paul Clark, initially to create interactive laser displays for his company Greenwave Interactive. Tom Nicholls at Paul's other company Packet Ship significantly improved the user interface in 2019/20. Paul published the whole of ViGraph under AGPLv3 in July 2020.

What's it for?

Briefly, ViGraph is a platform for creating complex systems by plugging together simple modules, either graphically, or in a simple text language (VG). It started as a primarily creative platform for audio and laser graphics, but it is expanding its horizons all the time...

It currently has modules for:

  • Audio synthesis
  • Vector graphics, including laser output
  • Bitmap graphics, including LED output
  • MIDI
  • DMX lighting
  • IoT and sensor interfaces
  • Maths and physics simulation
  • Time series data processing and visualisation

You can find out more about ViGraph (with prettier pictures) at vigraph.com

How to run it

This is a React+TypeScript Web app built with Create React App (CRA). To run it, clone this repository and run npm install and npm start in the directory:

    $ git clone git@github.com:vigraph/vg-ui-web.git
    $ cd vg-ui-web
    $ npm install
    $ npm start

You'll need npm installed, of course (sudo apt install npm) but it will take care of the rest!

By default the Web app will connect to http://localhost:33381 which is the default REST interface port provided by the local ViGraph engine server on the same machine. If you want to connect to another server, you can change the URL in src/lib/json/GraphConfig.json.

Contributions

Yes please!

If it's a bug-fix, test or tidy, please just go ahead and send a PR. If it's anything major, please discuss it with me first...

I ask all contributors to sign a standard, FSF-approved Contributor License Agreement to make the project easier to manage. You can sign it when you generate a PR, or in advance here. You only have to do this once for all of ViGraph and ObTools.

Thanks!

About

Web user interface for the ViGraph platform

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages