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. Run the application, specifying your video directory path:

   python main.py --video_dir /path/to/your/videos
   

4. Open your browser and navigate to http://localhost:5000. Your video library should be loading.

For a more permanent setup (like on a home server), you can look into running it as a service. The README has helpful details on configuration and deployment options.

Final Thoughts

KVideo solves a specific problem elegantly: making a local video dump feel organized and accessible. It’s not trying to be a full-blown enterprise media suite, and that’s its strength. As a developer, I appreciate tools that do one thing well and are easy to hack on. This is perfect for quickly spinning up a streaming interface for a project demo reel, a family video archive, or a personal movie collection without the overhead of heavier solutions.

If you’ve been meaning to bring order to your video chaos, this might be the 30-minute project that finally does it.

Find more interesting projects from the community at @githubprojects.