HLS Analyzer via ChatGPT API

Overview

HLS Analyzer is an open-source tool that fetches .m3u8 files (HLS playlists), sends them to ChatGPT, and receives analysis on stream integrity.
It follows RFC-8216 (HLS standard) to detect errors and anomalies in the playlist structure.

Features

• Downloads .m3u8 files dynamically from a given URL.
• Validates stream integrity using ChatGPT (GPT-3.5 Turbo).
• Runs ffprobe on the .ts segment to verify stream properties.
• Fast & Lightweight, built with Java + Maven.
• API Key Management via config.properties or environment variables.
• Open Source under Apache License 2.0.

---

Installation & Setup

Clone the Repository

git clone https://github.com/serrss/hls-ai-analyzer.git
cd hls-ai-analyzer

Ensure Java 17+ & Maven Installed

Check Java:

java -version

Check Maven:

mvn -version

Java 17+ is required!

Set Up API Key

You must provide an OpenAI API key.

Option: Use config.properties

Create a file src/main/resources/config.properties:

openai.api.key=sk-your-api-key-here

DO NOT commit this file! Add it to .gitignore.

Option: Use Environment Variable

export OPENAI_API_KEY="sk-your-api-key-here"

(For Windows: use set OPENAI_API_KEY="sk-your-api-key-here" in CMD.)

Install FFmpeg (Required for ffprobe)

The tool requires ffprobe to analyze .ts media files.

Install on macOS (via Homebrew):

brew install ffmpeg

Install on Ubuntu:

sudo apt update && sudo apt install ffmpeg

Install on Windows: Download from FFmpeg official site and add it to your system PATH.

---

Build & Run

Build the Project

mvn clean package

Run the Analyzer

java -jar target/hls-analyzer-1.0-SNAPSHOT.jar

---

🔍 Example Response from ChatGPT

✅ If the manifest is valid:

{"status": "OK", "message": "Manifest is correct"}

❌ If errors are found:

{"status": "FAIL", "message": "Segment duration mismatch at #EXTINF:10.5 (should be 10.0)"}

---

License

This project is licensed under Apache License 2.0.
See LICENSE for details.

---

Contributing

Contributions are welcome! If you find a bug or have a feature request:

1. Fork the repository on GitHub.
2. Create a feature branch (git checkout -b feature-new).
3. Commit your changes (git commit -m "Add new feature").
4. Push to GitHub (git push origin feature-new).
5. Open a Pull Request.

---

📬 Contact

Author: Serhii Romanov
Email: sergey.romanov.kh@gmail.com
GitHub: serrss