TV Box Tools · Windows · Linux · Android phone · Chrome
Set up every TV from your laptop. One free tool does the box. You do the rooms.
TV Box Tools is the free, open‑source tool from the team behind Hotel TV — the same download people use at home to fix their HOME button. It talks to an Android TV box over the box’s own debugging connection, installs Hotel TV, links the TV to the room in your dashboard with the 8‑digit code, and hands the box over to the app. From then on Hotel TV owns the box: HOME pinned, settings behind your PIN, and a guest cannot undo it. Ten to fifteen minutes per box.
Free · Open source · Works with your Hotel TV account · Nothing to type on the TV by hand
What it does
The hand‑over, in plain words.
- Installs Hotel TV on the box, checking the file’s SHA‑256 first — nothing else, nothing you did not approve.
- Links the TV to the room with the 8‑digit code from your dashboard — the same code the TV shows on screen.
- Hands the box to Hotel TV, which becomes its owner: HOME is pinned and survives reboots and updates, settings, the store and the stock launcher are out of the guest’s reach.
- Your Admin PIN is the key: staff open the box for a few minutes, then it locks itself again.
- Verifies with the box after every step and shows every command it ran. Debugging can be switched off as the last step.
- The same tool, later, unlocks the box or puts the factory home screen back — with the same PIN.
How it works
Four steps, box by box.
Start from a fresh box
A box with no Google account added yet — Android lets an app own a box only when there are none. Turn on Developer options (About › Build number ×7) and USB or Network debugging.
Connect
From TV Box Tools on a Windows or Linux laptop or an Android phone on the same Wi‑Fi, or in Chrome with a USB cable. Press Allow on the TV once.
Say it is a property, enter the room’s code
The tool asks who you are. For a hotel or BnB it installs Hotel TV, links the TV with the 8‑digit code from your dashboard, sets your Admin PIN, and checks that the box agrees.
Hand over
Press HOME once. The tool can switch debugging off as its last step. From here on the room is managed from your dashboard.
A used box with a Google account on it has to be reset by you first — the tool checks and says so before it starts. It never resets a box for you.
What you need
Checklist before the first room.
- An Android TV or Google TV box (Android 9 or newer). Fire TV is not supported: it has no route for an app to own the box.
- A Hotel TV account with the property and its rooms — each room gives you a link code.
- TV Box Tools on a Windows or Linux laptop or an Android phone on the same Wi‑Fi as the box, or Chrome with a USB cable.
- Ten to fifteen minutes per box the first time; less once you have done one.
Download
TV Box Tools
One download for everyone — the tool people use at home is the tool you use for your rooms. The download page shows the file for your system, its size and its SHA‑256; the tool checks its own updates from there.
The Windows installer is not code‑signed yet, so SmartScreen will say “unknown publisher”. The SHA‑256 on the download page is how you check it is really ours.
FAQ
Questions from owners and installers.
Is this a different tool from the one at tvboxtools.com?
No — it is the same download. The tool asks who you are; for a property it takes the hotel road: installs Hotel TV, links the room, sets your PIN, hands the box over. There used to be a separate “TV Kiosk Manager”; it is gone, and everything it did is in TV Box Tools.
Where is the lock, then?
In Hotel TV itself. The app is the owner of the box — HOME always returns to it, settings sit behind your Admin PIN, the previous guest’s logins are wiped at check‑out. The tool installs and links; the app holds the box.
Do I need the tool for every TV?
Once per box. After that the room is managed from your dashboard — guests, Wi‑Fi, check‑out, messages. The tool comes out again only for a new box, to unlock one, or after a factory reset.
What if the box already has a Google account?
Android lets an app own a box only when there are no accounts on it. Reset the box (Settings › Device Preferences › Reset), skip the Google sign‑in, then run the tool. Hotel TV does not need a Google account on the box.
Can a guest undo it?
Not from the remote: settings, the store and the stock launcher are out of reach, and HOME always returns to Hotel TV. Only your staff with the Admin PIN, or the tool over debugging, can change it.
Rooms first, then boxes.
Create the property and its rooms in your dashboard; each room gives you the code the tool asks for.
Create your account