Skip to content

A web-based template for hosting systems for real-time music HCI.

Notifications You must be signed in to change notification settings

yongyizang/Euterpe

Repository files navigation

Euterpe

Hero Image

Euterpe is a framework designed to bridge the gap between music interaction and creation research and its deployment into user-friendly systems accessible to the general public on the web. Euterpe aims to be a template or starting point, from which you can develop your own music interaction system.

Deployed Systems Using Euterpe

Tip

Euterpe is currently using web features that are available only on Chrome based browsers. We also suggest you to access the demos in incognito mode.


Installation

Node.js

If you don't have node.js installed, we recommend using the Node environment manager NVM. If you already have node.js installed but it is older than v16, we suggest you install a newer one.

In your terminal, you can check if you have Node.js or NVM installed by running

# For NVM
nvm -v
# For Node
node -v

Based on that, you can follow one of the options below

  • Install Node.js using NVM
    1. Installing NVM Instructions for MacOS, Linux and Windows
    2. Installing Node
      nvm install v21.1.0
      nvm use 21.1.0
      # verify that Node.js is correctly installed:
      node -v
  • Install Node.js without NVM
    1. Choose the correct pre-build installers for your platform
    2. Or use some other package manager that your platform provides (i.e Homebrew for macOS)

Euterpe

Now that you have Node.js set up, you can proceed to install Euterpe by following these steps:

  • Getting the source code

    git clone https://github.com/xribene/Euterpe.git
  • Installing dependencies

    # Navigate to the Euterpe folder
    cd Euterpe
    # Install the package manager pnpm
    npm install -g pnpm
    # Use pnpm to install all dependencies
    pnpm install

Run Euterpe examples

To confirm everything was installed correctly run the following command from the Euterpe directory:

pnpm run dev

If successful, this command will start a local development server on port 5173. Visit http://localhost:5173 and try the deployed web-app.


Deployment

When you are ready to deploy Euterpe, you can run the following command in the root directory of the project:

pnpm run build

This will by default generate a dist folder in the root directory of the project. You can then deploy the contents of the dist folder to your web server.


Made with

About

A web-based template for hosting systems for real-time music HCI.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published