fzw005421/wanfeng-video

Wanfeng Video is a Windows desktop application that lets users stream movies and TV shows from a self-hosted video catalog. It is built on top of a content management system called Apple CMS (a popular Chinese open-source video site platform), which stores all the video metadata. The desktop app connects to that catalog and gives users a friendlier interface for browsing and watching content. The software has two main pieces. The first is a desktop client built with Electron, which is a technology that wraps web code into a Windows app. The client shows a browsable homepage with rotating featured titles, a search box, and detail pages that display posters, descriptions, cast, and ratings. The second piece is a PHP-based web server that acts as a go-between: it reads video data from the Apple CMS database (in read-only mode) and also handles its own database for storing user accounts, favorites, and watch history. When a user clicks to watch something, the PHP backend figures out the actual video address from the CMS data and then sends that address through a configurable parser API, which converts it into an m3u8 streaming link. The desktop player then plays that link using hls.js, a browser-compatible streaming library. The app supports both H.264 and H.265 video formats. H.265 support requires a bundled helper file called ffmpeg.dll, without it, H.265 videos will have audio but no picture. User-specific data like favorites and playback history is stored in a separate MySQL database that the PHP backend owns. Watch progress is saved automatically, so users can resume where they left off. The app also supports switching between multiple video sources and multiple parser APIs mid-playback if one source fails. A light and dark theme toggle is included. The project is Windows-only at this point. The README includes full setup instructions for deploying the PHP backend on a shared hosting panel, configuring two separate databases, and compiling the Electron desktop client. The license is MIT.