peasy-video

Ruby client for the PeasyVideo API — calculate resolution, estimate bitrate, and analyze frame rates for video files. Zero dependencies beyond Ruby stdlib (Net::HTTP, JSON, URI).

Built from PeasyVideo, a comprehensive video processing toolkit offering free online tools for trimming, resizing, generating thumbnails, and creating GIFs from video files. The site includes in-depth guides on video codec selection, compression strategies for web delivery, and a glossary covering concepts from H.264 encoding and frame rates to container formats and color grading.

Try the interactive tools at peasyvideo.com — Video Resolution Calculator, Video Bitrate Calculator, Video Framerate Converter, and more.

• Install
• Quick Start
• What You Can Do
  • Video Analysis Tools
  • Browse Reference Content
  • Search and Discovery
• API Client
  • Available Methods
• Learn More About Video Tools
• Also Available
• Peasy Developer Tools
• License

gem install peasy-video

Or add to your Gemfile:

gem "peasy-video"

require "peasy_video"

client = PeasyVideo::Client.new

# List available video tools
tools = client.list_tools
tools["results"].each do |tool|
  puts "#{tool["name"]}: #{tool["description"]}"
end

Digital video combines spatial resolution (the number of pixels in each frame) with temporal resolution (the number of frames displayed per second) to create the illusion of motion. A 1080p video at 30 fps produces 30 full 1920x1080 frames every second — over 62 million pixels per second of raw data. Codecs like H.264 (AVC) and H.265 (HEVC) use inter-frame prediction, motion compensation, and transform coding to compress this data by 100-1000x, while newer codecs like AV1 push efficiency even further at the cost of encoding time. PeasyVideo provides calculators and analysis tools for understanding these encoding parameters.

Common resolutions follow a progression from SD (480p, 640x480) through HD (720p, 1280x720) and Full HD (1080p, 1920x1080) to 4K UHD (2160p, 3840x2160) and beyond. Each step roughly quadruples the pixel count, dramatically increasing both visual clarity and storage requirements. At standard bitrates, a 1-minute 1080p H.264 video at 8 Mbps produces approximately 60 MB of data, while the same clip at 4K resolution typically requires 20-35 Mbps for acceptable quality.

require "peasy_video"

client = PeasyVideo::Client.new

# Get the resolution calculator for pixel and aspect ratio analysis
tool = client.get_tool("video-resolution")
puts "Tool: #{tool["name"]}"              # Video resolution calculator name
puts "Description: #{tool["description"]}" # How resolution calculation works

# List all available video tools with pagination
tools = client.list_tools(page: 1, limit: 20)
puts "Total video tools available: #{tools["count"]}"

Learn more: Video Resolution Calculator · Video Codecs Explained · Video Compression for Web Delivery

PeasyVideo includes a comprehensive glossary of video engineering terminology and practical guides for common workflows. The glossary covers foundational concepts like H.264 (the most widely deployed video codec, used in everything from Blu-ray discs to web streaming), frame rate (the number of individual frames displayed per second, typically 24 fps for cinema, 30 fps for broadcast TV, and 60 fps for gaming), container formats (MP4 and WebM wrap encoded video and audio streams into a single file), and color grading (the process of altering the color and tone of footage for creative or corrective purposes).

The distinction between codecs and containers is essential for video engineering. A codec (H.264, H.265, VP9, AV1) compresses and decompresses the video data itself, while a container format (MP4, WebM, MKV, MOV) packages the compressed video stream together with audio tracks, subtitles, and metadata into a single file. The same H.264-encoded video can be wrapped in an MP4 container for broad device compatibility or in an MKV container for advanced features like multiple audio tracks and chapter markers.

require "peasy_video"

client = PeasyVideo::Client.new

# Browse the video glossary for codec and encoding terminology
glossary = client.list_glossary(search: "codec")
glossary["results"].each do |term|
  puts "#{term["term"]}: #{term["definition"]}"
end

# Read a guide explaining video codec selection and trade-offs
guide = client.get_guide("video-codecs-explained")
puts "Guide: #{guide["title"]} (Level: #{guide["audience_level"]})"

Learn more: Video Glossary · Video Codecs Explained · Video Compression for Web Delivery

The API supports full-text search across all content types — tools, glossary terms, guides, use cases, and format documentation. Search results are grouped by content type, making it easy to find the right tool or reference for any video workflow. Format conversion data covers the full matrix of source-to-target transformations, including codec compatibility constraints — for example, WebM containers only support VP8, VP9, and AV1 video codecs, while MP4 supports H.264, H.265, and AV1 among others.

require "peasy_video"

client = PeasyVideo::Client.new

# Search across all video content — tools, glossary, guides, and formats
results = client.search("convert mp4")
puts "Found #{results["results"]["tools"].length} tools"
puts "Found #{results["results"]["glossary"].length} glossary terms"
puts "Found #{results["results"]["guides"].length} guides"

# Discover format conversion paths — what can WebM convert to?
conversions = client.list_conversions(source: "webm")
conversions["results"].each do |c|
  puts "#{c["source_format"]} -> #{c["target_format"]}"
end

# Get detailed information about a specific video format
format = client.get_format("mp4")
puts "#{format["name"]} (#{format["extension"]}): #{format["mime_type"]}"

Learn more: REST API Docs · All Video Tools · All Formats

The client wraps the PeasyVideo REST API using only Ruby standard library — no external dependencies.

require "peasy_video"

client = PeasyVideo::Client.new
# Or with a custom base URL:
# client = PeasyVideo::Client.new(base_url: "https://custom.example.com")

# List tools with pagination and filters
tools = client.list_tools(page: 1, limit: 10, search: "trim")

# Get a specific tool by slug
tool = client.get_tool("video-trim")
puts "#{tool["name"]}: #{tool["description"]}"

# Search across all content
results = client.search("trim")
puts "Found #{results["results"]["tools"].length} tools"

# Browse the glossary
glossary = client.list_glossary(search: "mp4")
glossary["results"].each do |term|
  puts "#{term["term"]}: #{term["definition"]}"
end

# Discover guides
guides = client.list_guides(category: "video")
guides["results"].each do |guide|
  puts "#{guide["title"]} (#{guide["audience_level"]})"
end

# List file format conversions
conversions = client.list_conversions(source: "webm")

# Get format details
format = client.get_format("webm")
puts "#{format["name"]} (#{format["extension"]}): #{format["mime_type"]}"

All list methods accept keyword arguments: page:, limit:, category:, search:.

Full API documentation at peasyvideo.com/developers/. OpenAPI 3.1.0 spec: peasyvideo.com/api/openapi.json.

• Tools: Video Resolution Calculator · Video Bitrate Calculator · Video Framerate Converter · All Tools
• Guides: Video Codecs Explained · Video Compression for Web Delivery · All Guides
• Glossary: AV1 · Frame Rate · Color Grading · All Terms
• Formats: MP4 · WebM · All Formats
• API: REST API Docs · OpenAPI Spec

Part of the Peasy Tools open-source developer ecosystem.

Embed PeasyVideo widgets on any website with peasy-video-embed:

<script src="https://cdn.jsdelivr.net/npm/peasy-video-embed@1/dist/embed.min.js"></script>
<div data-peasyvideo="entity" data-slug="example"></div>

Zero dependencies · Shadow DOM · 4 themes (light/dark/sepia/auto) · Widget docs

MIT