explaingit

hunlongyu/zy-player

14,512VueAudience · generalComplexity · 1/5Setup · easy

TLDR

A free, ad-free desktop video player for Windows, Mac, and Linux that lets you browse and play internet video streams and IPTV channels through a clean, customizable interface.

Mindmap

mindmap
  root((repo))
    What it does
      Play IPTV streams
      Browse video sources
      Custom source lists
    Tech stack
      Vue
      Electron
    Use cases
      Live TV streaming
      On-demand video
      Source sharing
    Audience
      General users
      Cord-cutters
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Watch IPTV channels and internet video streams from user-configured sources on your desktop without ads.

USE CASE 2

Browse video content in a poster grid or list view and save favorites for later viewing.

USE CASE 3

Export download links for video resources and automatically resume playback where you left off.

Tech stack

VueElectronJavaScript

Getting it running

Difficulty · easy Time to first run · 5min

Download channels for installable packages were temporarily closed at time of writing, all video content comes from third-party internet sources.

In plain English

ZY Player is a free, ad-free desktop video player application built with Vue and Electron, a framework that lets web technologies run as a native desktop app on Windows, Mac, and Linux. The project is primarily described in Chinese, but the core purpose is clear: it lets you browse and play video resources from the internet through a clean interface. The player supports IPTV (internet-based television streams) and satellite live broadcasts, meaning you can tune into live channels in addition to on-demand content. Video sources can be customized by the user and imported or exported as configuration files, so you can share your source lists with others or back them up. The app offers two browsing modes: a poster grid view that shows cover art for each title, and a traditional list view. Other features include a playback history that automatically resumes where you left off, a favorites folder that can also be imported and exported, a one-click search across all configured sources with a saved search history, and the ability to export download links for video resources. A minimal "slim mode" strips the interface down to just the essentials. Third-party external players are also supported if you prefer a different playback engine. The README includes a full keyboard shortcut reference: arrow keys handle seeking and volume, F toggles full screen, M mutes, Space plays or pauses, and Alt plus the arrow keys step through episodes. The project also has companion apps for Android and iOS as well as a TV-optimized version built by a separate contributor. The README notes that download channels for installable packages were temporarily closed at the time of writing, and that all video content comes from third-party internet sources. The software is described as intended for learning and reference purposes only.

Copy-paste prompts

Prompt 1
I want to add my own IPTV source to ZY Player. How do I create and import a custom video source configuration file?
Prompt 2
Show me how to export my ZY Player favorites list so I can back it up or share it with someone else.
Prompt 3
How do I configure ZY Player to use an external media player instead of the built-in playback engine?
Prompt 4
Walk me through all the ZY Player keyboard shortcuts for seeking, adjusting volume, muting, and toggling full screen.
Open on GitHub → Explain another repo

← hunlongyu on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.