HTMLConverter

A modern WinUI 3 application for converting HTML files and ZIP archives containing HTML files to PDF documents.

✨ Features

• Multiple Input Formats: Support for individual HTML files, ZIP archives containing HTML files, and entire folders
• Drag & Drop: Simple drag-and-drop interface for easy file conversion
• Batch Processing: Convert multiple files at once
• Smart Scaling: Automatic or manual page scaling with orientation detection
• Modern UI: Built with WinUI 3 featuring an acrylic backdrop
• Automatic Archiving: Creates ZIP archives of converted PDFs

📋 Requirements

• Windows 10 version 19041 or higher
• .NET 8.0
• WebView2 Runtime (usually pre-installed on Windows 11)

🚀 Installation

Option 1: Use the MSIX Package

1. Navigate to the release section
2. Download the .msix or .msixbundle file
3. Double-click to install

Option 2: Build from Source

1. Clone this repository
2. Open HTMLConverter.sln in Visual Studio 2022 or later
3. Ensure you have the following workloads installed:
   • .NET Desktop Development
   • Universal Windows Platform development
4. Build and run the solution

💡 Usage

1. Launch the application
2. Choose one of three methods to add files:
   • Click "Select Files" to choose HTML or ZIP files
   • Click "Select Folder" to convert all HTML files in a folder
   • Drag and drop files or folders directly onto the application window
3. Select your preferred scaling (Auto/25%/50%/75%/100%) and orientation
4. The application will automatically convert files to PDF
5. Converted PDFs will be saved in a new folder with " PDFs" suffix
6. A ZIP archive of the PDFs will be created automatically

📂 Output Structure

• Single file/zip: Creates [filename] PDFs folder in the same directory
• Folder conversion: Creates [foldername] PDFs folder in the parent directory
• Multiple zips: Each creates its own output folder
• Each output folder is automatically zipped

📁 Project Structure

• MainWindow.xaml / MainWindow.xaml.cs: Main application window and conversion logic
• App.xaml / App.xaml.cs: Application initialization
• Package.appxmanifest: MSIX packaging configuration

🛠️ Technology Stack

• Framework: .NET 8.0 with WinUI 3
• UI: XAML with Acrylic backdrop
• PDF Rendering: WebView2 CoreWebView2.PrintToPdfAsync
• Platform: Windows App SDK

🎯 Roadmap

Future enhancements under consideration:

• Support for batch processing progress tracking
• Custom page margins configuration
• PDF metadata editing (title, author, etc.)
• Support for additional input formats
• Command-line interface for automation
• PDF merge functionality
• Watermark support

Have a feature idea? Open a feature request!

Project Structure

• MainWindow.xaml / MainWindow.xaml.cs: Main application window and conversion logic
• App.xaml / App.xaml.cs: Application initialization
• Package.appxmanifest: MSIX packaging configuration

📋 Documentation

• Contributing Guidelines
• Code of Conduct
• Security Policy
• Changelog

🤝 Contributing

Contributions are welcome! Please read our Contributing Guidelines before submitting pull requests.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📝 License

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

👨‍💻 Author

Brandon Temple

• GitHub: @bt1142msstate

🙏 Acknowledgments

• Built with WinUI 3 and Windows App SDK
• PDF conversion powered by Microsoft Edge WebView2

⭐ Support

If you find this project useful, please consider giving it a star on GitHub!

---

Built with ❤️ for easy HTML to PDF conversion on Windows.