https://github.com/sepandhaghighi/neovid
🎬 Neovid: Minimal Web Video Player
https://github.com/sepandhaghighi/neovid
html5 javascript streaming video video-player
Last synced: 3 months ago
JSON representation
🎬 Neovid: Minimal Web Video Player
- Host: GitHub
- URL: https://github.com/sepandhaghighi/neovid
- Owner: sepandhaghighi
- License: mit
- Created: 2025-10-10T10:12:19.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2026-04-15T14:20:54.000Z (3 months ago)
- Last Synced: 2026-04-15T16:06:45.058Z (3 months ago)
- Topics: html5, javascript, streaming, video, video-player
- Language: JavaScript
- Homepage: https://neovid.top/
- Size: 2.56 MB
- Stars: 19
- Watchers: 0
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Authors: AUTHORS.md
Awesome Lists containing this project
README
## Overview
**Neovid** is a minimal, zero-dependency web-based video player designed to be simple, fast, and mobile-friendly.
It supports both online and local video playback with optional subtitles.
🌐 **Live Demo:** [https://neovid.top](https://neovid.top)
## Features
- **Zero dependencies**: pure HTML, CSS, and JavaScript
- **Mobile responsive** design
- **Play video from URL or local file**
- **Subtitle support**
- **Recent plays history** (tracks last 30 videos)
- **Progress tracking**: remembers last watched percentage per video
- **Query string loader**: automatically loads video and subtitle URLs from `video=` and `subtitle=` parameters
- **Watch time**: tracks total time spent watching videos
- **Export recent history**: download your recent plays data as a JSON file
- **Import recent history**: restore or replace recent plays data from a previously exported file
- **Direct download buttons**: download video and subtitle files from URL sources
## Usage
### Play a Video
1. In the **Video** section, choose how you want to load your video:
- **URL** → Paste a direct video link (e.g., `.mp4`, `.webm`)
- **Local File** → Select a video file from your device
2. In the **Subtitle** section, choose how to load subtitles (optional):
- **URL** → Enter a `.vtt` or `.srt` subtitle link
- **Local File** → Select a subtitle file from your device
3. Click **Play Video**
### Recent Plays
- Neovid automatically saves the **last 30 videos** and your **view progress**
- Data is stored locally in your browser (no server involved)
- You can **export** your recent plays to a file for backup or transfer
- You can **import** a previously exported file to restore your recent plays
## Local Development
To test Neovid locally, you can use [Ghps](https://github.com/sepandhaghighi/ghps) a minimal GitHub Pages simulator written in pure Python.
Run:
```console
ghps --port 8000
```
Then open your browser and visit:
```console
http://localhost:8000
```
## Issues & Bug Reports
Just fill an issue and describe it. We'll check it ASAP! or send an email to [info@neovid.top](mailto:info@neovid.top "info@neovid.top").
- Please complete the issue template