Skip to main content

🎥✂️🔗 Video downloader, trimmer, and merger using the terminal. Supports YouTube, Facebook, Reddit, Twitter, TikTok, Instagram, LinkedIn, 9GAG, etc. Downloads/trims at multiple points. Merges multiple clips.

Project description

🎥✂️🔗 lord-of-the-clips (lotc)

Video downloader, trimmer, and merger using the terminal. Supports YouTube, Facebook, Reddit, Twitter, TikTok, Instagram, LinkedIn, 9GAG, etc. Downloads/trims at multiple points. Merges multiple clips.

💫 Background

As per the Pareto Principle, a video usually has its best parts. Hence, Reels/Shorts/Stories are popular nowadays. Likewise, I frequently download videos from various sites (e.g. YouTube, Facebook, Reddit, etc) using various online video downloaders, then I clip the most interesting/best parts only which are usually posted in social media sites or shared on private/group chats.

Got tired of these routines eventually, and I want a tool that given a URL and timestamps/durations will download the video AND auto-clip them at the desired segments in a single command AND it should support multiple sites. This is the missing tool that I wanted. In the simplest case, this lotc CLI app will download the full video.

⚡Features

  • downloads a video and auto-trims/clips the specified durations
  • trims a saved video file and/or clips the specified durations
  • merges saved video files, usually for concatenating related clips
  • provides smart output file name by default
  • accepts a custom output file name
  • leverages CLI styling for better experience

🦾 Standing on the Shoulders of Giants

🔨 Installation

pip install lord-of-the-clips

This will install a global lotc shell command which you could run in the terminal. lotc is the acronym for lord-of-the-clips.

🔧 Dependencies

ffmpeg is strongly recommended by yt-dlp to be installed since some websites have split video/audio files:

  • Mac: brew install ffmpeg
  • Ubuntu: sudo apt install ffmpeg
  • Others

⚙️ Usage

For further details/sample usages, run this command:

lotc --help

And for its subcommands:

lotc download --help
lotc trim --help
lotc merge --help

🚀 Demo

The GIF below demonstrates the output of lotc --help command and its lotc download --help subcommand, and running an example provided in the output: See https://github.com/ranelpadon/lord-of-the-clips#-demo

⚠️ Rate Limits

Some sites (e.g. Facebook) imposes scraping rate limits on their pages and could cause issues in your succeeding downloads. Hence, throttle your usage or don't use lotc excessively in a short amount of time.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

lord-of-the-clips-0.1.11.tar.gz (11.7 MB view details)

Uploaded Source

Built Distribution

lord_of_the_clips-0.1.11-py3-none-any.whl (11.3 kB view details)

Uploaded Python 3

File details

Details for the file lord-of-the-clips-0.1.11.tar.gz.

File metadata

  • Download URL: lord-of-the-clips-0.1.11.tar.gz
  • Upload date:
  • Size: 11.7 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.0

File hashes

Hashes for lord-of-the-clips-0.1.11.tar.gz
Algorithm Hash digest
SHA256 d3059a46888572d2b7e709f9dc8a893669d2b57fd28add8653d3d11d159a68ac
MD5 9c1b2195d93a8aa9a7b933841d6d54ea
BLAKE2b-256 0123c438a0cb49b15a2b419152799560eb8ebd272224f7cba58b6a76af51772c

See more details on using hashes here.

File details

Details for the file lord_of_the_clips-0.1.11-py3-none-any.whl.

File metadata

File hashes

Hashes for lord_of_the_clips-0.1.11-py3-none-any.whl
Algorithm Hash digest
SHA256 53b3332279a7b9aeee6c7751645cf884fadb76d47551dff38dcbc7c9af4d3d9d
MD5 aa4ff639506930db39bc7b49d30a3dd0
BLAKE2b-256 d4a2d034a3101a9bd11ed669f388c77e1faffa5e3bdf4c89c7b3d5cc725c6672

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page