Skip to content


Repository files navigation


A Spring application that allows users to upload files and store them in an S3 bucket. These files can be turned into HLS streams using an AWS Elastic Transcoder pipeline

To see a running version visit

Running Application

Note: Make sure you have a databse running before starting

To run the application, you must first rename the src/main/resources/ to src/main/resources/ You have to provide database credentials as well as Iam access key/secret for AWS s3 Bucket. After the properties has been configured, run gradlew.bat bootrun on windows or ./gradlew bootrun on a nix system. The application will run on localhost:8080

run with Docker

If you're into that kind of stuff, you can run this application using docker and [docker-compose] 5. After you've configured your properties, run ./gradlew build. Next, move the build file into the docker folder:

cp ./build/libs/clippr-0.1.0.jar src/main/docker/

there is already a docker-compose file included in this repository. Simply run

docker-compose up --build optional -d to run in background

to run the application. If you're using docker-machine, the application is running on machine's-ip:8080, else it's on localhost:8080.


Before a user uploads, they must be authenticated. There is a registration page that handles basic registration using the database to store the users. After uploading a valid file(.mp4 only and less than 150mb), the file is then uploaded to the specified S3 bucket. The file is also kept in a local volume called uploads.

After the file is uploaded to S3, it then becomes available at{bucket}/{filename}.

In the running demo version, all files are uploaded to They can then be streamed via HLS on mobile or web at{filename}.m3u8.


The API is very limited; at this point there are two endpoints /api/videos and /api/users. Both return a list of POJOs in JSON format.


  • Add Swagger2 Documentation
  • Add Automatic Elastic Transcoding of files


No releases published


No packages published