EchoGen.ai

🎙️ EchoGen.ai

**Transform any content into engaging AI-powered podcasts** [![Build and Release](https://github.com/Mr-Dark-debug/EchoGen.ai/actions/workflows/release.yml/badge.svg)](https://github.com/Mr-Dark-debug/EchoGen.ai/actions/workflows/release.yml) [![Flutter](https://img.shields.io/badge/Flutter-3.24+-02569B?style=flat&logo=flutter&logoColor=white)](https://flutter.dev) [![Dart](https://img.shields.io/badge/Dart-3.0+-0175C2?style=flat&logo=dart&logoColor=white)](https://dart.dev) [![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE) [![GitHub Stars](https://img.shields.io/github/stars/Mr-Dark-debug/EchoGen.ai?style=social)](https://github.com/Mr-Dark-debug/EchoGen.ai/stargazers) [![GitHub Release](https://img.shields.io/github/v/release/Mr-Dark-debug/EchoGen.ai?style=flat&logo=github)](https://github.com/Mr-Dark-debug/EchoGen.ai/releases/latest) [🚀 Features](#-features) • [📱 Screenshots](#-screenshots) • [🛠️ Installation](#️-installation) • [🔧 Configuration](#-configuration) • [🌐 Landing Page](#-landing-page) • [🤝 Contributing](#-contributing)

📖 About

EchoGen.ai is a powerful, open-source Flutter application that transforms any web content or text into engaging, multi-speaker AI-generated podcasts. Whether you’re a content creator, educator, or just someone who loves podcasts, EchoGen.ai makes it easy to convert articles, blog posts, or custom scripts into professional-quality audio content.

🌟 Why EchoGen.ai v0.2.0?

🎵 Background Audio Playback: Full background audio with notification controls and mini player
🎨 AI Cover Art Generation: Create stunning cover art using ImageRouter AI
📝 Smart Script Chunking: Handle long scripts with intelligent chunking to avoid timeouts
🔑 Centralized API Management: Secure management of all API keys in one location
🎯 Enhanced Content Processing: Convert any URL or text with improved error handling
🤖 Multiple AI Providers: Gemini, OpenAI, ElevenLabs, and ImageRouter support
🎭 Multi-Speaker Conversations: Natural conversations between AI speakers
🎨 Modern UI/UX: Improved loading messages, better error handling, dark/light themes
📱 Cross-Platform: Works on Android, iOS, and desktop
🆓 Open Source: Completely free and open for contributions

✨ Features

🆕 New in v0.2.0

🎵 Background Audio Playback: Full background audio service with notification controls
🎮 Mini Player: Floating mini player with spinning logo animation across all screens
🎨 AI Cover Art Generation: Generate custom cover art using ImageRouter AI
📝 Smart Script Chunking: Intelligent script splitting to handle long content without timeouts
🔑 Centralized API Key Management: Secure management of all API keys in Settings
🎯 Enhanced Loading Experience: Improved loading messages and progress tracking
🔧 Better Error Handling: More helpful error messages and recovery options
🎨 UI/UX Improvements: Redesigned library cards, better navigation, and visual enhancements

🌐 Content Scraping

Web Scraping: Extract content from any URL using Firecrawl or HyperbrowserAI
Smart Parsing: Automatically extracts main content and metadata
Multiple Formats: Support for articles, blogs, news, and documentation
Batch Processing: Scrape multiple URLs simultaneously

🤖 AI-Powered Script Generation

Multiple Providers: Support for Gemini, OpenAI, Groq, and OpenRouter
Podcast Categories: Choose from various styles (Educational, Entertainment, News, etc.)
Custom Speakers: Personalize speaker names and characteristics
Smart Formatting: Automatically formats content for natural conversation

🎙️ Text-to-Speech Generation

30+ Voices: Access to Google’s premium TTS voices
Multi-Speaker: Realistic conversations between different speakers
Emotion Guidance: Advanced tone control for natural-sounding dialogue
Speed Control: Variable playback speeds (0.25x to 2.0x)

🖼️ AI-Powered Cover Art Generation ✨ NEW in v0.2.0

ImageRouter Integration: Generate custom podcast cover art using AI
Multiple AI Models: Support for DALL-E 3, Stable Diffusion XL, Midjourney
Quality Options: Choose from auto, low, medium, and high quality
Size Options: Multiple aspect ratios for different platforms
Local Storage: Generated covers saved locally for offline access

🎨 Enhanced Player Experience ✨ NEW in v0.2.0

Spinning Logo Animation: Visual feedback during playback
Transcript Slide View: Swipe to access full transcript with mini player
Horizontal Speed Control: Expanded speed options with visual selection
Improved Controls: Enhanced forward/backward buttons with better visibility
Page Navigation: Seamless swipe navigation between player and transcript
High Quality: Professional-grade audio output
Custom Settings: Adjust speed, tone, and speaking style

📚 Content Management

Library System: Organize scraped URLs, scripts, and generated podcasts
Search & Filter: Easily find your content
Export Options: Share podcasts or scripts
Local Storage: Everything saved securely on your device

🎨 User Experience

Modern UI: Beautiful, intuitive interface
Dark/Light Themes: Comfortable viewing in any environment
Responsive Design: Optimized for all screen sizes
Smooth Animations: Polished interactions and transitions

📱 Screenshots

🛠️ Installation

Prerequisites

Flutter SDK: 3.7.0 or higher
Dart SDK: 3.0 or higher
Android Studio or VS Code with Flutter extensions
Android SDK (for Android development)
Xcode (for iOS development, macOS only)

Quick Start

Clone the repository

git clone https://github.com/Mr-Dark-debug/EchoGen.ai.git
cd EchoGen.ai

Install dependencies
```
flutter pub get
```
Run the app
```
flutter run
```

Building for Production

🤖 Automated Releases (Recommended)

EchoGen.ai uses GitHub Actions for automated building and releasing. Every push to main triggers automated builds:

Automatic Builds: Android APK, AAB, and iOS archives
Version Management: Automatic version detection from pubspec.yaml
Release Creation: Automated GitHub releases with downloadable assets
Quality Assurance: Automated testing and analysis

🔨 Manual Release Builds

Android APK (Universal)

flutter build apk --release
# Output: build/app/outputs/flutter-apk/app-release.apk

Android App Bundle (Google Play Store)

flutter build appbundle --release
# Output: build/app/outputs/bundle/release/app-release.aab

iOS (Requires macOS)

flutter build ios --release
# For App Store distribution, use Xcode to archive and upload

Web (Progressive Web App)

flutter build web --release
# Output: build/web/

Windows (Requires Windows)

flutter build windows --release
# Output: build/windows/runner/Release/

macOS (Requires macOS)

flutter build macos --release
# Output: build/macos/Build/Products/Release/

Linux (Requires Linux)

flutter build linux --release
# Output: build/linux/x64/release/bundle/

🤖 Automated Releases

EchoGen.ai uses GitHub Actions for automated building and releasing:

Automatic Builds: Every push to main triggers automated builds for Android and iOS
Version Management: Use the version bump workflow to automatically increment versions
Release Creation: Releases are automatically created with APK, AAB, and IPA files
Quality Assurance: All builds go through automated testing before release

Download Latest Release

Visit our Releases page to download:

Android APK: Direct installation file
Android AAB: Google Play Store format
iOS IPA: For sideloading on iOS devices

🔧 Configuration

API Keys Setup

EchoGen.ai requires API keys for various services. Configure them in the app’s settings:

Required APIs

Google Gemini: For AI text generation and TTS
- Get your key: Google AI Studio
- Format: AIza...

Optional APIs

OpenAI: Alternative AI provider and TTS
- Get your key: OpenAI Platform
- Format: sk-...
ElevenLabs: Premium TTS provider
- Get your key: ElevenLabs
- Format: Various formats supported
ImageRouter: AI cover art generation
- Get your key: ImageRouter
- Format: Various formats supported (no specific prefix required)
Groq: Fast inference provider
- Get your key: Groq Console
- Format: gsk_...
Firecrawl: Web scraping service
- Get your key: Firecrawl
- Format: fc-...
HyperbrowserAI: Alternative web scraping
- Get your key: HyperbrowserAI
- Format: Various formats supported

Environment Setup

Open the app and navigate to Settings → API Keys
Enter your API keys for the services you want to use
Test the configuration by generating a sample podcast

Permissions

The app requires the following permissions:

Storage: To save podcasts and manage downloads
Internet: To access AI APIs and scrape content
Network State: To check connectivity

🌐 Landing Page

EchoGen.ai features a beautiful landing page hosted on GitHub Pages that showcases the app’s features and provides download links.

🔗 Live Demo

Visit the landing page: https://mr-dark-debug.github.io/EchoGen.ai/

🛠️ GitHub Pages Setup

The landing page is automatically deployed to GitHub Pages from the docs/ folder:

Source File: landing.html (main project directory)
Deployed As: docs/index.html (GitHub Pages source)
Live URL: https://[username].github.io/[repository-name]/

Setting Up GitHub Pages

Repository Settings:
- Go to your repository on GitHub
- Navigate to Settings → Pages
- Under Source, select Deploy from a branch
- Choose main branch and / (root) folder
- Save the settings
Automatic Deployment:
- Any changes to docs/index.html will automatically deploy
- GitHub Actions can be configured for advanced deployment workflows
- The site typically updates within 5-10 minutes

Landing Page Features

Responsive Design: Works perfectly on desktop, tablet, and mobile
Modern UI: Clean, professional design with smooth animations
Feature Showcase: Highlights all major app features
Direct Downloads: Links to latest GitHub releases
Social Links: GitHub, Product Hunt, and other social platforms
Fast Loading: Optimized images and minimal dependencies

Customizing the Landing Page

Edit Content: Modify landing.html in the project root
Update Assets: Replace images in lib/assets/ (uses GitHub raw URLs)
Deploy Changes: Copy updated landing.html to docs/index.html
Test Locally: Open landing.html in a browser before deploying

# Quick deployment command
cp landing.html docs/index.html
git add docs/index.html
git commit -m "Update landing page"
git push origin main

📊 SEO & Performance

The landing page includes:

SEO Optimized: Meta tags, structured data, and semantic HTML
Performance: Lightweight design with fast loading times
Accessibility: WCAG guidelines compliance
Mobile First: Responsive design for all devices

🎯 Usage

Creating Your First Podcast

Choose Input Method:
- From URL: Paste any article or blog URL
- From Text: Write or paste your own content
Configure Settings:
- Select AI provider (Gemini recommended)
- Choose podcast category and style
- Set speaker names and voices
Generate Script:
- AI converts your content into a natural conversation
- Review and edit the generated script
Create Audio:
- Generate high-quality TTS audio
- Listen to your podcast in the built-in player
Manage Content:
- Access all your content in the Library
- Share, download, or delete podcasts

Pro Tips

Use descriptive speaker names for better context
Choose appropriate categories for better script generation
Review scripts before generating audio to ensure quality
Experiment with different AI providers for varied results

🏗️ Architecture

EchoGen.ai follows a clean, modular architecture:

lib/
├── constants/          # App-wide constants and themes
├── models/            # Data models and entities
├── screens/           # UI screens and pages
├── services/          # Business logic and API services
├── widgets/           # Reusable UI components
└── main.dart         # App entry point

Key Components

AI Service: Handles communication with various AI providers
TTS Service: Manages text-to-speech generation
Storage Service: Local data persistence
Web Scraping Service: Content extraction from URLs
Theme Provider: Dark/light theme management

🤝 Contributing

We welcome contributions from the community! Here’s how you can help:

Ways to Contribute

🐛 Report Bugs: Found an issue? Let us know!
💡 Suggest Features: Have ideas for improvements?
🔧 Submit PRs: Fix bugs or add new features
📖 Improve Docs: Help make our documentation better
🌍 Translations: Help localize the app

Development Setup

Fork the repository
Create a feature branch: git checkout -b feature/amazing-feature
Make your changes and test thoroughly
Commit your changes: git commit -m 'Add amazing feature'
Push to the branch: git push origin feature/amazing-feature
Open a Pull Request

Code Style

Follow Dart style guidelines
Use meaningful variable and function names
Add comments for complex logic
Write tests for new features

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

Flutter Team: For the amazing framework
Google AI: For Gemini API and TTS services
OpenAI: For GPT models and APIs
Community: For feedback, contributions, and support

🚀 Roadmap

Upcoming Features

🌍 Multi-language Support: Generate podcasts in multiple languages
🎵 Background Music: Add ambient music to podcasts
📊 Analytics: Track podcast performance and engagement
☁️ Cloud Sync: Optional cloud backup for your content
🎨 Custom Themes: More theme options and customization
🔊 Voice Cloning: Clone your own voice for personalized podcasts
📱 Mobile Widgets: Quick access widgets for mobile devices
🎬 Video Podcasts: Generate video content with AI avatars

Version History

v0.1.0: Initial release with core features
v0.2.0: Background audio playback, AI cover art generation, smart script chunking, centralized API management, enhanced UI/UX