XiaomiUT 🚀

[English] | 简体中文

XiaomiUT is a website made to help users find and download official Xiaomi firmware directly from official mirrors. Adfree

---

✨ Key Features (Planned & In Progress)

• Smart Search: Quickly find firmware by device codename
• Downloads: Direct links to official Xiaomi mirrors (bigota/hugeota).
• Region Support: China, Global, EEA, India, and more
• Versatile: Support for OTA and Fastboot

Tech Stack

🛠 Tech Stack

Frontend:

• Framework: Next.js 14+ (Pages Router)
• Language: TypeScript
• Icons: @ant-design/icons

Proxy:

• Platform: Cloudflare Workers
• Runtime: Edge Runtime (JavaScript)

Getting Started

1. Proxy Configuration

Xiaomi API servers have no CORS policies and browser block direct requests. You have two options:

Option A: Use Cloudflare Workers (Fastest)

1. Create a new Worker in your Cloudflare dashboard.

2. Copy the logic from proxy/workers.js to your worker.

3. Important: Update the Access-Control-Allow-Origin header to match your site's domain to ensure proper CORS security:

   newResponse.headers.set("Access-Control-Allow-Origin", "https://your-domain.com");

4. Deploy and copy the Worker URL.

Option B: Use your own Proxy

If you prefer using your own backend (Nginx, Node.js, PHP), ensure it:

• Forwards requests to update.miui.com and etc
• Sets User-Agent: Xiaomi-Update/3.0
• Handles CORS preflight (OPTIONS requests)

2. Frontend Setup

1. Clone the repository:

git clone https://github.com/XiaomiUtils/XiaomiUT.git
cd XiaomiUT/frontend

2. Open src/config.ts and point the URLs to your proxy:

export const API_CONFIG = {
    OTA_BASE_URL: 'https://your-proxy.com/ota',
    FASTBOOT_BASE_URL: 'https://your-proxy.com/fastboot',
    TIMEOUT: 5000,
};

3. Install and build:

   npm install
   npm run build

4. Deploy your frontend/out to your hosting