⚠️ WARNING: This project is in aggressive active development.
A Flutter mobile application that converts images and Telegram sticker packs to WhatsApp sticker format with direct integration to WhatsApp.
- Upload individual image files (PNG, JPG, JPEG, GIF, WebP)
- Upload ZIP archives containing multiple images
- Process Telegram sticker pack URLs
- Automatic conversion to WhatsApp-compatible format
- Resizing to optimal dimensions (512x512px maximum)
- Individual sticker compression to under 100KB (WhatsApp requirement)
- Full support for both static and animated stickers
- Progressive download with real-time progress indicators
- WebM to WebP conversion for animated Telegram stickers
- Aggressive compression with quality reduction when needed
- Direct "Add to WhatsApp" functionality
- Automatic sticker pack validation
- Seamless integration with WhatsApp application
- Android 5.0 (API level 21) or higher
- WhatsApp installed on the device
- Minimum 100MB free storage space
- Flutter SDK 3.x or higher
- Dart SDK 3.x or higher
- Android Studio or VS Code
- Android SDK with API level 21+
- Download the APK from the releases section
- Enable installation from unknown sources in Android settings
- Install the APK file
- Launch the application
- Clone the repository
git clone https://github.com/MaheshSharan/Tel2WhatSticker
cd telegram_to_whatsapp_stickers- Install dependencies
flutter pub get- Run code generation
dart run build_runner build --delete-conflicting-outputs- Run the application
flutter run- Open the application
- Select "Upload Images" tab
- Choose image files or drag and drop them
- Configure pack name and publisher
- Tap "Create Sticker Pack"
- Tap "Add to WhatsApp" when processing is complete
- Select "Upload ZIP" tab
- Choose a ZIP file containing images
- The app will extract and validate images automatically
- Configure pack details and proceed as above
- Select "Telegram URL" tab
- Paste a Telegram sticker pack URL (t.me/addstickers/...)
- Watch real-time download progress for each sticker
- Animated stickers are automatically converted from WebM to WebP
- Enter pack name and publisher information
- Process and add to WhatsApp
- PNG (recommended)
- JPG/JPEG
- WebP
- GIF (converted to static)
- WebM (animated - converted to WebP)
- BMP
- WebP (WhatsApp standard)
- Automatic compression and resizing
- Tray image generation (96x96px PNG)
- Maximum 30 stickers per pack (WhatsApp limitation)
- Each individual sticker must be under 100KB (WhatsApp requirement)
- Full animated sticker support with WebM to WebP conversion
- ZIP files larger than 50MB may cause performance issues
- Very high resolution images may require aggressive compression
- Clean Architecture with BLoC pattern
- Repository pattern for data layer
- Dependency injection using GetIt
- State management with flutter_bloc
- flutter_bloc: State management
- image: Image processing
- archive: ZIP file handling
- file_picker: File selection
- path_provider: File system access
- whatsapp_stickers_handler: WhatsApp integration
- ffmpeg_kit_flutter: Animated sticker conversion
"WhatsApp not installed" error
- Ensure WhatsApp is installed and updated
- Check that WhatsApp supports sticker packs
Images not processing
- Verify image formats are supported
- Check that images are not corrupted
- Ensure sufficient storage space
ZIP extraction fails
- Verify ZIP file is not corrupted
- Check that ZIP contains supported image formats
- Ensure ZIP file size is reasonable
App crashes during processing
- Close other apps to free memory
- Try processing fewer images at once
- Restart the application
Sticker size compression issues
- App automatically compresses images to under 100KB per sticker
- Very high resolution images may require aggressive compression
- If compression fails, try using smaller source images
- Check console output for detailed compression information
- Fork the repository
- Create a feature branch
- Make your changes
- Run tests:
flutter test - Submit a pull request
- Follow Dart/Flutter style guidelines
- Use meaningful commit messages
- Add tests for new features
- Update documentation as needed
This project is licensed under the MIT License. See the LICENSE file for details.
For issues and questions:
- Create an issue on the GitHub repository
- Provide detailed information about the problem
- Include device information and error logs when applicable
- Full animated sticker support with WebM to WebP conversion
- Progressive Telegram sticker download with real-time progress indicators
- Unified upload flow for images and Telegram stickers
- Enhanced UI/UX with dynamic progress grid
- Removed legacy code and improved architecture
- 30-sticker selection limit enforcement
- Comprehensive error handling and debug logging
- Initial release
- Basic image upload and conversion
- WhatsApp integration
- ZIP file processing
- Telegram URL support