Skip to content

Repository files navigation

You will need a tool to get the m3u8 url like https://github.com/puemos/hls-downloader

GridCast

GridCast is an Electron application that allows users to play multiple M3U8 streams and MP4 files in a dynamic 2x2 grid layout. Built with Electron.js, MPV, and HLS.js, it provides a seamless way to load, manage, and persist playlists for multiple video streams.

After the application opens up

Adding a m3u8 URL or MP4

When 4 Live Streams are running


Features

2x2 Grid Layout – Four independent video players
MPV & HLS.js Integration – Supports M3U8 streams & MP4 playback
Stream Loading – Load M3U8 URLs or upload MP4 files
Persistent Playlists – Playlists are saved & restored on launch
Hover-Based UI – Controls appear only when needed
Error Handling – Alerts users for failed streams
Minimal UI Design – Clean and auto-hiding interface

Installation

Download the App

  1. Navigate to the Releases section on GitHub.
  2. Download the latest release artifact for your platform:
    • macOS: GridCast-<version>-x64.dmg or GridCast-<version>-arm64.dmg
    • Linux: GridCast-<version>-x86_64.AppImage
  3. macOS: Open the .dmg file and drag GridCast into your Applications folder.
  4. Linux: Make the AppImage executable and run it:
chmod +x GridCast-<version>-x86_64.AppImage
./GridCast-<version>-x86_64.AppImage

Usage

  1. Launch the App – Open GridCast from the Applications folder.
  2. Load a Stream – Click on a video player to input an M3U8 URL or upload an MP4 file.
  3. Manage Playlists:
    • Click "Add to Playlist" after loading a stream.
    • View the playlist by hovering over the video player.
    • Click a playlist item to switch streams.
    • Remove a playlist item by clicking the "Remove" button.
  4. Auto-Save & Restore – Playlists are saved and will load when the app is restarted.

Development Setup

1. Clone the Repository

git clone https://github.com/yourusername/gridcast.git
cd gridcast

Install Dependencies

npm install

Run the App Locally

npm start

Build for macOS

npm run build:macos

Dependencies

  • Electron.js – Desktop application framework
  • MPV.js – Video player integration
  • HLS.js – M3U8 stream support
  • electron-builder – Packaging and distribution
  • electron-packager – App bundling

Contributing

  • Fork the repository and create a new branch.
  • Make your changes and commit them.
  • Submit a pull request.

License

📜 Licensed under the

Author

About

GridCast is a macOS/Windows Electron application that allows users to play multiple M3U8 streams and MP4 files in a dynamic 2x2 grid layout. Built with Electron.js, MPV, and HLS.js, it provides a seamless way to load, manage, and persist playlists for multiple video streams.

Topics

Resources

Contributing

Security policy

Stars

5 stars

Watchers

2 watching

Forks

Releases

Packages

Used by

Contributors

Languages