Presenting Without Sharing My Screen

Mon, 25 May 2020

The Problem

I’ve been social distancing for a while now and I’m working from home full time. I live in an old building with unreliable internet but, using a LAN cable, I get by most of the time. I disable my video and avoid sharing my screen wherever possible. However what happens when I need to present something to my team? Well, then my colleagues get a pixelated presentation and the occasional drop from their host.

The UX designer in me thinks this is less than ideal. I spend considerable time putting presentations together and they deserve a proper delivery. I started to wonder if there was a better way to deliver slide decks — one that didn’t involve sharing my screen.

The Current Work Flow

Powerpoint and me are not friends. My slide decks are normally minimalist. They feature a title, an image, some code or an emoji per slide and thats about it. Almost always these elements are centered in the middle of the slide and when working in powerpoint, I would find myself spending most of my time scaling images to fit the slide.

Whilst building out my personal website last year in gatsby, I came across gatsby-theme-mdx-deck. As its name suggests, this theme takes MDX and turns it into slide decks — it was the powerpoint alternative I was looking for.

An Example Using “gatsby-theme-mdx-deck”

The first step is to add gatsby-theme-mdx-deck to your gatsby config:

1
2
3
4
5
6
7
{  
  resolve: `gatsby-theme-mdx-deck`,  
  options: {  
    contentPath: `MDX/Decks`,  
    basePath: `/decks`,  
  },  
}

The plugin expects a location where your MDX files are located and a basepath on where your decks should be found on your site.

In the folder I specified as the content path, I create a new .mdx file and add the following:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
---  
title: "Portfolio 101"  
desc: How I built this site and how you can design, build and host your own.  
date: 2020-05-10  
location: Space | Earth  
---  
# Portfolio 101  
How I built this site and how you can design, build and host your own.  
---  
This is all...  
# IMO  
---  
Your site is your space on the net.  
(Do what you want with it.)

You’ll see at the top of the file I have frontmatter that acts much like meta data, I query this data to show you information about the presentation you are about to open. The theme reads in three dashes in a row as a signal to split the document and create a new slide. The above code outputs the following three slides when run:

1

That was easy!

I can then navigate to /decks and surf through these slides using my arrow keys.

Another cool part to this is that your slides are hosted on a website. You can give anyone the URL and they can recap your slides at a later date. This method is how I built version one of my presentations page.

My Light Bulb Moment

When I give a presentation, my slide decks are already hosted. Why don’t I send people to the URL and let them “follow along” as I present?

This then takes the pressure of my bandwidth and instead pushes it off to each individual client. Yes, this means they have to download the slide assets but this load is far smaller than streaming video — everyone wins. It also gives me the ability to add far more interactive elements to my slides to keep interest from viewers.

Modifying “gatsby-theme-mdx-deck”

In order to start working on this library I moved it from my “node-modules” folder into a folder called “plugins”. Gatsby knows that this folder contains any local versions of plugins that I am working on.

Improving the UX

The first thing I wanted to do was make the way in which you interact with the slide decks more obvious. When you navigate to a slide deck there are no instructions and no interact-able elements. I decided that I should add the following buttons:

Help, Close and Toggle Follow

Note that the toggle button would only be present when I was presenting as you would have control of the slides when I am not.

In the situations when I am not around to give you the tour of how these buttons work, I thought I would let “react-joyride” do it for me. I decided to use a cookie to determine whether the user had seen the tour before. I would only trigger the tour if that cookie had not been set:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
export default () => {  
  const [cookies, setCookie] = useCookies();  
  const TourActive = !cookies.SLDPresTourCookie;  
  const tourCB = (e) => {  
    if (e.action === "reset" || e.action === "close") {  
      setCookie("SLDPresTourCookie", true);  
    }  
  };  
  return (  
    <Joyride  
      steps={toursteps}  
      run={TourActive}  
      showSkipButton={true}  
      continuous={true}  
      callback={tourCB}  
      showProgress={true}  
      disableCloseOnEsc={true}  
      disableOverlayClose={true}  
    />  
  );  
};

The result:

3

I tried to keep the instructions short and sharp.

You can check it out by checking out one of my presentations.

Creating the “Follow Me” Feature

In order to get this to work I was going to need two new features — an internal state to monitor the position in the slides for viewers and a way of sending realtime updates from my machine. A redux +socket.io combination would do nicely.

Up to this point my personal website had been entirely static. I had had no need to introduce internal state on any other page so I consulted the gatsby docs on the subject. That combined with this awesome repo on redux and socket combined, gave me all the pieces I needed to create the feature — I just had to bring them together.

Creating the server

I spun up a node server on heroku and added the following code:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
io.on("connection", function (socket) {  
  if (active) {  
    //If there is a presentation already started, tell the user.  
    socket.emit("action", {  
      type: "startLivePresentor",  
      data: pres,  
    });  
  }  
  socket.on("action", (action) => {  
    if (action.type === "server/verify") {  
      // When I want to intiate a presentation, I send this action and verify it is myself with the password.  
      if (process.env.PRESENT_PASSWORD === action.data.password) {  
        pres.presenter = socket.id;  
        active = true;  
        pres.deck = action.data.location;  
        pres.slide = action.data.index;  
        //I tell any connected clients that I have started the presentation.  
        io.emit("action", {  
          type: "startLivePresentor",  
          data: pres,  
        });  
      }  
    }  
    if (action.type === "server/updateIndex") {  
      if (socket.id === pres.presenter) {  
        // When I (the presenter), update the other clients so they can also update their slides  
        pres.slide = action.data;  
        io.emit("action", {  
          type: "updatePresIndex",  
          data: pres,  
        });  
      }  
    }  
    if (action.type === "server/endPres") {  
      if (socket.id === pres.presenter) {  
        // When I (the presenter) end the presentation, notify viewers  
        io.emit("action", {  
          type: "endLivePresentor",  
        });  
        active = false;  
        pres = defaultPres;  
      }  
    }  
  });  
  socket.on("disconnect", function () {  
    if (socket.id === pres.presenter) {  
      // When I (the presenter) get disconnected, end the presentation and notify viewers  
      io.emit("action", {  
        type: "endLivePresentor",  
      });  
      active = false;  
      pres = defaultPres;  
    }  
  });  
});

Implementing Redux on the site

First we need to add a custom wrapper around gatsby:

gatsby-browser.js

1
2
import wrapWithProvider from "./src/state/wrapWithProvider"  
export const wrapRootElement = wrapWithProvider

This wrapper needs to wrap our site content in a redux provider.

src/state/wrapWithProvider.js

1
2
3
4
5
6
7
8
9
10
11
import React from "react"  
import { Provider } from "react-redux"  
import createStore from "./createStore"

export default ({ element }) => {  
  return (  
    <Provider store={createStore}>  
      {element}  
    </Provider>  
  )  
}

In our store we add methods to handle any incoming actions from the server. Notice the “socketIoMiddleware” that catches any actions that start with”/server” and emits them to our server

src/state/createStore.js

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
import { createStore, applyMiddleware } from "redux";  
import createSocketIoMiddleware from "redux-socket.io";  
import io from "socket.io-client";  
let socket = io("[http://your-socket-server-here.com](http://your-socket-server-here.com)");  
let socketIoMiddleware = createSocketIoMiddleware(socket, "server/");  
function reducer(  
  state = {  
    livePresenter: false,  
    follow: true,  
    verified: false,  
  },  
  action  
) {  
  switch (action.type) {  
    case "follow":  
      return Object.assign({}, { ...state, follow: action.data });  
    case "verify":  
      return Object.assign({}, { ...state, verified: action.data });  
    case "updatePresIndex": {  
      return Object.assign({}, { ...state, presentation: action.data });  
    }  
    case "startLivePresentor":  
      return Object.assign(  
        {},  
        { ...state, livePresenter: true, presentation: action.data }  
      );  
    case "endLivePresentor":  
      return Object.assign(  
        {},  
        {  
          ...state,  
          livePresenter: false,  
          presentation: undefined,  
          verified: false,  
        }  
      );  
    default:  
      return state;  
  }  
}  
let store = applyMiddleware(socketIoMiddleware)(createStore)(reducer);  
store.subscribe(() => {  
  console.log("new client state", store.getState());  
});  
export default store;

Now if we connect any component using redux we will have access to these values.

Slides.js

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
const Deck = ({  
  follow,  
  presentation,  
  livePresenter,  
  changePresPosOnServer,  
  verified,  
}) => {  
  /* ... */  
  /*   
  If their is a live presenter and:  
  A. You ARE NOT the one presenting  
  B, You are in the same deck as the one being presented  
  C. You have follow turned on.  
  Then: Jump to the slide that the live presenter is on  
  */  
  if (  
    !verified &&  
    livePresenter &&  
    follow &&  
    presentation &&  
    window.location.pathname.includes(presentation.deck) &&  
    window.location.pathname !==  
      presentation.deck + "/slides/" + presentation.slide  
  ) {  
    jump(slug, presentation.slide);  
  }  
  /*   
  If their is a live presenter and:  
  A. You ARE the one presenting  
  B. The slide you are on does not match the index on the server  
  Then: Emit action the server telling the viewers where you are  
  */  
  if (  
    verified &&  
    presentation &&  
    window.location.pathname !== "/presentations/" &&  
    index !== presentation.slide  
  ) {  
    changePresPosOnServer(index);  
  }  
  return <>{/* Slides rendered here */}</>;  
};  
const mapStateToProps = ({ presentation, follow, livePresenter, verified }) => {  
  return { presentation, follow, livePresenter, verified };  
};  
const mapDispatchToProps = (dispatch) => {  
  return {  
    changePresPosOnServer: (value) =>  
      dispatch({ type: "server/updateIndex", data: value }),  
  };  
};  
const ConnectedDeck =  
  typeof window !== `undefined`  
    ? connect(mapStateToProps, mapDispatchToProps)(Deck)  
    : Deck;  
export default ConnectedDeck;

And just like that we can now control slide decks remotely!

4

A Little Demo

Get the code:

Personal Site Repo

Socket Server

Extension: Gesture Controlling My Slides

5

I recently attended a conference called “Halfstack”. While I was there I saw a demo of “posenet”. An awesome library that uses a model to identify key body parts from an image or video. I thought it would be cool to use this library to create touch-free slide navigation for presenters using just their gestures.

How Posenet Works

Posenet uses a trained model to take an image and make an attempt at guessing the location of key body parts in that photo. You can see in the preview below, the skeleton is very closely matching my actual position — I was super impressed with its accuracy.

6

Being a magician! 🎩

It can be implemented relatively easily (code borrowed from here):

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
class PoseNet extends Component {  
  async componentDidMount() {  
    try {  
      this.posenet = await posenet.load();  
    } catch (error) {  
      throw new Error("PoseNet failed to load");  
    } finally {  
      setTimeout(() => {  
        this.setState({ loading: false });  
        this.props.loadComplete();  
      }, 200);  
    }  
    this.detectPose();  
  }  
  detectPose() {  
    const { videoWidth, videoHeight } = this.props;  
    const canvas = this.canvas;  
    const canvasContext = canvas.getContext("2d");  
    canvas.width = videoWidth;  
    canvas.height = videoHeight;  
    this.poseDetectionFrame(canvasContext);  
  }  
  poseDetectionFrame(canvasContext) {  
    const posenetModel = this.posenet;  
    const video = this.video;  
    const findPoseDetectionFrame = async () => {  
      let poses = [];  
      const pose = await posenetModel.estimateSinglePose(video, {  
        imageScaleFactor,  
        flipHorizontal,  
        outputStride,  
      });  
      poses.push(pose);  
      break;  
      canvasContext.clearRect(0, 0, videoWidth, videoHeight);  
      poses.forEach(({ score, keypoints }) => {  
        if (score >= minPoseConfidence) {  
          this.props.poseCB({ keypoints });  
          if (showSkeleton) {  
            drawSkeleton(  
              keypoints,  
              minPartConfidence,  
              skeletonColor,  
              skeletonLineWidth,  
              canvasContext  
            );  
          }  
        }  
      });  
      requestAnimationFrame(findPoseDetectionFrame);  
    };  
    findPoseDetectionFrame();  
  }  
  render() {  
    return (  
      <div>  
        <video  
          id="videoNoShow"  
          className="border-radius"  
          style={{ display: "none" }}  
          playsInline  
          ref={this.getVideo}  
        />  
        <canvas  
          className="webcam is-blue-bg border-radius"  
          ref={this.getCanvas}  
          style={{ width: "100%", height: "100%", margin: "auto" }}  
        />  
      </div>  
    );  
  }  
}  
export default PoseNet;

Using This Data

Now what this gives us access to is an array of keypoints. Each point represents a body part, posenet’s estimate of where that body part is and its confidence score.

For my purposes, I focused on the wrists. When gesturing right or left, both wrists are close together and in a specific portion of the screen.

7

When both wrists were in the same box, I knew I was gesturing for a slide change.

All that was left was to work out whether my poses array containing the positions of the left and right wrist had placed them both in the bounding box. I could then use my socket connection as above to change the slide.

1
2
3
4
5
6
7
8
9
10
11
12
13
useEffect(() => {  
    if (presentation && differenceInSeconds(new Date(), lastPunch) > 0.5) {  
      const gesturingRight = poses.every((item) => item.position.x > window.innerWidth*0.75);  
      const gseturingLeft = poses.every((item) => item.position.x < window.innerWidth*0.25);  
      if (gesturingRight && presentation.slide >= 0) {  
        changePresPosOnServer(presentation.slide + 1);  
      }  
      if (gseturingLeft && presentation.slide > 0) {  
        changePresPosOnServer(presentation.slide - 1);  
      }  
      setLastPunch(new Date());  
    }  
  }, [poses]);

I hope you enjoyed this little experiment.

...

...

...

...

Want to know when I post something new? Subscribe to my newsletter. 🚀

I’m Sam Larsen-Disney. I document the cool things I learn and enjoy helping the next generation to code. My site has no ads or sponsors. If you enjoy my content, please consider supporting what I do.