Skip to content

vicentefelipechile/yt-shortmaker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

78 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Release Rust Test GitHub License

YT ShortMaker 🎬

A robust, interactive CLI tool built in Rust to automate the creation of YouTube Shorts from long-form content. It features a full Terminal User Interface (TUI), persistent settings management, automatic session recovery, and leverages Google Gemini AI for intelligent content analysis.

✨ Features

  • πŸ–₯️ Interactive TUI: Full menu-based interface for easy navigation and control.
  • πŸ€– AI-Powered Analysis: Uses Google Gemini to identify the best, most engaging moments.
  • βš™οΈ In-App Configuration: Modify settings like output directory, usage, and cookies directly from the menu.
  • πŸ”„ Session Recovery: Automatically resumes interrupted sessions from where you left off.
  • 🎨 Smart Composition: Creates layered shorts with blurred backgrounds and customizable zoom/positioning.
  • πŸͺ Cookie Support: Integrated support for yt-dlp cookies to handle age-restricted or premium content.

πŸ“‹ Prerequisites

Before running this tool, ensure you have the following installed:

1. FFmpeg

# Windows (with Chocolatey) choco install ffmpeg # Or download from: https://ffmpeg.org/download.html

2. yt-dlp

# Windows (with pip) pip install yt-dlp # Or download from: https://github.com/yt-dlp/yt-dlp#installation # Also you can install directly from here V sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp sudo chmod a+rx /usr/local/bin/yt-dlp

3. Google Gemini API Key

You will need a Google Gemini API Key to use the AI analysis features.

  • Get one for free at Google AI Studio.
  • The application will securely prompt you for this key on the first run.

πŸš€ Installation

# Clone the repository git clone https://github.com/vicentefelipechile/yt-shortmaker.git cd yt-shortmaker # Build the project cargo build --release # Run the application cargo run --release

πŸ“– Usage

1. First Run Setup

On the first launch, if no API key is found, you will be prompted to enter your Google Gemini API Key. This is saved securely to your settings.

2. Main Menu

The application opens to a Main Menu with three options:

  • Comenzar (Start): Begin the video processing workflow.
  • Configuracion (Settings): Adjust application settings.
  • Salir (Exit): Close the application.

3. Workflow

  1. Select Start.
  2. Enter URL: Paste the YouTube link you want to process.
  3. Analysis: The tool downloads and analyzes the video using AI.
  4. Review: Moments are detected and categorized.
  5. Processing: The app generates high-quality vertical shorts with your configured styling.

4. Settings

You can customize the following directly in the app:

  • Output Directory: Where files are saved.
  • Auto Extract: Automatically generate shorts after analysis.
  • Shorts Style: Adjust background opacity and main video zoom.
  • Cookies: Path to your cookies file.

πŸ“ Output Structure

output/ β”œβ”€β”€ moments.json # Raw JSON of identified moments β”œβ”€β”€ moments.txt # Human-readable list └── shorts/ β”œβ”€β”€ short_1_funny.mp4 β”œβ”€β”€ short_2_interesting.mp4 └── ... 

βš™οΈ Configuration File

Settings are stored in settings.json. While you can edit this file manually, it's recommended to use the Configuracion menu in the app.

🎯 Moment Categories

The AI identifies moments in these categories:

  • Funny: Humorous or comedic moments
  • Interesting: Educational or thought-provoking content
  • Incredible Play: Amazing gameplay or skillful moments
  • Cinematic: Cinematic scene in game
  • Other: Notable moments that don't fit above categories

πŸ› οΈ Development

# Run in development mode cargo run # Run tests cargo test

πŸ“„ License

MIT License - feel free to use and modify as needed.

🀝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

About

Transform your videos into viral YouTube Shorts with this lightning-fast Rust automation tool

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

 

Contributors