/quick-clip

Quick Clip generates FFMPEG CLI commands from a drag-and-drop UI, so you can easily crop, trim, and transcode video clips.

Primary LanguageTypeScriptMIT LicenseMIT

Contributors Forks Stargazers Issues MIT License


Quick Clip

Quick Clip generates FFMPEG CLI commands from a drag-and-drop UI, so you can easily crop, trim, and transcode video clips.
Start using Quick Clip »

Report Bug · Request Feature

Table of Contents
  1. About The Project
  2. Usage
  3. Local Development
  4. Roadmap
  5. Contributing
  6. License
  7. Contact
  8. Acknowledgments

About The Project

Quick Clip was designed in an effort to make taking quick clips of the projects you're working on easy. Use Quick Clip's drag-and-drop UI to quickly generate FFMPEG CLI commands to export your clips to mp4s or gifs.

(back to top)

Built With

(back to top)

Usage

  1. Drag a video into the window.
  2. Crop and trim your video.
  3. Choose an export option to copy an FFMPEG command to your clipboard.
  4. Open a command prompt like PowerShell or xTerm and navigate to the directory your source file is located.
  5. Paste the command into the command prompt and press return.

Your clip will be exported into the same directory as the source video as either clip.mp4 or clip.gif, depending on your selected format.

Please note that FFMPEG must be installed on your system for these commands to work. Please see this link for more information on how to install FFMPEG.

(back to top)

Local Development

To run Quick Clip locally, follow these steps:

Prerequisites

  • NodeJS version 15.0 or higher

Installation

  1. Clone the repo 
    git clone git@github.com:twocatmoon/quick-clip.git
  2. Install NPM packages 
    npm install
  3. Run the app 
    npm run dev

(back to top)

Roadmap

  • Resize crop area with horizontal and vertical handles
  • Better labeling and UX for trim/seek UI
  • Dedicated FFMPEG server to cut out the need to run the commands locally

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(back to top)

License

Distributed under the MIT License. See LICENSE for more information.

(back to top)

Contact

Twitter - @twocatmoon

Project Link - https://github.com/twocatmoon/quick-clip

(back to top)

Acknowledgments

(back to top)