# 🎬 Video Library

Totum Video Library is where you browse surgical activity recordings, discuss them with peers, invite collaborators, and submit videos for formal assessment in Totum Assess.

Video Library uses your Totum platform account, organisations, and activity recordings. It is a separate product from Totum itself.

# What it is

Video Library is your personal hub for procedure videos that come from Totum activities (for example simulator sessions on the Totum platform). From one place you can:

• ▶️ Watch recordings with a full video player
• 💬 Discuss a procedure in a threaded chat
• ✏️ Draw and annotate on frames (when invited as a reviewer, or as the owner)
• 👥 Invite peers as informal Reviewers or Viewers
• ✅ Select formal Assessors and Submit for Assessment into Totum Assess
• 📩 View completed assessment feedback when it is available

Video Library does not author assessment frameworks — that is Forms. It also does not host the formal scoring form — that is Assess.

flowchart LR
  Totum["Totum activities"]
  VL["Video Library"]
  Collab["Informal invites\nReviewer / Viewer"]
  Formal["Submit for Assessment"]
  Assess["Totum Assess"]

  Totum --> VL
  VL --> Collab
  VL --> Formal --> Assess

# Who it’s for

# ⚡ Quick start

# Open and watch a video

1. Sign in to Video Library.
2. Confirm the correct organisation in the header switcher.
3. On the dashboard, open the Video Library tab.
4. Click a video card to open the video page.
5. Use the player to watch; scroll for discussion and metrics where available.

# Invite a peer to collaborate (informal)

1. On the video page, open the Invites panel.
2. Make sure you are connected with the person on Social Connections (required for most informal invites).
3. Choose Invite Reviewers (can annotate) or Invite Viewers (watch and comment).
4. Add an optional message and send.
5. They accept from the video or from the Video Invites dashboard tab.

# Submit for formal assessment

1. On the video page, open Invites → Assessors.
2. Select one or more eligible assessors.
3. Choose a completion strategy if offered (for example all assessors must finish, or the first to finish completes the case).
4. Click Submit for Assessment.
5. Watch the status card for progress. When complete, use View feedback.

For the full end-to-end story with Assess, see Example workflow 2.

# 🖥️ Screens

# Dashboard

After login you land on the dashboard, which has three main tabs:

💡 Empty library tip: videos appear after you complete simulator (or other) activities that produce recordings in Totum. There is no general “upload any file” flow in the main library experience.

# Video page

Opening a video shows:

• ▶️ Player (left) — stream playback, timeline markers where present
• 📎 Sidebar (right) — Discussion and Invites
• 📊 Below the player — CME content and performance / metrics panels when the activity supports them

As the owner you can typically delete your own video from the library.

# Review feedback

When a formal assessment has completed and results are available to you, open View feedback from the status card, or go to the feedback page for that video. You may also be offered a link into Totum Assess My feedback if your programme enables it.

# Admin: Reviewer eligibility

Organisation administrators may see Reviewer eligibility under the admin menu. Use it to understand who can appear in the formal assessor picker for the current organisation (seats, connections, and related rules).

# 🎭 Invite roles: Assessor, Reviewer, Viewer

These three labels appear in Video Library and mean different things. Mixing them up is a common source of confusion.

flowchart TB
  Owner["Video owner"]
  Assessor["Assessor\nformal scoring in Assess"]
  Reviewer["Reviewer\nannotate and discuss"]
  Viewer["Viewer\nwatch and comment"]

  Owner -->|"Submit for Assessment"| Assessor
  Owner -->|"Invite Reviewers"| Reviewer
  Owner -->|"Invite Viewers"| Viewer

The same person can be both an Assessor (formal) and an informal Reviewer on the same video.

For how this relates to the “Reviewer” role inside Assess itself, see Roles and permissions.

# 🛠️ How-tos

# Browse and open videos

1. Open the Video Library tab.
2. Use pagination / scrolling to find the recording.
3. Click the card to open the video for that activity.

# Connect with another user

1. Open the Social Connections tab.
2. Search for the person by name or email (as offered).
3. Send a connection request.
4. They accept from their own Social Connections (or equivalent inbox).

Connections are often required before you can invite someone as an informal Reviewer or Viewer, and your programme may also require a connection before someone appears as a formal Assessor.

# Accept or decline an invite

• From Video Invites on the dashboard: open the invite and accept or decline.
• From the video page: respond when the invite is presented there.
• Accepting often opens the video so you can start watching or annotating immediately.

# Discuss a procedure

1. Open the video.
2. Use the Discussion (chat) panel.
3. Post messages, reply, react, mention colleagues, and pin important comments as supported.
4. Owners and informal Reviewers can typically draw on frames and, where enabled, record short video replies.

# Submit for assessment (detail)

sequenceDiagram
  participant Surgeon
  participant VL as Video Library
  participant Assess as Totum Assess
  participant Peer as Assessor

  Surgeon->>VL: Select Assessors and submit
  VL->>Assess: Create case and assignments
  Peer->>Assess: Accept, score, submit
  Assess->>VL: Status and feedback available
  Surgeon->>VL: View feedback

1. Confirm you are in the correct organisation — the assessor list and case tagging depend on it.
2. Open Invites → Assessors.
3. Select assessors from the eligible list (usually people who:
   • Are connected to you (if your programme requires connections), and
   • Hold an Assess Reviewer-type seat in the current organisation).
4. Set completion strategy if prompted.
5. Submit for Assessment.
6. Totum Assess creates a case and assigns the selected peers.
7. Follow status on the video. When finished, open View feedback.

# Read assessment feedback

1. Wait until the case status shows complete (and your programme allows submitters to see results).
2. Use View feedback on the video, or open the feedback page from a notification.
3. Review scores and comments returned from Assess.

Notifications may also appear in the header notification bell 🔔 when an assessment completes.

# 💡 Tips and common gotchas

• Organisation switcher matters for Assessors, even though your video grid is mostly “my videos”. Switch org before submitting if you train across programmes.
• No one in the assessor list? Check Social Connections, Assess Reviewer seats, and that you are in the right organisation. Admins can use Reviewer eligibility.
• Informal Reviewer ≠ formal Assessor. Drawing on a video does not replace completing an Assess assignment.
• CME and metrics appear when the underlying Totum platform activity supports them; not every video will show the same panels.
• Feedback missing after completion? Your programme may hide submitter results, show status only, or delay visibility — ask your Assess administrator (see Assess Settings).

# Related chapters

• Getting started
• Assess — where formal scoring happens
• Example workflows
• Roles and permissions
• Glossary