FreeViewKodi - A Kodi Addon

Add to Kodi

To install the addon and receive automatic updates, add this repository URL as a source in Kodi.

https://freeviewkodi.github.io/repo/

Download the Zip File

Download the latest version of the repository zip file to install it manually on your Kodi device.

Key Features

This add-on is simple, extensible, and easy to manage, giving you full control over your media library through simple JSON files.

🗂️

Organized Content

Browse TV Shows, Movies, and Music Videos through a clean, easy-to-navigate menu within Kodi.

💾

Local Data Source

Reads all content from local JSON files, making it easy to manage and customize your own video libraries.

🖥️

Kodi Compatibility

Built to work with modern versions of Kodi, ensuring stability, performance, and a seamless user experience.

⚙️

Extensible Design

A simple and well-commented Python codebase that's easy to understand and modify for your own purposes.

How It Works

This add-on acts as a bridge between your Kodi interface and simple text files. The diagram below illustrates the process.

🖥️

Kodi Interface

→

🐍

Freeview Add-on

→

📄

JSON Files

(tvshows.json, etc.)

Installation Guide

Follow these simple steps to install the FreeViewKodi addon in your Kodi client:

Launch Kodi and navigate to the **Add-ons** section.
Click the **Package installer** icon (the open box icon).
Select **Install from zip file**.
Browse to the downloaded `repository.freeviewkodi-main.zip` file and select it.
Wait for the "Add-on enabled" notification.
Go back and select **Install from repository**, then choose the **FreeViewKodi Repository**.
Navigate to **Video add-ons** and select **FreeViewKodi** to install it.

Project Roadmap & Upgrades

Current Status

The project provides a stable, file-based Kodi add-on for managing media libraries. It is a simple, extensible framework that prioritizes user-managed content.

Planned Features & Upgrades

API Integration: Implement support for fetching content from a remote API, allowing for dynamic updates without manual file editing.
Live TV Support: Extend the data structure and logic to support live streaming channels with EPG (Electronic Program Guide) data.
Improved Metadata Handling: Add support for more metadata fields in the JSON, such as ratings, genres, and cast information.
User Interface Customization: Introduce settings to allow users to customize the layout and appearance of the addon within Kodi.

Contribution

This is an open-source project, and contributions are welcome. Feel free to submit pull requests or open issues on the project's GitHub page. Your feedback and code are invaluable.

JSON Data Structure

The add-on reads content from a JSON array. Each object in the array represents one video item. You must follow this structure in your content files.


[
    {
        "title": "Example Show",
        "plot": "A brief description of the show.",
        "thumbnail": "https://via.placeholder.com/150",
        "url": "https://example.com/videos/show.mp4"
    }
]