How To Make A Custom Video Player

Banner for a MediaJam post


Seeing videos on the web is expected at this point. It's one of the methods we use to teach ourselves new things or entertain ourselves. With videos being used so commonly, it's important for us to make good user interfaces for them.

When your users are interacting with videos, you want to make sure they can easily control how the video plays and what features they have access to. Most video controls are right there on the video, but it doesn't have to be that way.

In this tutorial, we're going to create a custom video player. It'll have multiple options for a user to enter and they'll be saved as user settings. When the page is reloaded, the selected video options will be reloaded as well.

Setting up Redwood

Let's start by talking about what Redwood is. It's a full-stack JavaScript framework that uses React, GraphQL, and Prisma to handle everything from the front-end to the database. It has built-in testing and Storybook support, plus a bunch of other great features. You can learn more about it in the Redwood docs.

Now let's create a new Redwood app. You can do that by running:

yarn create redwood-app custom-video-player

Once that command finishes (it might take a few minutes), you'll have a fully functional full-stack app. The directory it creates has a number of files and subdirectories. The two most important directories are api and web.

The api folder holds all of the code for the GraphQL back-end and the Prisma model for the Postgres database. The web folder holds all of the React front-end code. We'll be updating the code in these folders throughout this tutorial.

You can run the app now to see what it looks like and how it loads with:

yarn rw dev

This command starts the GraphQL server and the front-end. The running app should look like this:

base Redwood app

Since we know the app is working, let's update some back-end code.

Handling the video data

We want to save a user's preferences for how a video is displayed and how it behaves, like will it run on a loop. To do that, we need to create a Prisma schema for Postgres database we'll connect to. I'll be connecting to a local Postgres instance and you can learn more about how to set that up on the Postgres downloads page.

In the .env file, uncomment the DATABASE_URL line and update it to match your Postgres instance. Here's an example of what mine looks like. Make sure you remember what your username and password are for your local Postgres server!


Next, we need to update our Prisma schema so open the schema.prisma file. We're going to create the model for the Setting table we need to hold the user values. Redwood already generated an example model, so we can just swap out the names of everything. Update your file to look like this.

1datasource db {
2 provider = "postgresql"
3 url = env("DATABASE_URL")
6generator client {
7 provider = "prisma-client-js"
8 binaryTargets = "native"
11model Setting {
12 id Int @id @default(autoincrement())
13 videoName String @unique
14 loop Boolean
15 volume Float @default(0.5)
16 controls Boolean @default(false)
17 playbackRate Float @default(1.5)

This is how we tell our app to use Postgres as the database and how the tables should be structured. The Setting model defines the settings we're saving for the user and the data types we expect for them. The last three options have default values so that a video will play whether or not the user picks any particular options.

Now we'll add one piece of seed data. When we run our migration, it'll be nice to already have a user setting generated to start with. We aren't creating a new setting each time, we're just updating it. That means we need to have a setting already in place to update.

In the seed.js file, we're going to add one row of data to the Setting table. Update your file to look like this.

1/* eslint-disable no-console */
2const { PrismaClient } = require('@prisma/client')
3const dotenv = require('dotenv')
6const db = new PrismaClient()
8async function main() {
9 console.warn('Please define your seed data.')
11 const record = await db.setting.create({
12 data: {
13 videoName: 'elephant_herd',
14 loop: false,
15 controls: true,
16 volume: 0.2,
17 playbackRate: 1.5,
18 },
19 })
20 console.log(record)
24 .catch((e) => console.error(e))
25 .finally(async () => {
26 await db.$disconnect()
27 })

Now all that's left to do for our database is create and run a migration. To do this, run the following command:

yarn rw prisma migrate dev

This creates a new migration and seeds the data. Now when we get ready to connect the front-end, there will already be a setting to update. With the database ready to go, it's time to create our GraphQL server.

Building the GraphQL server

Redwood does a lot of things for you pretty quickly.

GraphQL schema and resolvers

We're about to run a command that will generate the GraphQL schema and resolvers.

yarn rw g sdl setting

If you take a look in the api > src > graphql directory, you'll find all of the GraphQL types based on the Prisma schema you need to do some basic operations. Now look in the api > src > services directory. There's a settings folder that has the file for one resolver.

Updating the base GraphQL files

Since we're in the settings.js with the resolver, let's add a couple more resolvers to handle our front-end requests. The first resolver will get an individual setting based on the setting ID. The second resolver will be used to handle updates to the setting.

Add the following code after the settings resolver in the file.

1export const setting = (input) => {
2 return db.setting.findFirst({
3 where: { id: },
4 })
7export const updateSetting = ({ input }) => {
8 console.log(`This is the input: + ${input.volume}`)
9 return db.setting.update({
10 where: { id: },
11 data: {
12 loop: input.loop,
13 videoName: input.videoName,
14 controls: input.controls,
15 volume: input.volume,
16 playbackRate: input.playbackRate,
17 },
18 })

Then you'll need to update the settings.sdl.js file to have the matching schema for these new resolvers.

1type Mutation {
2 updateSetting(input: UpdateSettingInput): Setting
5type Query {
6 setting(id: Int): Setting!

You'll also need to add the id field to the UpdateSettingInput type so that we're able to update based on the setting ID.

1input UpdateSettingInput {
2 id: Int
3 videoName: String
4 loop: Boolean
5 volume: Float
6 controls: Boolean
7 playbackRate: Float

With the new resolvers and updated GraphQL schema in place, we can finally move on to the front-end.

Making the UI for the video player

This is something else that Redwood handles very well for us. The command we're about to run will create a new page and add the routing for us. We're going to make a new home page that displays at the root URL of the app.

yarn rw g page home /

If you take a look in the web > src > pages directory, you'll see a new HomePage directory. This is where the home page we created with the previous command is located. We're going to make our video player in this file, but if you want to see what the app looks like in the browser now, run:

yarn rw dev

Your page should look similar to this.

Home page of Redwood app

Creating the video player

Now we'll work on the way our custom video player will look to users. It won't be the fanciest CSS work, but it'll be usable! You'll need to install a couple of packages inside the web directory. Once you're in the web directory in your terminal, run the following command:

yarn add styled-components react-player

We'll be using styled-components to add some simple styling to the video player and we're using react-player as the video player component. Let's start by completely updating the Home component.

We're going to import some Redwood form components to give users custom control over their video player. This is how we'll be able to save those settings. The form values will be connected to the video player a little later, so we just need the UI in place.

There will be a couple of styled components to space things a little better on the screen. We're also importing the video from Cloudinary and we'll talk about how to set that up in a bit.

Update your HomePage.js file to have the following code.

1import {
2 Form,
3 Label,
4 TextField,
5 CheckboxField,
6 RangeField,
7 RadioField,
8 Submit,
9} from '@redwoodjs/forms'
10import { useMutation, useQuery } from '@redwoodjs/web'
11import styled from 'styled-components'
12import ReactPlayer from 'react-player'
14const HomePage = () => {
15 return (
16 <Container>
17 <VideoPlayer>
18 <ReactPlayer
19 controls={true}
20 loop={false}
21 volume={0.5}
22 playbackRate={1}
23 url={`,h_360,w_480,q_70,du_10/elephant_herd.mp4`}
24 ></ReactPlayer>
25 </VideoPlayer>
26 <Form>
27 <FormContainer>
28 <Label name="videoName">Video Name</Label>
29 <TextField name="videoName" />
30 <Label name="loop">Loop</Label>
31 <CheckboxField name="loop" />
32 <Label name="controls">Controls</Label>
33 <CheckboxField name="controls" />
34 <Label name="volume">Volume</Label>
35 <RangeField name="volume" />
36 <Label name="playbackRate">1x</Label>
37 <RadioField name="playbackRate" value={1} />
38 <Label name="playbackRate">1.5x</Label>
39 <RadioField name="playbackRate" value={1.5} />
40 <Label name="playbackRate">2x</Label>
41 <RadioField name="playbackRate" value={2} />
42 <Submit>Save</Submit>
43 </FormContainer>
44 </Form>
45 </Container>
46 )
49const Container = styled.div`
50 width: 100%;
53const FormContainer = styled.div`
54 display: flex;
55 flex-direction: column;
56 margin: 0 auto;
57 padding-top: 25px;
58 width: 500px;
61const VideoPlayer = styled.div`
62 display: block;
63 margin: 0 auto;
64 width: 50%;
67export default HomePage

With this code on your home page, you should see something like this in the browser when you run your app.

video player

Adding the GraphQL calls

Since there's a form, we probably need to connect it to the back-end to store and retrieve data for the custom video player. It's time to add our GraphQL requests on the front-end.

Inside the HomePage.js file, we're going to add a new import to the others in order to create a query and mutation.

import { useMutation, useQuery } from '@redwoodjs/web'

Now add the following code inside of the HomePage component. This will create the methods for updating and retriving the user settings and create the onSubmit method for the form. Since we seeded the database and we're only working with one user, I've hard-coded the setting ID as 1. We even do some state handling for when the data is being fetched in the GraphQL query.

1const { loading, error, data } = useQuery(SETTING, { variables: { id: 1 } })
3const [updateSetting] = useMutation(UPDATE_SETTING)
5const onSubmit = (data) => {
6 updateSetting({
7 variables: {
8 id: 1,
9 videoName: data.videoName,
10 loop: data.loop,
11 controls: data.controls,
12 volume: Number(data.volume),
13 playbackRate: Number(data.playbackRate),
14 },
15 })
18if (loading) {
19 return <div>Loading..</div>
22if (error) {
23 return <div>{error.message}</div>

Now we need to add the variables that define the shape of the GraphQL requests we want to execute. We'll use the GraphQL query language syntax to create these requests and define the data we want to send and return. Right after the HomePage component ends, add the following code.

1const SETTING = gql`
2 query Setting($id: Int) {
3 setting(id: $id) {
4 id
5 videoName
6 loop
7 controls
8 volume
9 playbackRate
10 }
11 }
14const UPDATE_SETTING = gql`
15 mutation UpdateSetting(
16 $id: Int
17 $videoName: String
18 $loop: Boolean
19 $controls: Boolean
20 $volume: Float
21 $playbackRate: Float
22 ) {
23 updateSetting(
24 input: {
25 id: $id
26 videoName: $videoName
27 loop: $loop
28 controls: $controls
29 volume: $volume
30 playbackRate: $playbackRate
31 }
32 ) {
33 id
34 videoName
35 loop
36 controls
37 volume
38 playbackRate
39 }
40 }

The last thing we have to do is update our form to submit the update when we click save and load the values returned from the query. We're going to update the video URL to use the videoName we saved and add defaultValue attributes to all of the form fields to show the stored values.

2 <ReactPlayer>
3 ...
4 url={`,h_360,w_480,q_70,du_10/${
5 data.setting.videoName || 'elephant_herd'
6 }.mp4`}
7 ></ReactPlayer>
9<Form onSubmit={onSubmit}>
10 <FormContainer>
11 <Label name="videoName">Video Name</Label>
12 <TextField name="videoName" defaultValue={data.setting.videoName} />
13 <Label name="loop">Loop</Label>
14 <CheckboxField name="loop" defaultValue={data.setting.loop} />
15 <Label name="controls">Controls</Label>
16 <CheckboxField name="controls" defaultValue={data.setting.controls} />
17 <Label name="volume">Volume</Label>
18 <RangeField name="volume" defaultValue={data.setting.volume} />
19 <Label name="playbackRate">1x</Label>
20 <RadioField
21 name="playbackRate"
22 defaultValue={data.setting.playbackRate}
23 value={1}
24 />
25 <Label name="playbackRate">1.5x</Label>
26 <RadioField
27 name="playbackRate"
28 defaultValue={data.setting.playbackRate}
29 value={1.5}
30 />
31 <Label name="playbackRate">2x</Label>
32 <RadioField
33 name="playbackRate"
34 defaultValue={data.setting.playbackRate}
35 value={2}
36 />
37 <Submit>Save</Submit>
38 </FormContainer>

Now you're able to give your users a custom video experience every time they come to your app! There's just one more thing we need to do before we can call this finished.

You need to know how to fetch these videos from Cloudinary.

Working with Cloudinary

The video that's currently displaying is being loaded from Cloudinary. The string that we've been using for the url value of the video player is how where this comes in. That string currently looks like this:

2 data.setting.videoName || 'elephant_herd'

This is the URL to a video hosted on Cloudinary, but you'll want it to point to your account. If you don't have an account, you can create a free one here. After you've registered, log in and you'll be taken to your Dashboard. You can find your cloud name here.

cloud name in the Cloudinary dashboard

The next thing you'll need to do is go to your Media Library and upload a few videos. The video names are what a user will be able to enter in the form we created.

videos in Cloudinary

In the url string, replace milecia with your cloud name and replace elephant_herd with the name of one of your videos. Now when you run your Redwood app, you'll see your own video!

Finished code

If you want to take a look at the front-end with this CodesandBox.

If you want the entire project, including the front-end and back-end, check out the custom-video-player folder in this repo!


Giving your users a good video experience will make them spend more time on your site and lead to fewer support issues. Plus it only takes a little extra time. Once the functionality is there, you just have to decide on how you want it to look.


Software Team Lead

Milecia is a senior software engineer, international tech speaker, and mad scientist that works with hardware and software. She will try to make anything with JavaScript first.