Turn Your Video Folder into a Personal Netflix with KVideo

Ever have a folder full of movies, tutorials, or home videos that’s just sitting there? You know, the kind you have to manually open with a media player, hunt through file names, and lose all sense of organization. What if that folder could feel more like a sleek, personal streaming service?

That’s exactly what KVideo does. It’s a lightweight, self-hosted web app that scans a directory of your video files and instantly presents them with a clean, browsable interface—complete with thumbnails, metadata, and a searchable library. No cloud uploads, no subscriptions, just your videos, served your way.

What It Does

KVideo is a Python-based web application. You point it at a folder on your machine (or server) containing video files (like MP4, MKV, MOV, etc.). It then:

• Scans the directory and extracts metadata.
• Generates thumbnails for each video.
• Presents everything in a web-based UI that lets you browse, search, and play videos directly in your browser.
• Organizes content by recently added, and can group files in the same folder as "seasons."

Think of it as a minimalist, open-source Plex/Jellyfin alternative that’s incredibly simple to set up for a personal collection.

Why It’s Cool

The beauty of KVideo is in its straightforwardness and developer-friendliness.

• Zero-Fuss Setup: It’s essentially a single Python script. No complex configuration or databases required to start. It uses the filesystem as its database.
• Privacy-First: Everything runs locally. Your videos never leave your machine or server. It’s perfect for a home media server or a locked-down internal video library.
• Smart & Simple Features: It automatically tries to fetch nicer titles and posters from TMDB for your movies, but falls back gracefully to folder/file names. The UI is fast, uncluttered, and gets out of the way.
• A Great Starting Point: The code is clear and modular. It’s a fantastic reference project for developers interested in building web UIs for local content, working with video metadata, or creating simple media servers.

How to Try It

Getting started is straightforward. You’ll need Python 3 installed.

1. Clone the repository:

   git clone https://github.com/KuekHaoYang/KVideo.git
   cd KVideo
   

2. Install the dependencies:

   pip install -r requirements.txt
   

3. Ru