Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/google/chicago-brick
Software that displays content on a multi-node video wall.
https://github.com/google/chicago-brick
chrome graphics nodejs video-wall visualization
Last synced: 3 days ago
JSON representation
Software that displays content on a multi-node video wall.
- Host: GitHub
- URL: https://github.com/google/chicago-brick
- Owner: google
- License: apache-2.0
- Created: 2016-01-22T06:32:09.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2024-10-12T05:58:12.000Z (about 1 month ago)
- Last Synced: 2024-11-03T23:18:51.228Z (10 days ago)
- Topics: chrome, graphics, nodejs, video-wall, visualization
- Language: TypeScript
- Homepage:
- Size: 14.7 MB
- Stars: 153
- Watchers: 18
- Forks: 34
- Open Issues: 27
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING
- License: LICENSE
- Authors: AUTHORS
Awesome Lists containing this project
- awesome-edinburgh-audio-vision - Chicago-Brick
README
# Chicago Brick: the Google Chicago Video Wall Software
## Quick Start
To use this software, first download and install [deno](http://deno.land).
Next, clone the repo to your machine:
```bash
$ git clone https://github.com/google/chicago-brick.git
```
Then, to run the server in 1x1 mode with the gears module:
```
chicago-brick$ ./bin/run_1x1.sh -m gears
```
This should open a Chrome window to http://localhost:3000/?config=0,0,1920,1080.
You should be able to see some gears rotating. If you don't see that, try
running the `npm install` command again.
Or, to run the server in 2x2 mode with the gears module:
```
chicago-brick$ ./bin/run_2x2.sh -m gears
```
And open the client windows like so:
```
chicago-brick$ ./bin/start_2x2_clients.sh
```
You should be able to see the same thing with four browser windows instead.
You can play with different modules by substituting the `gears` argument with
other names from `chicago-brick/config/demo-playlist.json` or from the various
`brick.json` files within the `demo_modules` folder.
## Geometry
The wall server needs to know the shape of the screens that make up the wall. At
the moment, this shape must be a single polygon, though it can be concave. By
default, the wall assumes that it's going to display on a 1920x1080 screen. To
change this, you can use the `--use_geometry` flag to specify the shape in a
turtle-like langauge. You can also specify the points in a JSON-formatted file
and use the `--geometry_file` flag to pass the path to the file.
## Modules
A chicago brick module is responsible for showing control across the wall.
Modules are stored in a directory and contain a `brick.json` file with metadata
about the module. The directory also contains the client and server parts to the
module, which are executed on the clients or server respectively. These parts
can be written in TypeScript or JavaScript, though TypeScript is strongly
preferred. See examples in demo_modules.
The server learns about modules that can be shown via the `--module_dir` flag,
which is scanned for any `brick.json` files. Playlists are only allowed to
reference modules that the wall knows about.
## Playlist
A playlist defines the order in which the wall should play modules. The playlist
consists of layouts, each of which refers to either a specific list of modules
or a pre-defined collection of modules. The layout will randomly select among
its set of modules and play each for the specified module duration. After the
layout duration expires, the next layout is shown. For example:
```json
{
"playlist": [
{
"modules": ["gears", "slither"],
"duration": 600,
"moduleDuration": 60
},
{
"modules": ["matrix"],
"duration": 600,
"moduleDuration": 600
}
]
}
```
## Contributing
We welcome contributions of new modules and of improvements to the wall software
itself! See the CONTRIBUTING file for some stuff you need to complete before you
contribute.
Hopefully, this gets you developing!
– Chicago Brick Team