jekyll-livid

jekyll-livid is a Jekyll plugin that makes embedding Livid-hosted videos as simple as one tag. It outputs a clean, responsive iframe wrapper and passes any combination of Livid’s advanced embedding parameters directly to the player.

Demo

{% livid Bdkgc6Wvujvh livid_logo=true title=false airplay=true chromecast=true pip=true speed=true quality_selector=true keyboard=true %}

Why This Exists

Livid is a compelling Vimeo alternative — more affordable, better value for small organizations, and a genuine fit for the kind of work I do in local government and economic development. I wanted to embed Livid videos in Jekyll the same way I embed other media: with a clean, intentional tag rather than raw HTML in Markdown.

Source Code

• GitHub: github.com/jchance/jekyll-livid
• RubyGems: rubygems.org/gems/jekyll-livid

Installation

Add to your Gemfile:

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

Add to _config.yml:

plugins:
  - jekyll-livid

Then run bundle install.

Styling

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

If the video sits too close to the content below it, add a rule to your site’s CSS:

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

Usage

Basic embed:

{% livid VIDEO_ID %}

With parameters:

{% livid VIDEO_ID autoplay=true muted=true %}
{% livid VIDEO_ID color=ff0000 controls=false %}
{% livid VIDEO_ID t=30 %}

The video ID is the alphanumeric string at the end of your Livid share URL (e.g. https://livid.com/watch/Bdkgc6Wvujvh → ID is Bdkgc6Wvujvh).

Advanced Parameters

All Livid advanced embedding parameters are supported: