Guanya-GUI

Project Overview

Guanya-GUI is a third-party Windows desktop client for the Guangya cloud drive. The frontend uses React, TypeScript, and Vite, the desktop layer uses Tauri 2, and Rust handles cloud access, a stable stream proxy, and MPV process management. It delegates all audio and video playback to external mpv-lazy rather than embedding a player in the WebView, and the installer bundles a lightweight MPV runtime and default config so it works right away.

Manage your cloud drive from a desktop client and play media with MPV quality.

Key Features

• Login and sessions: SMS code login, local session persistence, and credential management
• File management: browsing, directory caching, move, copy, delete, and download
• Offline download: queue resources for offline download to the cloud drive
• External playback: all audio and video goes to external mpv-lazy instead of an embedded WebView player
• Stream proxy: a Rust local Range proxy that refreshes expired signed links and retries automatically
• Playlists: single-file playback, playing the current list, appending, and previous/next switching
• MPV management: a single default config with startup warm-up, status monitoring, and playlist control

Target Audience

• Users who manage files on the Guangya cloud drive
• Users who want to play cloud media with MPV
• Users who need a stable stream proxy with reconnect retries

Quick Start

1. Download Guanya-GUI_0.02_x64-setup.exe from Releases and install it; MPV is bundled
2. Open the app and sign in to your Guangya account with an SMS code
3. Browse directories in the file list and move, copy, delete, or download as needed
4. Select an audio or video file to play it in external MPV
5. For continuous viewing, add multiple files to the playlist and switch between them

Core Advantages

• Playback quality: MPV's decoding and rendering bring better image quality and format compatibility
• Stable links: the stream proxy refreshes and retries expired signed links, keeping long videos uninterrupted
• Ready out of the box: the installer bundles the MPV runtime and default config with nothing extra to install
• Clear separation: UI, proxy, and the playback process each do their own job, with no WebView compromise

System Requirements

Item	Requirement
OS	Windows 10 / 11 (x64)
Runtime	A lightweight MPV is bundled; nothing else to install
Installation	The Guanya-GUI_0.02_x64-setup.exe installer

Notes

• This is a third-party client with no affiliation with the official Guangya cloud drive
• Login sessions, logs, playback history, and cache are local data; do not commit them to public repositories
• Enhancement components such as interpolation, shaders, Python, and VapourSynth are not part of the runtime
• Source development requires Node.js 20+, Rust stable, and Python 3.10+