About this project

GridPlayer is a simple VLC-based media player designed to play multiple videos side-by-side in a configurable grid. It runs on Linux, macOS, and Windows, leveraging VLC's extensive codec support to handle virtually any video or audio format. The player also integrates streamlink and yt-dlp for direct playback of streaming URLs from numerous sites. Key features include hardware and software video decoding modes, control over aspect ratio, playback speed, and zoom, frame-precise loop fragments, drag-and-drop video swapping, and playlists that remember position, volume, loops, and aspect ratio for each video. The grid layout is fully configurable, and the only practical limit on concurrent videos is system hardware. Installation options are diverse: Windows installer and portable builds, Scoop, Flatpak, Snap, AppImage, macOS DMG (Apple Silicon), UV tool install, and from source. Python 3.10+ and a system VLC installation are required for the Python-based distribution methods. The application supports internationalization with translations contributed via Crowdin for many languages. Command-line options allow specifying a custom user data directory, and the program stores settings and logs in standard platform locations unless overridden. Known issues are documented for Snap confinement (removable media and mount access) and Linux hardware decoder black-screen scenarios, with workarounds provided. The project is built on Python, Qt, VLC, PyQt, python-vlc, pydantic, streamlink, and yt-dlp, with various open-source licenses.