jekyll-livid

A Jekyll plugin that provides a {% livid %} Liquid tag for embedding Livid-hosted videos with a responsive iframe wrapper and full support for advanced embedding parameters.

This plugin is intentionally narrow. It handles one thing: embedding Livid videos cleanly in Jekyll templates with a minimal, standards-compliant iframe output.

• Jekyll site owners who host video on Livid
• Anyone migrating from Vimeo to Livid who wants drop-in embed support
• Developers who want fine-grained control over player behavior via URL parameters

• {% livid VIDEO_ID %} tag with responsive 16:9 iframe wrapper
• Full support for all Livid advanced embedding parameters
• #t= hash fragment support for timestamp-based start positions
• Unknown parameter warnings via Jekyll logger (skipped silently in output)
• Lazy-loading iframe by default

This plugin is compatible with Jekyll sites deployed to GitHub Pages when the site is built through a custom GitHub Actions workflow.

It is not compatible with the default GitHub Pages safe-mode build, which does not load custom plugins.

Published on RubyGems:

• https://rubygems.org/gems/jekyll-livid

Add the gem to your Gemfile:

gem "jekyll-livid", "~> 0.1.0"

Then add it to _config.yml:

plugins:
  - jekyll-livid

Run:

bundle install

The plugin outputs a wrapper div with the class livid-embed. No spacing or layout styles are applied — this is intentional, since every site has its own typographic rhythm and spacing scale.

If the embed sits too close to the content below it, add a rule to your site's CSS or SCSS:

.livid-embed {
  margin-bottom: 32px; /* adjust to match your site's heading/paragraph spacing */
}

{% livid Bdkgc6Wvujvh %}

{% livid Bdkgc6Wvujvh autoplay=true muted=true loop=true %}
{% livid Bdkgc6Wvujvh color=ff0000 controls=false %}
{% livid Bdkgc6Wvujvh dnt=true %}
{% livid Bdkgc6Wvujvh t=30 %}

The t parameter starts playback at a specific second and is appended as a URL hash fragment (#t=30). All other parameters are appended as query string parameters.

All parameters from the Livid advanced embedding documentation are supported. Boolean parameters accept true/false or 1/0.

• https://jasonchance.com/projects/jekyll-livid/

Install dependencies:

bundle install

Run tests:

ruby -Ilib -Itest test/livid_tag_test.rb

MIT