Lume Browser

Lume Browser is a lightweight, open-source web browser built using JavaFX. It is designed to explore HTTP protocols and client-server architecture, allowing developers to experiment and understand browser networking.

---

🚀 Features

• 🌐 Custom HTTP Client - Connects directly to web servers without relying on built-in engines.
• 🖥️ Minimal UI - Clean and straightforward user interface.
• 🔄 Automatic Redirection Handling - Detects and follows HTTP 3xx redirects.
• 📂 File-Based Response Logging - Saves HTTP responses for analysis.
• 🏗️ Modular Codebase - Easily extendable for custom experiments.

---

📸 Screenshots

Main Interface

About Window Interface

Note

Ensure you have JavaFX installed for a smooth experience.

---

⚙️ Installation

🔹 Prerequisites

• Java 22 or later
• JavaFX SDK
• IntelliJ IDEA (recommended)

🛠️ Setup

1. Clone the repository:

   git clone https://github.com/vimukthijayasanka/lume-web-browser
   cd lume-browser

2. Open the project in IntelliJ IDEA.
3. Ensure JavaFX dependencies are configured.
4. Run AppInitializer.java to start the browser.

---

🚨 Warnings & Limitations

Warning

⚠️ Lume Browser does not support JavaScript rendering.

⚠️ This project is for educational and experimental use only. Do not use it for security-sensitive applications.

⚠️ May not fully support modern HTTPS websites due to manual HTTP request handling.

---

🏷️ Version

1.0.0

---

📜 License

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

---

🤝 Contributing

Want to improve Lume Browser? Contributions are welcome!

1. Fork the repo
2. Create a new branch (git checkout -b feature-new)
3. Commit your changes (git commit -m 'Added a cool feature')
4. Push to the branch (git push origin feature-new)
5. Open a Pull Request

---

🌟 Support

If you like this project, leave a ⭐ on GitHub!

---

🔗 Useful Links

• JavaFX Documentation
• HTTP Status Codes

Happy coding! 🚀