BRANCH - Wiki Video Generator

Transform any Wikipedia topic into an engaging video with AI-generated narration and karaoke-style subtitles.

Features

• 🤖 AI-Powered Narration: High-quality text-to-speech with natural intonation
• 🎤 Karaoke Subtitles: Word-by-word highlighting that follows the narration
• ⚡ Lightning Fast: Generate professional videos in seconds
• 📱 Mobile Ready: Optimized for all devices and screen sizes
• 🔄 PWA Support: Install as a native app on mobile devices

Tech Stack

• Backend: Flask (Python)
• TTS: Kokoro TTS
• Video Processing: FFmpeg
• Frontend: HTML5, CSS3, Vanilla JavaScript
• Data Source: Wikipedia API

Quick Start

1. Install Dependencies

   pip install -r requirements.txt

2. Run the Application

   python app.py

3. Open in Browser Navigate to http://localhost:5000

Project Structure

branch/
├── app.py                 # Main Flask application
├── KokoroTTSApp.py       # TTS wrapper class
├── filters.py            # Video subtitle filters
├── templates/
│   └── index.html        # Main landing page
├── static/
│   ├── css/
│   │   └── style.css     # Main stylesheet
│   ├── js/
│   │   └── main.js       # Frontend JavaScript
│   ├── sw.js            # Service Worker
│   ├── manifest.json    # PWA manifest
│   └── robots.txt       # SEO robots file
└── README.md

Development

Frontend Features

• Responsive Design: Mobile-first approach with CSS Grid and Flexbox
• Modern UI: Clean, professional design with smooth animations
• Accessibility: WCAG compliant with keyboard navigation support
• Performance: Optimized loading with service worker caching
• PWA Ready: Installable as a native app

Backend Features

• RESTful API: Clean Flask routes for video generation
• Error Handling: Comprehensive error handling and user feedback
• File Management: Automatic cleanup of generated videos
• SEO Optimized: Meta tags, sitemap, and robots.txt

Production Deployment

Environment Variables

export FLASK_ENV=production
export FLASK_DEBUG=False

Recommended Hosting

• VPS: DigitalOcean, Linode, AWS EC2
• Platform: Heroku, Railway, Render
• CDN: Cloudflare for static assets

Performance Optimizations

• Enable gzip compression
• Use a CDN for static assets
• Implement Redis for caching
• Add database for user analytics

Browser Support

• Chrome 80+
• Firefox 75+
• Safari 13+
• Edge 80+

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

License

MIT License - see LICENSE file for details

Support

For issues and questions, please open a GitHub issue or contact the development team.

---

BRANCH - Making knowledge accessible through AI-powered video generation