zyfun is a free, open-source, cross-platform media management desktop application built on Electron + Vue 3. It aggregates T0–T4 resource types — from XML/JSON CMS APIs to Python-based and Node.js plugin-driven scrapers — into a single unified interface, with swappable multi-engine players, live IPTV, cloud sync, and an embedded Fastify API server.

At its core, the application solves three problems: resource aggregation (discovering and cataloging media across heterogeneous sources), playback (decoding and rendering multiple stream formats), and data management (persisting user state, syncing across devices). The application supports 16 distinct site adapter types spanning XML feeds, JSON APIs, Hiker rule engines, CatVod Node.js plugins, and Python-based DrPy scrapers.

## Feature Summary

- **Resource Aggregation:** T0–T4 site adapters, 16 adapter types, aggregated search.

- **Playback:** ArtPlayer & XgPlayer, HLS/DASH/FLV/Torrent decoding.

- **Live IPTV:** M3U/M3U8 parsing, EPG, channel logos, delay testing.

- **Cloud Sync:** WebDAV & iCloud backup/restore.

- **AI Integration:** OpenAI/Anthropic/Google/Ollama chat.

- **Plugin System:** JS/TS plugins via worker pool execution.

- **Proxy & DNS:** System/custom/socks5 proxy, DoH resolution.

- **Cross-Platform:** Windows, macOS, Linux (x64 + arm64).

## Technology Stack

zyfun is built on a modern, type-safe Electron stack with strict TypeScript, pnpm workspaces, and Vitest for testing. The technology choices reflect a bias toward production-grade tooling over convenience.

- **Runtime:** Electron 41.4.0

- **Node.js:** Node >=24.11.1

- **Package Manager:** pnpm 10.27.0+

- **Build Tool:** electron-vite ^5.0.0

- **Frontend Framework:** Vue 3 (Composition API) ~3.5.35

- **UI Library:** TDesign Vue Next ^0.1.6+

- **State Management:** Pinia ^3.0.4

- **Backend Server:** Fastify + TypeBox ^5.8.5

The repository follows a monorepo-style layout with pnpm workspaces, separating the core application (`src/`), reusable packages (`packages/`), runtime resources (`resources/`), and build tooling (`scripts/`). Runtime resources include binary download scripts for FFmpeg, Python, and Bun.