reveal.js Speaker Notes Server

reveal.js includes a speaker notes plugin which shows your speaker notes and an upcoming slide preview in a new browser window. However in some cases it can be desirable to run notes on a separate device or browser from the one you're presenting with. That's where this Node.js-based speaker notes plugin comes in.

Getting Started

1. Navigate to your reveal.js folder

2. npm install reveal-notes-server

3. Include the following scripts in your presentation HTML file, after Reveal.initialize:

   <script src="socket.io/socket.io.js"></script>
   <script src="node_modules/reveal-notes-server/client.js"></script>

4. node node_modules/reveal-notes-server

5. Open the URL returned from previous command (http://localhost:1947 by default).

QR Code

Using a QR code makes it easier to access the speaker window. To generate a QR code shortcut, append qr=true at the end your URL:http://localhost:1947?qr=true.

Alternatively you can append the following script to the end of your presentation:

<script>
  showQr();
</script>

Cli Options

Here is the list of command line arguments you can use when running the notes server.

hostname: argv.hostname,
port: argv.port || 1947,
revealDir: argv.revealDir || process.cwd(),
presentationDir: argv.presentationDir || '.',
presentationIndex: argv.presentationIndex || '/index.html',
pluginDir: __dirname

Example shell script to start the server on your Wi-Fi IP:

# Replace "wlp3s0" wit your Wi-Fi adapter's name
address=$(ip addr show wlp3s0 | grep 'inet ' | sed -E 's/.*inet (([0-9]{0,3}\.?){4}).*/\1/g')

npx reveal-notes-server \
   --presentationDir=./ \
   --presentationIndex=/my-presentation.html \
   --hostname="$address"