<div align="center">
  <img src="public/featureGraphic.png" width="100%" alt="mpvExtended Banner" />

**The Most Powerful, Material3-Powered Video Experience for Android**

[![GitHub release](https://img.shields.io/github/v/release/marlboro-advance/mpvEx?style=for-the-badge&logo=github&color=7C3AED)](https://github.com/marlboro-advance/mpvEx/releases/latest)
[![Downloads](https://img.shields.io/github/downloads/marlboro-advance/mpvEx/total?style=for-the-badge&logo=github&color=3B82F6)](https://github.com/marlboro-advance/mpvEx/releases/latest)
[![Stars](https://img.shields.io/github/stars/marlboro-advance/mpvEx?style=for-the-badge&logo=github&color=F59E0B)](https://github.com/marlboro-advance/mpvEx/stargazers)
[![License](https://img.shields.io/badge/License-Apache%202.0-green?style=for-the-badge)](LICENSE)

</div>

---

## 🚀 Installation

### Stable Builds

Get the latest stable release directly from GitHub or the IzzyOnDroid repository.

| Source              | Link                                                                                                                                                              |
| :------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **GitHub Releases** | [![Download](https://img.shields.io/badge/Download-Latest%20APK-7C3AED?style=flat-square&logo=github)](https://github.com/marlboro-advance/mpvEx/releases/latest) |
| **IzzyOnDroid**     | [![IzzyOnDroid](https://img.shields.io/badge/Get%20it%20on-IzzyOnDroid-blue?style=flat-square)](https://apt.izzysoft.de/packages/app.marlboroadvance.mpvex)       |

### Preview Builds

Want to try the cutting-edge features? Download the preview builds (Testing only).
[![Preview](https://img.shields.io/badge/Download-Preview%20Builds-red?style=for-the-badge)](https://marlboro-advance.github.io/mpvEx/)

---

## 🌐 mpvEx Web

This is the official Next.js website for **mpvExtended** - a powerful Android video player built on mpv. The website showcases features, provides downloads, and serves as the project's online presence.

### 🚀 Quick Start

```bash
# Development
pnpm dev           # Start dev server
pnpm dev:debug     # Start with debugging

# Dependencies Chart
pnpm analyze       # Analyze dependencies

# Building
pnpm build         # Build for production
pnpm start         # Start production server
pnpm start:prod    # Start on port 3000

# Code Quality
pnpm lint          # Run linter
pnpm lint:fix      # Auto-fix lint issues
pnpm format        # Format code
pnpm type-check    # TypeScript checking

# Maintenance
pnpm clean         # Clean build artifacts
pnpm reinstall     # Full reinstall

```

## 📦 Project Structure

- Framework: Next.js 16.1.5 with React 19.2.4
- Styling: Tailwind CSS 4.1.18 with Material Design
- Language: TypeScript
- Linting: Biome for formatting and linting
- Icons: Lucide React & custom icons


## 🎯 Features

- Modern Stack: Built with Next.js 16, React 19, and TypeScript
- Responsive Design: Tailwind CSS with Material Design principles
- Performance Optimized: Automated code splitting and optimization
- Type Safe: Full TypeScript coverage with strict type checking
- Code Quality: Biome for consistent code formatting and linting

---

## 🤝 Acknowledgments

We stand on the shoulders of giants:

- [mpv-android](https://github.com/mpv-android) - The foundation.
- [mpvKt](https://github.com/abdallahmehiz/mpvKt) & [Next player](https://github.com/anilbeesetti/nextplayer) - Inspiration.
- [Gramophone](https://github.com/FoedusProgramme/Gramophone) - UI paradigms.

---

## ❤️ Support & Community

If you love mpvExtended, consider supporting the development and starring the repo!

**Website Created with ❤️ by [Riteshp2001](https://github.com/Riteshp2001)**
