Surwish-Miyoo-Flip

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

Surwish-Miyoo-Flip

★ 77 Open GitHub ↗

Surwish OS - Miyoo Flip repository

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Surwish OS for Miyoo Flip
=============================

**Surwish OS** is a feature-rich custom operating system for the **Miyoo Flip**, designed to bring the handheld experience up to par with the best-in-class systems.

While the Flip's stock OS provides a lightweight and smooth foundation, it lacks many advanced features and polish found in other modern handheld firmwares. Surwish OS builds upon this solid base and adds a wealth of improvements --- making the Flip not just usable, but exceptional.

* * * * *

🔥 Why Surwish OS?
------------------

-   **Inspired by our experience**: We took inspiration from our best handheld OS projects and raised the bar by combining their best features and adding more.

-   **Fully open-source contributions**: As the first resellers to openly publish our mods, we're committed to giving back to the community.

-   **Plug-and-play ready**: Out of the box, Surwish OS is fully set up --- no tedious configuration needed.

-   **Power-user ready**: Packed with advanced features like SMB, SSH, VPN support, system tools, and OTA updates.

* * * * *

🎮 Key Features
---------------

### 🕹️ Emulators & Ports

-   ✅ **100+ emulators**, including optimized standalone builds for demanding systems like N64, Dreamcast, Saturn, and PS1.

-   ✅ Deep RetroArch integration with **version 1.20**, including in-game Miyoo menu and **cloud save support**.

-   ✅ Tailored performance settings and visual enhancements (shaders, overlays, aspect ratio fixes) for each system.

-   ✅ Exclusive **PortMaster** support for the Flip

### 🎨 UI & Themes

-   🖼️ Brand-new **Surwish theme** with custom icons, textures, and cohesive identity.

-   🌈 Wide selection of themes.

-   💡 Screen calibration for vibrant, accurate colors out of the box.

### ⚙️ Apps & Tools

-   📚 **KOReader** for reading PDFs and EPUBs.

-   📁 **File Manager** (English localized), **File Browser** (access files over HTTP).

-   🎵 **Music Player** with online radio support, **Video Player** (MPV-based with TV streaming).

-   🎲 **Random Game Picker**, **Scraper**, **EmuCleaner** (hide emulators without ROMs).

-   🧰 **System Tools**:

-   Toggle auto-save / resume on boot

-   Reset RetroArch / PortMaster configs

-   Enable SMB, FTP, SSH, Syncthing, Telnet...

-   🚀 **OTA Update system** with GitHub backend

-   🔧 Boot logo selector --- To flash custom boot logos

### 🚀 Advanced Features

-   🧠 **Resume at boot**: Save & power off with *Select + R3*, resume game on next startup.

-   🌐 Background services at boot: SMB makes ROM transfers a breeze.

-   🗂️ Custom **"Collections" menu** replaces stock RetroArch tab

-   🌍 **Multi-language support**: English, French, Italian, German, Russian.

-   🔄 **Firmware updater**: Warns users before applying latest compatible Miyoo firmware with Surwish enhancements.

-   🎮 **Input shortcuts**: Select = RetroArch hotkey; optimized user experience for both casual and advanced users.

-   📺 **EmulationStation**: an alternative UI customized with a new theme

* * * * *

🛠️ Behind the Scenes
---------------------

Surwish OS is not a simple mod --- it's a **ground-up rework**:

-   CrossMix OS served as a technical base, but adapting it to the Flip required **full rewrites** due to different paths, resolutions, and emulator configs.

-   All emulator configs were **tuned for the Flip's resolution and performance**, including aspect ratio fixes, shader integration, and input calibration.

-   **Testing and debugging** was done to ensure smooth performance across platforms and compatibility with both RetroArch and standalone emulators.

-   Firmware work included testing **audio over Bluetooth**, lid-close events, and overall system stability.

* * * * *

🎯 Our Vision
-------------

Surwish OS is our answer to what the Miyoo Flip truly deserves:\
A **modern, community-driven, premium OS** with the attention to detail and polish you expect from high-end handheld experiences.

We're not just building software --- we're building a community.\
Surwish OS will continue to evolve thanks to your feedback, ideas, and contributions.

**Made with passion. Powered by the community.**

## 📥 Installation
------------------

### 1. Download the package
Simply download [Surwish-OS ZIP archive](https://github.com/Surwish/Surwish-Miyoo-Flip/archive/refs/heads/main.zip)

### 2. Prepare the microSD card
- Format the card as **FAT32**.  
- Extract the downloaded ZIP file to the **root** of the microSD card.

### 3. Set up on the console
- Insert the card into the **right slot** of your Miyoo Flip.  
- Power on the device.

🎉 **All done! Enjoy your Surwish setup.**

🤝 Credits
==========

Surwish OS incorporates open-source components from CrossMix OS, used with the kind authorization of its original developer:

> Usually, it's community developers who contact me. I appreciate that you reached out to request permission, as many do not.
> 
> I authorize the use of CrossMix sources under the following conditions:
> 
> -   The source code, including your applied modifications, must be published openly.
> 
> -   Your improvements and bug fixes will also benefit the CrossMix project through pull requests, including any future ones.
> 
> -   The community users will have free and open access to the source code of your modifications.
> 
> -   If your project significantly relies on my work, any financial contributions related to the open-source project must be directed to CrossMix.
> 
> -   These conditions must be clearly displayed in your repository's readme and may be updated if necessary.
> 
> Under these conditions, I see no objection, as your initiative will benefit both the open-source community and those who do not have the courage or means to customize their SD cards themselves."
> 
> This collaborative spirit will ensure a healthy ecosystem benefiting all users and developers. I hope this initiative will set a positive example and inspire others to undertake similar actions.

[CrossMix-OS project](https://github.com/cizia64/CrossMix-OS/)

* * * * *

📜 Licensing
============

The use of Surwish OS for commercial purposes is strictly prohibited without explicit written authorization from Surwish company.

This prohibition includes, but is not limited to:

-   Selling or distributing Surwish OS or any derivative works for profit.

-   Bundling Surwish OS with hardware or other software for commercial resale.

-   Utilizing Surwish OS within any commercial service or offering.

Surwish OS is provided as a free and open-source project, designed to serve the community and enhance the user experience on the Miyoo Flip platform. It is also officially bundled and distributed by Surwish company as part of its product offerings for the Miyoo Flip.

Any commercial use, distribution, or exploitation by third parties without prior authorization from Surwish is strictly forbidden.

For commercial inquiries, licensing requests, or partnership opportunities, please contact the Surwish development team directly.

Surwish-Miyoo-Flip

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README