npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@videosailor/n8n-nodes-videosailor

v1.1.6

Published

n8n community node to download, transcribe, trim, cut, resize, and subtitle videos via VideoSailor

Downloads

788

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

blytheparadoxblytheparadox

Keywords

n8n-community-node-packagen8nvideotranscriptionmediadownloadsubtitles

Readme

🎬 n8n-nodes-videosailor

License npm

⛵ This is an n8n community node for processing video files using the VideoSailor API. It enables you to download, trim, cut, resize, transcribe, and subtitle videos from within your n8n workflows.

n8n is a fair-code licensed workflow automation platform.

✨ Features

🎞️ Video Processing Operations

  • ⬇️ Download, ✂️ trim, cut, and 📐 resize videos
  • 📊 Get detailed video metadata
  • 🎙️ Transcribe audio with word- and segment-level timestamps
  • 💬 Burn custom styled subtitles into videos

🌍 Universal Input Support

  • 🔗 Direct video URLs
  • 📱 Social media links — YouTube, TikTok, Instagram, Twitter/X, Vimeo, and 1,000+ sites

🔌 Easy Integration

  • 🔑 Simple credential setup (API key header auth)
  • 🤖 Native n8n integration — usableAsTool: true, so the node works as an AI agent tool
  • 🎯 Single node with operation dropdown — no per-operation node sprawl

📚 Table of Contents

📦 Installation

Follow the installation guide in the n8n community nodes documentation.

⚙️ Operations

🎥 Video Operations

  • ⬇️ Download — Download a video from a URL and return the file as n8n binary data
  • ℹ️ Video Info — Get video metadata (title, duration, thumbnails) without downloading
  • ✂️ Trim — Trim a video to a start/end time range
  • 🔪 Cut — Cut a segment from a video (alias for Trim)
  • 📐 Resize — Resize a video either by explicit width/height or by aspect ratio + resolution preset (HD / Full HD / 2K / 4K / 8K)
  • 🎙️ Transcribe — Transcribe a video and return timestamped words and segments
  • 💬 Subtitles — Burn custom subtitles (position, font size, color, stroke, background) into a video
  • 📏 Info — Get video dimensions and aspect ratio

💡 The node accepts any URL the VideoSailor API supports — direct media URLs and social media URLs (YouTube, TikTok, Instagram, etc.).

🔐 Credentials

This node requires API credentials for the VideoSailor API.

🗝️ Getting Your API Key

  1. 🌐 Visit VideoSailor and sign up for an account
  2. ⚙️ Navigate to Settings → API Keys in the dashboard
  3. ✨ Generate a new API key
  4. 📋 Copy the API key

📖 Refer to the API Keys Guide for detailed instructions on obtaining and managing your API keys.

🛠️ Configuring Credentials in n8n

  1. ➕ In n8n, create new credentials
  2. 🎯 Select VideoSailor API from the credential types
  3. 🔑 Enter your API key
  4. 🌐 (Optional) Override the Base URL — defaults to https://api.videosailor.com; set to http://localhost:8080 for local development
  5. 💾 Save the credentials
  6. ✅ Use these credentials when configuring the VideoSailor node

🧩 Compatibility

✅ Compatible with [email protected] or later.

🗂️ Example Workflow

An example workflow is included at examples/download-and-transcribe.json. It demonstrates:

  1. Download a YouTube video as binary data
  2. Transcribe the same video and return timestamped segments

To use it: in n8n go to Workflows → Import from file, select the JSON, then add your VideoSailor credentials.

🔗 Resources

🧑‍💻 Development

📋 Prerequisites

  • 🟢 Node.js (version compatible with the typescript and n8n-workflow peer range)
  • 📦 npm

🚀 Setup

  1. 📥 Clone the repository
  2. 📦 Install dependencies:
    cd n8n-node
npm install

🏗️ Building

Build the node package (compiles TypeScript and copies icons via gulp):

npm run build

👀 Watch mode for development:

npm run dev

🔗 Linking into a local n8n instance

npm link
cd ~/.n8n/custom
npm link n8n-nodes-videosailor

🔄 Then restart n8n so the custom node is picked up.

🧹 Linting & Formatting

🔍 Run ESLint:

npm run lint

🛠️ Fix linting issues automatically:

npm run lintfix

✨ Format sources with Prettier:

npm run format

🚢 Publishing

Releases are automated via release-please. Commit to main using Conventional Commits and release-please handles the rest:

| Prefix | Effect | npm version bump | |--------|--------|-----------------| | feat: | New operation or capability | minor | | fix: | Bug fix | patch | | perf: | Performance improvement | patch | | deps: | Dependency update | patch | | feat!: or BREAKING CHANGE: footer | Breaking API change | major | | chore: / docs: / refactor: | No user-facing change | none |

When commits land on main, release-please opens or updates a Release PR with a changelog and bumped version. Merging that PR creates a GitHub release, which triggers the publish workflow to push to npm with provenance automatically.