Learn how to set up Vendoke

HOW TO SET KIOSK MODE (DEVICE OWNER)

Before you start

  • Use a new or factory-reset Android tablet. Device Owner can only be set before any Google account is added.
  • Do not sign in to Google, Samsung or any other account during setup. If one is already added, remove it first or factory reset.
  • Use a USB cable that carries data (not a charge-only cable).
  • A Windows PC.

Step 1. Download the files

  • Download the Vendoke app from the Download page.
  • Download ADB (Platform Tools) and unzip it to a folder, for example Desktop\tools\adb.
  • Copy the app into the same folder and rename it exactly to vendoke.apk (the download is named vendoke-v1.apk).
The folder should contain: adb.exe, AdbWinApi.dll, AdbWinUsbApi.dll, fastboot.exe and vendoke.apk.

Step 2. Turn on USB debugging on the tablet

  1. Open Settings > About tablet and tap Build number 7 times to enable Developer options.
  2. Open Settings > Developer options and turn on USB debugging.
  3. Connect the tablet to the PC with the USB cable.
  4. On the tablet, tap Allow on the "Allow USB debugging?" prompt (tick "Always allow from this computer").

Step 3. Open Command Prompt in the adb folder

Open the adb folder in File Explorer, click the address bar, type cmd and press Enter.

Step 4. Check the tablet is connected

adb devices

You should see your device with the word device beside it. If it says unauthorized, accept the prompt on the tablet. If the list is empty, change the USB cable or port.

Step 5. Install the app

adb install -r vendoke.apk

Wait for Success.

Step 6. Set Vendoke as Device Owner

adb shell dpm set-device-owner com.kwarton.vendoke/com.kwarton.ikaraoke.KioskDeviceAdminReceiver

You should see: Success. Device owner set to package com.kwarton.vendoke

Step 7. Open the app

Open Vendoke on the tablet. The app now runs in locked kiosk mode: the home, back and recent buttons and the status bar are blocked, so customers cannot leave the app.

Troubleshooting

  • "Not allowed to set the device owner because there are already some accounts on the device" - remove every account in Settings > Accounts, or factory reset the tablet, then repeat Step 6.
  • "already several users" or "already provisioned" - factory reset the tablet and do not finish the Google setup, then repeat from Step 2.
  • "device is not connected" or "no devices" - reconnect the cable, run adb kill-server and then adb devices again.
  • "INSTALL_FAILED_..." - make sure the file is named vendoke.apk and you are running the command inside the adb folder.

How to leave kiosk mode (for service)

Open the admin settings in the app, enter your admin passcode (default 1234) and use the exit option. To remove Device Owner completely, uninstall the app or factory reset the tablet.

HOW TO CONNECT THE VENDOKE REMOTE APP

Use your phone as a wireless remote for the Vendoke kiosk. You can pick songs, change the key and tempo, and set the volume from your seat.

What you need

  • The Vendoke app running on the tablet.
  • The Vendoke Remote app installed on your Android phone.
  • Both devices on the same Wi-Fi, or the device connected to the tablet's / phone's hotspot.

Step 1. Turn on the remote on the tablet

  1. Open the Vendoke app on the tablet and go to Admin (enter your passcode).
  2. Open Remote in the sidebar.
  3. Turn the remote ON.
  4. The page now shows a QR code and a 6-digit pairing code.

Step 2. Connect from the phone

  1. Open Vendoke Remote on the phone.
  2. Tap Scan QR code and point the camera at the QR code on the tablet. It connects by itself.
  3. If you cannot scan, tap your tablet in the list, then enter the 6-digit code and tap Pair.
You only pair once. Next time, the remote reconnects to the tablet when you open it.

Step 3. Use the remote

  • Number keys: type the song number, then tap ADD SONG.
  • Clear / Back: erase the number you typed.
  • Next: skip to the next song.
  • Restart: play the current song again from the start.
  • Mute: silence or restore the sound.
  • Volume + / -: change the tablet's volume.
  • Key + / - and Tempo + / -: make a song higher or lower, faster or slower. Tap the number in the middle to go back to normal.

Not seeing Key and Tempo?

On the tablet, open Admin > Lyrics and turn on Tempo and key control.

Troubleshooting

  • The tablet is not in the list: check that both devices are on the same Wi-Fi, then use Scan QR code or type the tablet's address shown in Admin > Remote.
  • Wrong pairing code: use the current code shown in Admin > Remote. If you tapped "new code" on the tablet, pair again.
  • Buttons feel slow: move closer to the router, or connect the phone to the tablet's hotspot.
  • Remote stopped working: make sure the remote is still turned ON in Admin > Remote on the tablet.

Remove a phone

In Admin > Remote on the tablet, use Revoke all to unpair every phone, or New code to start fresh.