Package to ring & talk to your Tile Tracker
This project is the result of countless hours of reverse engineering the Tile bluetooth protocol.
If you like my work, give this repository a ⭐
or consider Buying Me A Coffee ☕
npm install node-tile
This package can uses noble. This means you require a bluetooth adapter.
To configure noble, see below
No additional configuration is required.
(Source) To use this package on linux, you will have to run the script as root to get access to your bluetooth adapter. Otherwise you will get the error that the noble adapter's state is unauthorized.
You can also fix this by running the following command:
sudo setcap cap_net_raw+eip $(eval readlink -f `which node`)
This grants the node
binary cap_net_raw
privileges, so it can start/stop BLE advertising.
Note: The above command requires setcap
to be installed.
It can be installed the following way:
- apt:
sudo apt-get install libcap2-bin
- yum:
su -c \'yum install libcap2-bin\'
You will have to checkout the noble documentation on how to configure NodeJS to use a Bluetooth Adapter.
See example.js. Once you have a connected service, you can do the following:
Make your tile ring:
await service.sendRinger(TileVolume.MED)
Program the default ring tone:
await service.sendRinger(TileVolume.MED)
Run some code on a single tab on your tile's button:
service.on("singleTab", _ => console.log("Got single tab!"))
Double tab:
service.on("doubleTab", _ => console.log("Got double tab!"))
On signal strength/RSSI update reported by bluetooth adapter
only supported by noble, NOT node-ble
service.on("rssi", rssi => console.log("rssi", rssi))
On signal strength/RSSI update reported by your tile
service.on("tileRssi", rssi => console.log("tileRssi", rssi))
Get debug output:
service.on("debug", msg => console.log("debug", msg))
- Make your Tile ring
- Get the signal strength to your Tile (only available using noble)
- Act on the event you single click your Tile button
- Act on the event you double click your Tile button
- Program the "Bionic Birdie" song
- Tile Slim 2024
- Tile Slim 2022
- Tile Pro 2022
- Tile Mate 2022
This package may not work with all Tiles as the protocol changes over time. Also the level of success may vary depending on your bluetooth adapter and tile.