Prerequisites and installing

Prerequisites

In order to use Tactigon Shapes, the following prerequisites need to be observed:

Linux

Linux Prerequisites:

• Hardware

  • CPU with AVX/FMA support
  • 8 Gb RAM
  • 32 Gb disk space
  • Bluetooth Low Energy (BLE): 5.0 minimum (5.3 reccomended)

• Software

  • Ubuntu 24.04
  • Docker Linux

Windows Subsystem for Linux (WSL)

If you want to use WSL you can but first you need to pass the Bluetooth controller from Windows to WSL, as it does not natively support hardware Bluetooth access.

1. Windows Host Configuration

Install the tools necessary to share USB devices with the WSL guest.

1. Install usbipd-win: Run in PowerShell (Administrator):

winget install --interactive --exact dorssel.usbipd-win

2. Reboot: Restart your PC to initialize the service.
3. Verify: Run usbipd in PowerShell to confirm the installation.

2. WSL Guest Configuration (Linux)

Install the Bluetooth stack (BlueZ) and USB utilities within your WSL distribution.

1. Update system:

sudo apt update && sudo apt upgrade -y

2. Install dependencies:

sudo apt install -y linux-tools-generic hwdata bluez bluetooth

3. Permissions (Optional): Grant your user control over Bluetooth devices:

sudo usermod -aG bluetooth $USER

3. Device Attachment

Identify and bridge your physical adapter to WSL.

1. Identify BUSID: In PowerShell (Admin):

usbipd list

Note the BUSID for the Bluetooth adapter (e.g., 2-14).

2. Bind the device: Authorized the device for sharing (required once):

usbipd bind --busid <BUSID>

3. Attach to WSL: Pass the device to the Linux environment:

usbipd attach --wsl --busid <BUSID>

If it fails, try turning off Bluetooth in the Windows system settings first.

4. Detach: To return the device to Windows:

usbipd detach --busid <BUSID>

You will have to attach and detach the controller everytime you want to use the Bluetooth in Windows or in WSL.  

4. Hardware Verification (WSL)

Confirm the adapter is active within the WSL terminal.

• Run hciconfig -a.

• If the status is DOWN, run: sudo hciconfig hci0 up.

• Correct status: UP RUNNING.

Install Tactigon Shapes

To install Tactigon Shapes you need to:

• Visit the repository and clone it
• Copy .xprofile file into your home folder

mv .xprofile ~/

• Open terminal in the same folder as where you saved docker-compose.yml and run

bash start.sh

Start Tactigon Shapes

Tactigon Shapes is set to auto start in your docker environment. Just visit the address http://0.0.0.0:5123 to see the UI.

---

Using Tactigon Shapes

Using Shapes is like building with LEGO bricks, you drag, drop, and connect pieces to create something functional. This section guides you step-by-step on how to use shapes.

Once you are on the Shape interface, you can see some of our example shapes, such as Powerpoint, Braccio voice, and so on. On the left side, you will see all your shapes, and on the right side, you can see a snapshot of your shape.

How to use Shapes

Before we begin, make sure your T-Skin is connected to the Tactigon Shapes app. For instructions on how to connect your device, click here

Creating a New Shape:

1. Click Add Shape.
2. Enter a unique shape name and description.
3. Add the shape to open the editing workspace.
4. Drag blocks from the left pane to the workspace to build your logic.
5. Click Save to save your shape.

create_new_shape.mp4

Editing an Existing Shape:

1. Select a shape from the homepage.
2. Click Edit Code to modify the shape.
3. Save your changes after editing.

Think of blocks like puzzle pieces. This means you can now connect them by dragging one block and placing it under or inside another block. However, ensure that your shapes snap together; otherwise, the program will not execute.

edit_shape.mp4

Run Your First Shape

• When you are done building, click the toggle button to see what your program does.
• You will see a page with both your shape and the terminal with the output.

run_first_shape.mp4

Deleting a Shape:

• Click the bin icon next to the shape name to delete it.

How to run our Tactigon Shapes:

We’re diving into how you can control PowerPoint presentations with just a few simple gestures.

Here’s how it works: When you tap and hold, it toggles the presentation into full-screen mode. A single tap takes you to the previous slide, and a twist gesture moves you to the next slide. It’s super intuitive and easy to use. I’ve got a basic PowerPoint open with a few slides. I’ll open the Tactigon Shapes app, click the toggle icon to start the program, and you’ll see both your shape and the output on the same screen.

Now, I’ll wear the TSkin and open the PowerPoint app. Watch this—tap and hold, the presentation goes full screen. if you want to move to the next slide, do twist gesture. Need to go back? A single tap does the trick.

Ater your presentation, don’t forget to stop the program after your awesome presentation.

how_to_use_tactigon_shape.mp4