GitHunt

vembedr

CRAN_Status_Badge
R-CMD-check

The goal of vembedr is to make it a little bit easier for you to embed
videos into your RMarkdown documents and your Shiny apps; these
services are supported:

  • YouTube
  • Vimeo
  • Box
  • Microsoft Stream

New to version 0.1.5

  • updated internal implementation to comport with latest Pandoc.
    (#52, thanks
    @jnolis!)
  • deprecated Microsoft Channel 9 (including UserR! 2016 & 2017), as
    Channel 9 has been
    moved
    .
    (#54)

Installation

You can install the latest released version from CRAN with:

install.packages("vembedr")

or the latest development version from GitHub with:

# install.packages("devtools")
devtools::install_github("ijlyttle/vembedr")

Documentation

This project supports two documentation-websites, built using
pkgdown:

Usage

The most useful function might be embed_url(). If the URL is from one
of the supported services, it will do the right thing:

library("vembedr")

embed_url("https://www.youtube.com/watch?v=uV4UpCq2azs")

The video is not embedded in this README file as is rendered to
Markdown; to see embedded videos, please see vignette("vembedr"). Each
of the supported services, e.g. YouTube, is discussed in
vignette("embed").

The functions are designed to be piped. For example, here’s how you can
modify the appearance and the start time:

embed_url("https://www.youtube.com/watch?v=uV4UpCq2azs") %>%
  use_start_time("1m32") %>%
  use_align("center")

To see these functions in action, see vignette("modify").

Caveats

  • Be aware that, due to licensing issues, not all videos will play
    when embedded at a different site (like your HTML document).

  • The RStudio viewer will embed YouTube and Vimeo videos, but not
    others. Videos from all services should be rendered as you expect in
    a browser like Chrome.

  • Some of the formatting, e.g. rounded corners, does not render on
    mobile sites.

Code of Conduct

Please note that the vembedr project is released with a Contributor
Code of
Conduct
.
By contributing to this project, you agree to abide by its terms.

Languages

HTML86.2%R13.4%CSS0.4%

Contributors

Other
Created May 14, 2016
Updated May 13, 2025
ijlyttle/vembedr | GitHunt