Telegram Bot Setup

Control your Tux Droid from anywhere via Telegram.

Setup Guide

1Create a Bot

  1. Open Telegram and search for @BotFather
  2. Send /newbot
  3. Choose a name (e.g., “My Tux Controller”)
  4. Choose a username ending in “bot” (e.g., “my_tux_bot”)
  5. Copy the bot token (looks like 123456789:ABCdefGHIjklMNO...)

2Get Your Chat ID

  1. Search for @userinfobot in Telegram
  2. Send /start
  3. Copy your numeric Chat ID

The Chat ID is used for security - only messages from this ID will be accepted.

3Configure in ScayTux

Launch ScayTux and go to Telegram Control → Configure Bot:

bash
java -jar target/ScayTux.jar
# Select: 3 (Telegram Control)
# Select: 1 (Configure Bot)
# Enter your bot token and chat ID

Configuration is saved to telegram_config.json for persistence.

4Start the Bot

Select Start Bot from the Telegram menu. Then open Telegram and send /start to your bot. You will see an inline keyboard with all controls!

Bot Commands

CommandDescription
/startShow main menu with inline keyboard buttons
/connectConnect to Tux Droid hardware
/disconnectDisconnect from Tux Droid
/statusCheck connection and music status
/flapFlap wings
/blinkBlink eyes
/danceDance animation
/say <text>Make Tux speak with lip sync
/combo<n>Run a combo (1-55)
/musicShow music menu
/stopStop music playback
/helpShow help message

Features

Inline Keyboards

Navigate menus with button taps - no typing needed.

Security

Only your authorized Chat ID can control the bot.

Background Mode

Bot runs in the background while you use other features.

Music Control

Play/stop music and trigger dance combos remotely.