https://github.com/fralapo/ai_video_title_generator
A powerful Python tool that automates the generation of SEO-optimized titles for social media videos using AI. This tool processes video clips by transcribing their audio content and generating engaging titles with relevant hashtags.
https://github.com/fralapo/ai_video_title_generator
Last synced: 3 months ago
JSON representation
A powerful Python tool that automates the generation of SEO-optimized titles for social media videos using AI. This tool processes video clips by transcribing their audio content and generating engaging titles with relevant hashtags.
- Host: GitHub
- URL: https://github.com/fralapo/ai_video_title_generator
- Owner: fralapo
- License: mit
- Created: 2024-10-29T18:32:35.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2024-10-29T18:37:30.000Z (7 months ago)
- Last Synced: 2024-10-29T20:38:04.443Z (7 months ago)
- Language: Python
- Size: 25.4 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Video Title Generator
A powerful Python tool that automates the generation of SEO-optimized titles for social media videos using AI. This tool processes video clips by transcribing their audio content and generating engaging titles with relevant hashtags.
## Features
- 🎥 Process single videos or entire folders
- 🗣️ Automatic audio transcription using OpenAI Whisper
- 🤖 AI-powered title generation with multiple model options
- 🌐 Multi-language support
- #️⃣ Automatic hashtag generation and optimization
- 📏 Smart title length optimization for YouTube video (max 100 characters)
- 🔄 Batch processing capabilities
## Prerequisites
- Python 3.8 or higher
- OpenAI API key
- OpenRouter API key
- FFmpeg (for audio processing)
## Installation
1. Clone the repository:
```bash
git clone https://github.com/yourusername/video-title-generator.git
cd video-title-generator
```
2. Install required packages:
```bash
pip install -r requirements.txt
```
3. Create a `.env` file in the project root and add your API keys:
```
OPENAI_API_KEY=your_openai_api_key_here
OPENROUTER_API_KEY=your_openrouter_api_key_here
```
## Usage
1. Run the main script:
```bash
python main.py
```
2. Select your preferred language (English or Italian)
3. Choose processing mode:
- Single video processing
- Folder batch processing
### Single Video Processing
```bash
1. Enter the video file path
2. Provide context description
3. Review generated title
4. Confirm to rename the file
```
### Batch Processing
```bash
1. Enter the folder path containing videos
2. Choose between:
- Single context for all videos
- Individual context for each video
3. Review generated titles
4. Confirm to rename all files
```
## Project Structure
```
video-title-generator/
├── languages/ # Language files
├── prompts/ # AI prompt templates
├── audio_handler.py # Audio processing
├── file_handler.py # File operations
├── language_manager.py # Language management
├── models.py # AI model selection
├── prompt_handler.py # Title generation
└── main.py # Main script
```
## Adding New Languages
1. Create a new language file in `languages/` (e.g., `fr.json`)
2. Add corresponding prompt template in `prompts/` (e.g., `title_generation_prompt_fr.txt`)
3. The system will automatically detect and include the new language
## Contributing
Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct and the process for submitting pull requests.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Acknowledgments
- OpenAI for Whisper API
- OpenRouter for AI model access
- MoviePy for video processing
## Author
Jacopo Luca Maria Latrofa
- GitHub: [@fralapo](https://github.com/fralapo)