jekyll-livid
Livid, ad-free video hosting for individuals and small businesses. jekyll-livid lets you embed a Livid video in Jekyll with one tag.
Open Source Plugin ∙

jekyll-livid

A Jekyll plugin that adds a {% livid %} Liquid tag for embedding Livid videos in a responsive iframe, with support for all of Livid's advanced embedding parameters.

jekyll-livid is a Jekyll plugin that lets you embed a Livid-hosted video with one tag. It outputs a clean, responsive iframe wrapper and passes any mix of Livid’s advanced embedding parameters straight to the player.

Demo

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

Why This Exists

I like Livid as a Vimeo alternative. It’s more affordable, it’s better value for small organizations, and it fits 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 tag instead of raw HTML dropped into my Markdown.

Source Code

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 wraps the player in a div with the class livid-embed. It doesn’t add any spacing or layout styles, and that’s on purpose. Every site has its own type 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 string of letters and numbers at the end of your Livid share URL (e.g. https://livid.com/watch/YEsVONDwAoi8 → ID is YEsVONDwAoi8).

Advanced Parameters

Every one of Livid’s advanced embedding parameters works:

Parameter Values Notes
autoplay true/false All videos
muted true/false All videos
loop true/false All videos
controls true/false Pro/Premium
color hex code (no #) Pro/Premium
colors up to 4 comma-separated hex codes Pro/Premium
dnt true/false Disables analytics. All videos.
background true/false No controls, loops, autoplay, muted. Pro/Premium.
t seconds Start position, appended as #t=N
preload auto/metadata/none All videos
playsinline true/false Mobile inline playback. All videos.
fullscreen true/false Pro/Premium
pip true/false Picture-in-picture. Pro/Premium.
keyboard true/false All videos
livid_logo true/false Pro/Premium
title true/false Pro/Premium
share true/false Pro/Premium
speed true/false Pro/Premium
quality_selector true/false Pro/Premium
min_quality 240p–4k Pro/Premium
max_quality 240p–4k Pro/Premium
progress_bar true/false Pro/Premium
volume true/false Pro/Premium
cc true/false Closed captions. Pro/Premium.
chromecast true/false Pro/Premium
airplay true/false Safari only. Pro/Premium.
play_button_position auto/bottom/center Pro/Premium
transparent true/false All videos
custom_logo true/false Pro/Premium