# Subtitle Generator - Cloud Application with [AWS CDK](https://aws.amazon.com/cdk)

With this project, you can provision the infrastructure, backend, and frontend required for a subtitle generator with a [AWS CDK](https://aws.amazon.com/cdk).

## Demo
![demo](./assets/sample.gif)
![videos](./assets/videos.png)
![editor](./assets/editor.png)

## Serverless Architecture
![Architecture](./assets/architecture.png)

## Prerequisites
1. [AWS Account](https://aws.amazon.com/ko/resources/create-account/)
2. [A user with AdministratorAccess](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started_create-admin-group.html) to your account to provision AWS resources for you like S3 Bucket, ApiGateway, Cloudfront, DynamoDB, Cognito, ETC.
3. [Configuration and credential file settings](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html) - Please refer to the link to set the credentials on your computer.
4. [Install AWS Cloud Development Kit (CDK) v2](https://docs.aws.amazon.com/cdk/v2/guide/getting_started.html#getting_started_install)

## Quick Start
1. ```shell
   $ git clone https://github.com/aws-samples/subtitle-generator-cdk-app
   $ cd subtitle-generator-cdk-app
   $ npm install
   $ npm run build
   $ cdk bootstrap
   $ cdk deploy --all --outputs-file ./cdk-outputs.json --require-approval never
   ```
   <b>Please check for each stack provisioned through the terminal and type `y` to the question.</b><br>
   Through this task, provision the architecture shown in the figure above. It takes approximately 15-30 minutes.
2. After the entire stack is deployed, check the `cdk-outputs.json` file and access the `StaticWebDistributionUrl` in `StaticWebStack` through your browser.<br>
   (Ex: `"StaticWebDistributionUrl": "xxxxxxxxx.cloudfront.net"`)
3. And copy the entire contents of `cdk-outputs.json` to the clipboard. 
   ![cdk-outputs](./assets/1.png)
4. Paste the copied `cdk-outputs.json` into your browser and click the `Submit` button.
   ![Environment Setting](./assets/2.png)
5. It's done! Now, sign up with a valid email account and try creating and editing multilingual subtitle files(.srt, .vtt) for your videos.

## AWS Services and Pricing
* [Amazon Transcribe](https://aws.amazon.com/transcribe/pricing/)
* [Amazon Translate](https://aws.amazon.com/translate/pricing/)
* [Amazon S3](https://aws.amazon.com/s3/pricing/)
* [Amazon CloudFront](https://aws.amazon.com/cloudfront/pricing/)
* [Amazon Cognito](https://aws.amazon.com/cognito/pricing/)
* [Amazon API Gateway](https://aws.amazon.com/api-gateway/pricing/)
* [Amazon DynamoDB](https://aws.amazon.com/dynamodb/pricing/)
* [AWS Lambda](https://aws.amazon.com/lambda/pricing/)
* [AWS Step Functions](https://aws.amazon.com/step-functions/pricing/)

## Useful commands

 * `npm run build`   compile typescript to js
 * `npm run watch`   watch for changes and compile
 * `npm run test`    perform the jest unit tests
 * `cdk deploy`      deploy this stack to your default AWS account/region
 * `cdk diff`        compare deployed stack with current state
 * `cdk synth`       emits the synthesized CloudFormation template

## Clean-up
```shell
cdk destroy
```
If you don't need the subtitle generator anymore and want to remove all of its stack and resources, do this command.