selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

tableaunoir logo

Self-host tableaunoir

v0.1

Collaborative blackboard with magnets for teaching

AlphaOpen SourceGPL-3.0
Updated5 years ago
LanguageTypescript
Setup difficultyModerate
Stars
212
Port
8080 (websocket server for real-time collaboration)
Requires
Node.js, Npm, Small-uuid library, Ws library
Install with Node.js
Course using colors and drawing toolsBreadth-first search algorithm animation with magnetsToolbar, magnets, and text on tabletMagnets illustrating sorting algorithmsMagnets illustrating graph algorithmsMagnets illustrating B-tree algorithmsLarge graph algorithms with Sim City icons

What is tableaunoir?

Tableaunoir is an online collaborative blackboard tool designed for teaching. It features fridge magnets — movable images, text, and numbers — for creating interactive animations to illustrate algorithms, graphs, and other concepts. Users can draw and erase with a graphics tablet or mouse, collaborate in real-time on shared boards (requiring a Node.js websocket server), and export boards to PNG or PDF. It supports LaTeX via MathJax, Markdown, code highlighting, multiple backgrounds (blackboard, whiteboard, music staff, grid, PDF documents), slide/animation recording, interactive graphs where vertices are magnets, and left-handed mode. The app runs in any browser, can be used offline via Electron or by opening index.html directly, and requires no user accounts. The front-end is served by nginx or Apache, while the optional websocket server runs on Node.js (default port 8080).

Should you self-host tableaunoir?

tableaunoir scores 43/100 on selfhost.directory (how scoring works) and ranks #7 of 9 in Whiteboarding. It has 212 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is moderate: expect some configuration beyond a single command. It is GPL-3.0-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is excalidraw (91/100, 134 733 stars). It scores higher overall, so compare the two before you pick. See tableaunoir vs excalidraw side by side.

Features

  • Code Highlighting
  • Collaborative Editing
  • Custom magnet creation
  • Drawing and erasing
  • Export to PNG/PDF
  • Fridge magnets for animations
  • Interactive Graphs
  • LaTeX/MathJax support
  • Left-handed mode
  • Markdown Support
  • Multi-panel board division
  • Multiple backgrounds
  • No Account Required
  • Offline Mode
  • Slide/animation recording

tableaunoir README

How to install tableaunoir

Install tableaunoir with Node.js

Node.js and npm
$ apt update
$ apt install nodejs npm
$ npm install ws small-uuid
node main.js

Run from the server/ folder; listens on 0.0.0.0:8080 by default

How to configure tableaunoir

  • PORT8080Port for the websocket server (default 8080)

    Port for the websocket server (default 8080)

  • SERVERADRESSWebSocket server address for the front-end to connect to (e.g., wss://your-domain.com/tableaunoir/ws)

    WebSocket server address for the front-end to connect to (e.g., wss://your-domain.com/tableaunoir/ws)

  • src/config.jsonConfiguration file for the front-end with wss URL for the websocket server

    Configuration file for the front-end with wss URL for the websocket server

tableaunoir releases & version history

FAQ

How to see the full board if it exceeds screen size?

Click the fit-to-screen icon in the toolbar.

How to draw over a magnet?

Move the magnet to the background (hover and press b), draw, then press b again to bring it to foreground.

How to draw interactive graphs?

Draw edges between magnets; vertices are magnets and edges/labels update when magnets move. Hold Shift if needed.

How to draw squares, circles, horizontal/vertical lines?

Open the tool menu (press t), choose the shape, and hold Shift while drawing for regular shapes.

How to write LaTeX formulas?

Create a text magnet with Enter, type LaTeX between $...$ or \[...\], then press Esc.

How to duplicate a magnet?

Hold Ctrl and drag the magnet to create a copy.

How to create a magnet?

Draw a contour around the content you want to turn into a magnet, then press Ctrl+X.

How to completely clear the board?

Use the eraser tool and do Ctrl + click to clear everything.

More in Whiteboarding

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…