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 is usually posted in social media sites or shared in 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 one of the examples provided in the output: See https://github.com/ranelpadon/lord-of-the-clips/blob/main/demo.gif

⚠️ 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.9.tar.gz (11.7 MB view details)

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

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

File metadata

  • Download URL: lord-of-the-clips-0.1.9.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.9.tar.gz
Algorithm Hash digest
SHA256 64495aa34b53693e30a3b9f7e81c223c8bdf1a9179f62686381917d4f0581c6c
MD5 949cc158a5f5029dba0163b83f0a32a3
BLAKE2b-256 28e236575b16fa24248d03ffed80b876349d1a94243a64fe3ecbe08c5817a119

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for lord_of_the_clips-0.1.9-py3-none-any.whl
Algorithm Hash digest
SHA256 6393531af2e114019370893cd1f079074112d70b3631f4e710354095c2c3f9a0
MD5 14ddca7bdcbbc8eda29c7f521ae9941d
BLAKE2b-256 8c3f9fd53ab179064f5d2f611b7c81c7ba0ad9b66f8e9018b6bde1ed77d35f14

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