Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/fheyen/musicvis-lib

Library for web-based music visualization
https://github.com/fheyen/musicvis-lib

javascript library midi music music-analysis music-library music-visualization musicvis-lib visual-analytics visualization

Last synced: 2 months ago
JSON representation

Library for web-based music visualization

Host: GitHub
URL: https://github.com/fheyen/musicvis-lib
Owner: fheyen
License: other
Created: 2020-12-01T16:15:01.000Z (about 4 years ago)
Default Branch: main
Last Pushed: 2024-01-01T14:09:41.000Z (12 months ago)
Last Synced: 2024-10-26T16:57:20.319Z (2 months ago)
Topics: javascript, library, midi, music, music-analysis, music-library, music-visualization, musicvis-lib, visual-analytics, visualization
Language: JavaScript
Homepage: https://fheyen.github.io/musicvis-lib/
Size: 20 MB
Stars: 14
Watchers: 4
Forks: 1
Open Issues: 6
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt

Awesome Lists containing this project

README

        # musicvis-lib ♫

[![alpha version](https://img.shields.io/badge/-alpha%20version-orange)](https://github.com/fheyen/musicvis-lib)

 

[![npm](https://img.shields.io/npm/v/musicvis-lib)](https://www.npmjs.com/package/musicvis-lib)

 

[![GitHub package.json version](https://img.shields.io/github/package-json/v/fheyen/musicvis-lib?label=GitHub)](https://github.com/fheyen/musicvis-lib)

[![GitHub issues](https://img.shields.io/github/issues-raw/fheyen/musicvis-lib)](https://github.com/fheyen/musicvis-lib/issues)

[![Contributors](https://img.shields.io/github/contributors/fheyen/musicvis-lib?color=%234dc71f)](https://github.com/fheyen/musicvis-lib/graphs/contributors)

[![JavaScript Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://standardjs.com)

Goal: Provide data structures and algorithms for music analysis and visualization in JavaScript.

This library is still in early and active development.

**Breaking changes might happen.**

1. [musicvis-lib ♫](#musicvis-lib-)

   1. [Setup](#setup)

   2. [Documentation](#documentation)

   3. [How to use](#how-to-use)

   4. [Examples](#examples)

   5. [Contributing](#contributing)

   6. [Credits](#credits)

## Setup

`npm install --save musicvis-lib`

Or download [dist/musicvislib.js](https://raw.githubusercontent.com/fheyen/musicvis-lib/main/dist/musicvislib.js) (development) or [dist/musicvislib.min.js](https://raw.githubusercontent.com/fheyen/musicvis-lib/main/dist/musicvislib.min.js) (minified).

## Documentation

See [Observable](https://observablehq.com/collection/@fheyen/musicvis-lib) for examples.

See [api.md](./api.md) and [here](https://fheyen.github.io/musicvis-lib/) for the full documentation.

## How to use

With modules

```javascript

import {Note} from 'musicvis-lib'

const note = Note.from({

  pitch: 65,

  start: 2.0,

  end: 3.0,

  velocity: 127,

  channel: 0

})

```

With require

```javascript

const musicvislib = require('musicvis-lib')

const {Note} = musicvislib

const note = Note.from({

  pitch: 65,

  start: 2.0,

  end: 3.0,

  velocity: 127,

  channel: 0

})

```

In HTML

```html

  console.log(musicvislib)

  console.log(musicvislib.Midi)

  console.log(musicvislib.Midi.getMidiNoteByNr(0))

```

## Examples

Here are some examples that show for what `musicvis-lib` can be used:

- [fheyen.github.io/midi-live-vis](https://fheyen.github.io/midi-live-vis/) ([code](https://github.com/fheyen/midi-live-vis))

- [fheyen.github.io/midi-pianoroll](https://fheyen.github.io/midi-pianoroll/) ([code](https://github.com/fheyen/midi-pianoroll))

- [fheyen.github.io/webmidi-logger](https://fheyen.github.io/webmidi-logger/) ([code](https://github.com/fheyen/webmidi-logger))

- [fheyen.github.io/midi-chords](https://fheyen.github.io/midi-chords/) ([code](https://github.com/fheyen/midi-chords))

- [fheyen.github.io/midi-recorder](https://fheyen.github.io/midi-recorder/) ([code](https://github.com/fheyen/midi-recorder))

- [fheyen.github.io/kalimba](https://fheyen.github.io/kalimba/) ([code](https://github.com/fheyen/kalimba))

[More dependents](https://github.com/fheyen/musicvis-lib/network/dependents)

## Contributing

If you like to contribute, feel free to create pull requests or [issues](https://github.com/fheyen/musicvis-lib/issues).

See [CONTRIBUTING.md](./CONTRIBUTING.md) for more.

## Credits

See [CREDITS.md](./CREDITS.md).