https://github.com/coderwelsch/strapi-video-thumbnails-graphql

This plugin extends the GraphQL API to provide video thumbnail generation capabilities.
https://github.com/coderwelsch/strapi-video-thumbnails-graphql

Last synced: 11 months ago
JSON representation

This plugin extends the GraphQL API to provide video thumbnail generation capabilities.

• Host: GitHub
• URL: https://github.com/coderwelsch/strapi-video-thumbnails-graphql
• Owner: Coderwelsch
• License: mit
• Created: 2025-07-17T22:26:45.000Z (11 months ago)
• Default Branch: main
• Last Pushed: 2025-07-18T12:58:49.000Z (11 months ago)
• Last Synced: 2025-07-18T15:29:30.258Z (11 months ago)
• Language: TypeScript
• Size: 688 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          


	



# Video Thumbnails GraphQl Plugin for Strapi

![NPM Version](https://img.shields.io/npm/v/strapi-graphql-video-thumbnails) ![GitHub License](https://img.shields.io/github/license/Coderwelsch/strapi-video-thumbnails-graphql)

This plugin extends the GraphQL API to provide video thumbnail generation capabilities. It allows users to request thumbnails for videos stored in the public folder.

![GraphQL Query Example](./docs/example-query.png)

## Requirements

- Strapi v5.x

- GraphQL plugin installed and configured

- ffmpeg installed on the server where Strapi is running

- Node.js respectively

## Installation

To install the plugin, you can use npm or yarn. Make sure you are in the root directory of your Strapi project and have the ffmpeg library installed on your server. Then run one of the following commands:

```bash

# Install the plugin

npm install strapi-video-thumbnails

# or use yarn

yarn add strapi-video-thumbnails

 

```

### Enable the Plugin in Strapi

Edit strapi’s `config/plugins.js` file to enable the video thumbnails plugin like this:

```typescript

export default () => ({

	// { Other plugins like graphql setup … }

	"video-thumbnails": {

		enabled: true,

		config: {

			thumbnailsPath: "thumbnails",

			thumbnailSize: '1280x720',

			timeOffset: "00:00:01",

		},

	},

});

```

## Usage

To use this plugin, you need to make a GraphQL query to the `uploadFiles` fields coming from strapi. The plugin will generate thumbnails for the specified video and return the URLs of the generated thumbnails.

```graphql

# Example GraphQL query to get video thumbnails

query ExampleQuery {

	uploadFiles (pagination:  {

		limit: 1

	}) {

		# default UploadFile fields

		# url

		# formats

		# …

		thumbnail

	}

}

```