AKTIVKTV

Downloads

Get the two pieces

The app plays the songs. The server holds your library and serves every screen. For a phone or tablet on its own, the app is all you need.

Android

AktivKTV app

Runs on Android TV boxes, tablets and phones. Plays from a library server or from songs on the device itself.

APK · Android 10 or newer · TV and touch

Download the app

Windows, macOS, Linux

Library server

For venues. Holds the songs, serves every screen, and runs the guest pages and printable cards. Needs Node.js.

ZIP · Node.js 18 or newer · ffmpeg for the tools

Download the server

Android will warn that the app comes from outside the Play Store and ask you to allow installs from your browser. That is expected for a direct download — allow it once and the install continues normally.

Installing on a TV box

TV boxes usually have no web browser, so the app cannot simply be downloaded on the box itself. Three ways round it, easiest first.

Easiest

Send it from your phone

Install Send Files to TV from the Play Store on both the phone and the TV box — it is free and takes a minute. Download the APK on your phone, send it across, then open it on the box with a file manager and install.

From a USB stick

Copy it across

Put the APK on a USB stick, plug it into the TV box, and open it with a file manager app such as X-plore or File Commander. Android will ask to allow installs from that app the first time.

If you have a computer

Install over the network

Turn on Developer options and USB debugging on the box, note its IP from the network settings, then from a computer with Android platform tools installed:

adb connect 192.168.1.50:5555
adb install -r aktivktv.apk

Replace the address with your box's own.

Whichever route you take, the box has to allow installs from outside the Play Store. It prompts the first time, and the setting sticks. Buying a venue system from us skips all of this — the boxes arrive with the app installed and pointed at your server.

Setting up a venue

Roughly half an hour, most of it copying songs.

  1. Install Node.js on the library computer

    Any small PC will do. Download Node.js 18 or newer from nodejs.org and install it with the default options.

  2. Unzip the server and start it

    Put the folder somewhere permanent, then open a terminal in it and run the server. It prints an address and an access token — you will need both.

    node server.js

  3. Copy your songs in

    Put your karaoke videos in the media folder, in whatever sub-folders you like. Then build the catalogue:

    node scan.js
node check.js

    check.js reports anything that will not play — missing files, wrong formats, duplicates, and files that would play silently on a TV box.

  4. Install the app on each screen

    Sideload the APK onto the Android TV box, open it, and enter the server address and token from step two.

  5. Set the screen up and print the cards

    Name the screen, decide whether guests request from their phones, and choose one card for the room or a card per table. Print once — the codes do not change.

Setting up a phone or tablet

A few minutes. No server involved.

  1. Copy songs onto the device

    Over USB from a computer, or from an SD card. Any folder works — something like AktivKTV/Media keeps it tidy. Around 10 GB holds a thousand songs.

  2. Install the app and allow it to see videos

    It asks once for permission to read videos, which is how it finds your songs without you hunting through a file browser.

  3. Pick your folder

    The app suggests the folder holding the most songs and skips camera and download folders. Confirm it and the library is ready.

  4. Turn on guest phones, if you want them

    The device hosts the room itself. Guests join its Wi-Fi hotspot and scan the code — no internet needed anywhere.

Naming your files Title - Artist.mp4 is enough. You can add tags in brackets — Halik - Aegis (OPM) (Tagalog).mp4 — and the app will file the song by genre and language.