KHLC - Homelab Cable
A Go application for playing media in your homelab the way a television station would. Set up multiple "channels" within your network, each of which continuously play through a list of local media files at random.
Only tested on linux machines, requires VLC and LibVLC.
sudo apt install vlc libvlc-dev
- Sync this repo
go run cmds/cli/main.go server --path "./local/path/to/folder/of/videos"
On Linux (I've tested on Ubuntu Raspberry Pi OS) you may need to prepend DISPLAY=:0.0, e.g. go run cmds/cli/main.go server --path "./local/path/to/folder/of/videos"
go run cmds/cli/main.go client live
go run cmds/cli/main.go client play_next
The CLI client assumes the server is running at localhost:3004. See go run cmds/cli/main.go help for more options.
Navigate to http://localhost:3004/ in your browser.
There is a partially implemented notion of networks and multiple channels. These are exposed over a REST API, see server.go and api.go for more details.
Request
curl http://localhost:3004/api/networks
Response
[
{
"name": "Homelab Cable",
"call_sign": "KHLC"
}
]
Request
curl http://localhost:3004/api/:call_sign/channels
Response
[
{
"id": "bd63bc6a-27cd-47fb-81d5-642a216f335e",
"playing": "title of currently playing media.mp4",
"up_next": "title of the next show which will play.mp4",
"live": true // whether or not this channel is outputing via VLC on the device
},
{
"id": "0cd43939-082b-4c15-b642-0682a035cfb0",
"playing": "some other currently playing media.mp4",
"up_next": "some other show which will play next.mp4",
"live": false // if false, the channel is a 'virtual' channel. it is cycling through its media list in memory every 30 minutes to mimic a channel that isn't being watched.
}
]