Repository files navigation

Simple VLC-based media player that can play multiple videos at the same time. You canplay as many videos as you like, the only limit is your hardware. It supports all videoformats that VLC supports (which is all of them). You can save your playlist retaininginformation about the position, sound volume, loops, aspect ratio, etc.

• Cross-platform (Linux, Mac, and Windows)
• Support for any video and audio format (VLC)
• Support for (almost) any streaming URLs (streamlink +yt-dlp)
• Hardware & software video decoding
• Control video aspect, playback speed, zoom
• Set loop fragments with frame percision
• Configurable grid layout
• Easy swap videos with drag-n-drop
• Playlist retains settings for each video

GridPlayer now supports internationalization! Anyone with a handful of free time anddesire to support this project iswelcome to contribute.No coding skills or special software required, all dialogs are well documented andthere are not many strings to translate.

Huge thanks toevery contributor!

Viascoop:

$ scoop install gridplayer

Compatible with Windows 7, 8, 10, 11.

For better system integration install via Flathub.

The AppImage was built using Ubuntu Focal Fossa libraries, so compatibility is Ubuntu 20+.

You may need to set execute permissions on AppImage file in order to run it:

$ chmod +x GridPlayer-0.5.3-x86_64.AppImage

DMG image is not signed. You will have to add an exception to run this app.

• How to open an app that hasn’t been notarized or is from an unidentified developer
• Open a Mac app from an unidentified developer

If you get "GridPlayer is damaged and can't be opened" error, run this command in the Terminal app:

$ sudo xattr -rd com.apple.quarantine /Applications/GridPlayer.app

$ pip install -U gridplayer

Python 3.8 or later required.

This type of installation will also require avlc package present in your system.Please refer toVLC official page for instructions on how to install it.

Some distros (e.g. Ubuntu) might also requirelibxcb-xinerama0 package.

This project usespoetry for dependency management and packaging. You will have to install it first. Seepoetry official documentation for instructions.

$ git clone https://github.com/vzhd1701/gridplayer.git$cd gridplayer/$ poetry install --no-dev$ poetry run gridplayer

The same notes about the Python version and external packages fromPIP installation apply here.

GridPlayer supports two video output modes:

• Hardware (default) mode uses available GPU to render video. This mode offers high performance and is a recommended mode.
• Software mode is entirely independent of GPU and only uses the CPU to render video. This mode may cause a high CPU load with high-resolution videos.

Due to libvlc software library limitations, video decoding is split into parallel processes. You can control how many videos are handled by a single decoder process using the "Videos per process" setting. Setting this option too high may cause a high CPU load and application freeze. The optimal value is 4 videos per process.

There is also "Hardware SP" mode. It handles video decoding within the same process in which GridPlayer runs. It is not recommended to use with many videos (>4-6) because it may cause high CPU load and application freeze.

Due to OS inter-process restrictions, "Hardware SP" is the only available hardware mode in macOS.

You need to allow GridPlayer snap to access removable storage devices via Snap Store or by running:

$ sudo snap connect gridplayer:removable-media

You will also see following error if you run GridPlayer from terminal:

GLib-GIO-WARNING**: Error creating IO channelfor /proc/self/mountinfo: Permission denied (g-file-error-quark, 2)

To fix this, you need to allow GridPlayer snap to access system mount information and disk quotas via Snap Store or by running:

$ sudo snap connect gridplayer:mount-observe

Switch on "Opaque overlay (fix black screen)" checkbox in settings.

Depending on the window manager, the overlay might be a bit glitchy with the hardware decoder. Enabling compositor might help.

If you found a bug or have a feature request, pleaseopen a new issue.

If you have a question about the program or have difficulty using it, you are welcome tothe discussions page. You can also mail me directly, I'm always happy to help.

This software was build using

• Python byPython Software Foundation
  • Licensed underPython Software Foundation License
• Qt byQt Project
  • Licensed underGPL 2.0, GPL 3.0, and LGPL 3.0
• VLC byVideoLAN
  • Licensed underGPL 2.0 or later

• PyQt byRiverbank Computing
  • Licensed underRiverbank Commercial License and GPL v3
• python-vlc byOlivier Aubert
  • Licensed underGPL 2.0 and LGPL 2.1
• pydantic bySamuel Colvin
  • Licensed underMIT License
• streamlink byChristopher Rosell, Streamlink Team
  • Licensed underBSD-2-Clause License
• yt-dlp byContributors
  • Licensed underUnlicense License

• Hack Font bySource Foundry
  • Licensed underMIT License
• Basic Icons byIcongeek26
  • Licensed underFlaticon License
• Suru Icons bySam Hewitt
  • Licensed underCreative Commons Attribution-Share Alike 4.0
• Clean App Download Buttons byTony Thomas
  • Licensed underMediaLoot License
• Flag Icons byPanayiotis Lipiridis
  • Licensed underMIT License

• azoaz6001

• DominikPott

• Sergio Varela
• asolis2020

• Sylvain LOUIS

• samu112

• Davide V.
• SolarCTP

• 七篠孝志

• VenusGirl

• Heimen Stoffels

• rafal132
• Sebastian Jasiński

• GBS ~ TECH

• Yagang Wang
• 1017346
• 焦新营
• loser7788
• 李凡

This software is licensed under the terms of the GNU General Public License version 3 (GPLv3). Full text of the license is available in theLICENSE file andonline.