Homelab Television (HLTV)

A simple tool made in Java using VLCJ to randomly play files in a directory

Note Skip Button is currently broken and on Linux Path names cannot have spaces (if used from the command line)

Release	Link	Status
Stable	GitHub Releases
Testing	GitHub Releases

What is HLTV?

Homelab Television is a Java app that takes in a path, then randomizes the order, and plays them in order. It was designed to be run on a small server such as a Raspberry Pi and play content through the output.

To modify any config options besides the path to read, you must build from source.

Usage

1. Install a version of JDK-21 (Recommended 21.02)

To run without modifying config:

2. Download the latest release Here (stable recommended)
3. Run the .jar with args

# Replace (release) with your downloaded file name and (path) with the path to your directory of videos
java -jar (release).jar (path)

To build from source:

2. Download the source code of the latest release Here (stable recommended)
3. Pre 0.3: Edit the Main.java class.
   0.3+: Edit the Config.json file to fit your preferences.
4. Run the "jar" Gradle Task.
5. Run the following commands.

# Replace (release) with your downloaded file name
java -jar (release).jar