Skip to content

Latest commit

 

History

History
53 lines (40 loc) · 2.01 KB

README.md

File metadata and controls

53 lines (40 loc) · 2.01 KB

frameV

Framed Visuals: collaborative generative art.

What is frameV?

frameV is a collaborative platform to display artworks that are rendered in the browser. It is open source and anybody can submit their work. The works are randomly selected from a pre-approved list and refreshes currently every 60 seconds.

Why the browser?

The web is open, accessible, and runs everywhere. You want to run this on your old phone as a cool art display in your house? No problem.

What is the approval process?

Submit a PR following the steps below. Maintainers will run your work, make sure it isn't malicious and you'll most likely get your work shown. If there is a problem, we'll let you know via your PR.

Adding a work to frameV

  1. Create your repo
    • Your repo should have an index.html file in the root. An example of a frameV repo can be found here: https://github.com/2xAA/frame-v-squares
    • You can use any method to create animations (SVG, Canvas2D, WebGL etc) but be wary that not everyone's devices will be the same, so performance counts.
    • frameV will make the root of your repo available at framev.vcync.gl/static/ when your work is displayed. However, if you have set the dir key on your work entry, that directory will be available at /static instead.
  2. Fork this repo
  3. Add a work entry in works.json (see the Work entries section below for more info)
  4. Create a PR back to this repo

Work entries

The works.json file contains an array of work entries in the following format:

{
  "author": "2xAA",
  "title": "Squares",
  "repo": "https://github.com/2xAA/frame-v-squares",
  "dir": "dist" // (optional)
}

Dir

The dir key is optional and is used to specify where in your repo your index.html is.

An example of a working repo with the dir key specified in the work entry can be found here: https://github.com/2xAA/framev-unicode-wave

Requirements for running the server

  • node.js >= 12

Running the server

  1. Clone this repo
  2. yarn
  3. node index.js