Negligible Psychological Misery

    generable

    0.1.17 • Public • Published

    GeneraBLE

    Generative art from ambient BLE advertisement packets. A work in progress started on #IoTDay 2017 based on our earlier work with midiot and with Philips Hue.

    For instructions on how to prepare a Raspberry Pi to run GeneraBLE, see our Experience Generative Art tutorial.

    System Overview

    System Overview Graphic

    Web Interface

    The web interface provides dynamic audiovisual scenes that run in-browser. Scenes provide generative, ambient content for HD displays, for example Square Shades:

    SquareShades

    Hue Interface

    GeneraBLE can discover Philips Hue bridges over the local network and drive their connected lights with real-time generative content.

    OSC Interface

    OSC Message Graphic

    MIDI Interface

    The midi package prerequisites must be met before installation.

    Raspberry Pi (and other Linux-based systems)

    ALSA is likely to be the only missing prerequisite, and can be installed as follows:

    sudo apt-get install libasound2-dev
    

    MIDI Message Graphic

    ZynAddSubFX Interface

    If ZynAddSubFX is installed (see our Experience Generative Art tutorial), the zyn interface provides a convenient way to change instruments.

    Installation

    From the command line, browse to the folder which will contain your project and run.

    npm install generable
    

    Hello GeneraBLE!

    In the folder where you installed generable (see above), create a file called generable.js and paste the following contents:

    var generable = require('generable');
    var app = new generable( { httpPort: 3000 } );

    From the command line, in the folder which contains your project, run the following:

    node generable.js
    

    Point your favourite web browser to localhost:3000 and begin configuration.

    Configuration

    The intent of the GeneraBLE project is for all configuration to be completed through human-friendly web interfaces. The web interfaces currently supported include: Reel (BLE), Hue, MIDI and OSC.

    To reset the configuration to default, simply delete the data/generable.db file and restart the program.

    License

    MIT License

    Copyright (c) 2017-2019 reelyActive

    Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

    The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

    Install

    npm i generable

    DownloadsWeekly Downloads

    1

    Version

    0.1.17

    License

    MIT

    Unpacked Size

    891 kB

    Total Files

    41

    Last publish

    Collaborators

    • reelyactive