You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Ophir LOJKINE c34ccbb17a Update dependencies 5 years ago
client-data Fix unreadable board name 5 years ago
other-data CSS for the line tool 10 years ago
server Update dependencies 5 years ago
server-data Ignore server-data files on git 5 years ago
.gitignore Remove .DS_Store 5 years ago
.openodeignore add .openodeignore 6 years ago
.travis.yml Fix deploy and improve travis file 6 years ago
AUTHORS Initial commit 12 years ago
Dockerfile Update dependencies 5 years ago
LICENSE Switch the project's license from GPLv3 to AGPLv3 7 years ago
README.md Make the server installation instructions clearer 5 years ago
docker-compose.yml Fix docker compose 6 years ago
package-lock.json Update dependencies 5 years ago
package.json Update dependencies 5 years ago

README.md

WBO

WBO is an online collaborative whiteboard that allows many users to draw simultaneously on a large virtual board. The board is updated in real time for all connected users, and its state is always persisted. It can be used for many different purposes, including art, entertainment, design, teaching.

A demonstration server is available at wbo.ophir.dev

Screenshots

The anonymous board

WBO anonymous board

Used for teaching

image

Used for collaborative diagram editing

Used for drawing art

WBO angel

Running your own instance of WBO

If you have your own web server, and want to run a private instance of WBO on it, you can. It should be very easy to get it running on your own server.

Running the code in a container (safer)

If you use the docker containerization service, you can easily run WBO as a container. An official docker image for WBO is hosted on dockerhub as lovasoa/wbo.

You can run it with the following command :

docker run -it --publish 5001:80 --volume $(pwd)/wbo-boards:/opt/app/server-data lovasoa/wbo:latest

This will run WBO :

  • on port 5001
  • persisting the user data in $(pwd)/wbo-boards

You can then access WBO at http://localhost:5001.

Running the code without a container

Alternatively, you can run the code with node.js directly, without docker.

First, download the sources:

git clone git@github.com:lovasoa/whitebophir.git
cd whitebophir

Then install node.js if you don’t have it already, then install WBO’s dependencies:

npm install

Finally, you can start the server:

PORT=5001 npm start

This will run WBO directly on your machine, on port 5001, without any isolation from the other services.

Troubleshooting

If you experience an issue or want to propose a new feature in WBO, please open a github issue.

Demonstration server hosted by openode