https://github.com/shotstack/mp4-to-mov-demo
A demo project showing how to convert an MP4 video to MOV format using the Shotstack Ingest API.
https://github.com/shotstack/mp4-to-mov-demo
converter mp4-converter quicktime-codec transcoding video video-processing video-transcoding video-transformer
Last synced: 22 days ago
JSON representation
A demo project showing how to convert an MP4 video to MOV format using the Shotstack Ingest API.
- Host: GitHub
- URL: https://github.com/shotstack/mp4-to-mov-demo
- Owner: shotstack
- License: mit
- Created: 2023-11-13T09:23:29.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-08-18T16:23:15.000Z (6 months ago)
- Last Synced: 2025-08-18T18:24:26.125Z (6 months ago)
- Topics: converter, mp4-converter, quicktime-codec, transcoding, video, video-processing, video-transcoding, video-transformer
- Language: JavaScript
- Homepage: https://shotstack.io/demo/mp4-to-mov/
- Size: 135 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Shotstack MP4 to MOV Demo
This sample application shows how you can use the Shotstack Ingest API to [convert MP4 videos to
MOV](https://shotstack.io/demo/mp4-to-mov/) format. The Ingest API is a [video transformation
API](https://shotstack.io/product/ingest-api/) that lets you upload, store, and convert videos and images into different
formats, sizes, frame rates, speeds, and more.
Using an HTML web form, users can upload a video or put in a URL of an MP4 video online. After submitting the form, the
video is converted from MP4 to MOV. The new file can be played in the browser or downloaded.
View the live demo at: https://shotstack.io/demo/mp4-to-mov/
The demo is made with Node.js and works with the Express Framework or as a serverless project using AWS Lambda and API
Gateway.
### Requirements
- Node 16+
- Shotstack API key: https://dashboard.shotstack.io/register
### Project Structure
The project is divided in to a two components:
#### Backend API
The backend API has an endpoint that receives the video file URL. The parameters are prepared in the [JSON
format](https://shotstack.io/docs/api/#tocs_source) the Ingest API expects and sent to the API. A status endpoint is
called to check the progress of the transformation. When the mov file is ready the status is updated and the file URL of
the mov file is returned.
The backend API source code is in the **api** directory.
#### Frontend Web Form & Player
The frontend uses Bootstrap and basic HTML to set up a form that allows the user to upload a video file or enter a file
URL. jQuery is used for the interactive components of the application and to submit the data to the backend API and poll
the status. There is also a video player that plays the final mov file video file when ready.
The front end API source code is in the **web** directory.
### Installation
Install node module dependencies:
```bash
cd api
npm install
```
### Configuration
Copy the .env.dist file and rename it .env:
```
cp .env.dist .env
```
Replace the environment variables below with your Shotstack API key (stage key) and a writable S3 bucket name:
```bash
SHOTSTACK_API_KEY=replace_with_your_shotstack_key
SHOTSTACK_HOST=https://api.shotstack.io/ingest/stage/
AWS_S3_UPLOADS_BUCKET=replace_with_an_s3_bucket_name
```
### Run Locally
To start the API and serve the front end form (from the **api** directory):
```bash
npm run start
```
Then visit [http://localhost:3000](http://localhost:3000)
### Deploy Serverless Application (optional)
The project has been built as a serverless application using the Serverless Framework and AWS Lambda. To understand more
about the Serverless Framework and how to set everything up consult the documentation:
https://serverless.com/framework/docs/providers/aws/
To deploy to AWS Lambda (from the **api** directory):
```bash
npm run deploy
```
Once the API is deployed set the `var apiEndpoint` variable in **web/app.js** to the returned API Gateway URL.
Run the **web/index.html** file locally or use AWS S3 static hosting to serve the web page.