Getting Started with zoomstudentengagement

zoomstudentengagement package

2025-08-03

library(zoomstudentengagement)
library(dplyr)
#> 
#> Attaching package: 'dplyr'
#> The following objects are masked from 'package:stats':
#> 
#>     filter, lag
#> The following objects are masked from 'package:base':
#> 
#>     intersect, setdiff, setequal, union
library(ggplot2)

Getting Started with zoomstudentengagement

The zoomstudentengagement package helps instructors analyze student engagement from Zoom transcripts, with a particular focus on participation equity. This vignette will get you started with the basic workflow.

Installation

Install the package from GitHub:

devtools::install_github("revgizmo/zoomstudentengagement")

Quick Start

Here’s a minimal example to get you started:

# Load a sample transcript
transcript_file <- system.file(
  "extdata/transcripts/GMT20240124-202901_Recording.transcript.vtt",
  package = "zoomstudentengagement"
)

# Process the transcript
processed_transcript <- process_zoom_transcript(
  transcript_file_path = transcript_file,
  consolidate_comments = TRUE,
  add_dead_air = TRUE
)

# Calculate summary metrics
summary_metrics <- summarize_transcript_metrics(
  transcript_file_path = transcript_file,
  names_exclude = c("dead_air")
)

# View the results
head(summary_metrics)
#> # A tibble: 6 × 10
#>   transcript_file   name      n duration wordcount comments n_perc duration_perc
#>   <chr>             <chr> <int>    <dbl>     <dbl> <I<list>  <dbl>         <dbl>
#> 1 GMT20240124-2029… Cono…    30  485.         1418 <chr>     66.7         72.2  
#> 2 GMT20240124-2029… Srij…     8   69.1         213 <chr>     17.8         10.3  
#> 3 GMT20240124-2029… Shre…     3   43.3          86 <chr>      6.67         6.45 
#> 4 GMT20240124-2029… Dr. …     2   42.7          98 <chr>      4.44         6.36 
#> 5 GMT20240124-2029… Ryan…     1   31.3          95 <chr>      2.22         4.65 
#> 6 GMT20240124-2029… unkn…     1    0.680         1 <chr>      2.22         0.101
#> # ℹ 2 more variables: wordcount_perc <dbl>, wpm <dbl>

What the Package Does

The zoomstudentengagement package provides tools for:

  1. Loading and Processing Zoom Transcripts: Convert Zoom VTT files into analyzable data
  2. Calculating Engagement Metrics: Measure participation by speaker/student
  3. Name Matching and Cleaning: Match transcript names to student rosters
  4. Visualization: Create plots to analyze participation patterns
  5. Reporting: Generate individual student reports

Basic Workflow

The typical workflow involves:

  1. Setup: Configure your analysis parameters
  2. Load Transcripts: Import and process Zoom transcript files
  3. Load Roster: Import student enrollment data
  4. Clean Names: Match transcript names to student records
  5. Analyze: Calculate metrics and create visualizations
  6. Report: Generate insights and reports

Next Steps

Getting Help