Initial commit

README.md

@@ -0,0 +1,134 @@
+# TapTapLoot Forwarder
+
+Forward keyboard input to [TapTapLoot](https://store.steampowered.com/app/your_app_id) running in Xwayland on Linux, so it can run in the background while you use other apps — similar to how BongoCat works.
+
+> **Based on [BongoCatXP](https://github.com/ITJesse/BongoCatXP) by ITJesse** — adapted for TapTapLoot with Xwayland support and dynamic xauth handling.
+
+## How it works
+
+TapTapLoot is launched in a rootful Xwayland instance (via a Steam launch script), which lets it run independently of your Wayland compositor. This tool uses `evdev` to read your keyboard at the device level and forwards keypresses to the TapTapLoot window via `xdotool`, without requiring the window to have focus.
+
+## Requirements
+
+- Linux (Wayland or X11)
+- Python 3.7+
+- `xdotool`
+- `xdotool` must be installed
+- Access to `/dev/input/` devices (via `input` group)
+- TapTapLoot running via the Xwayland launch script (see below)
+
+## Installation
+
+### 1. Install system dependencies
+
+```bash
+# Arch Linux / Bazzite / SteamOS
+sudo pacman -S xdotool python-pipx
+# or on immutable distros (Bazzite, SteamOS):
+ujust setup-decky  # if needed, then use distrobox or toolbox for pipx
+```
+
+### 2. Install this tool
+
+```bash
+# From this repo
+pipx install git+https://gitea.example.com/yourname/TapTapLootForwarder.git
+
+# Or from a local clone
+git clone https://gitea.example.com/yourname/TapTapLootForwarder.git
+cd TapTapLootForwarder
+pipx install .
+```
+
+### 3. Add yourself to the input group
+
+```bash
+sudo usermod -aG input $USER
+# Log out and back in for this to take effect
+```
+
+## Steam Launch Script
+
+Save the following as `~/.local/bin/taptaploot-forward.sh` and make it executable (`chmod +x`):
+
+```bash
+#!/bin/bash
+# Launches TapTapLoot in rootful Xwayland
+# Steam launch option: ~/.local/bin/taptaploot-forward.sh %command%
+
+for i in $(seq 10 30); do
+    if [ ! -e "/tmp/.X11-unix/X$i" ]; then
+        GAME_DISPLAY=":$i"
+        break
+    fi
+done
+
+GAME_XAUTH=$(mktemp /tmp/taptaploot-xauth.XXXXXX)
+COOKIE=$(mcookie)
+xauth -f "$GAME_XAUTH" add "$GAME_DISPLAY" . "$COOKIE"
+
+cleanup() {
+    kill "$XWAYLAND_PID" 2>/dev/null
+    wait "$XWAYLAND_PID" 2>/dev/null
+    rm -f "$GAME_XAUTH"
+}
+trap cleanup EXIT INT TERM
+
+XAUTHORITY="$GAME_XAUTH" Xwayland "$GAME_DISPLAY" -geometry 1920x1080 -noreset -auth "$GAME_XAUTH" &
+XWAYLAND_PID=$!
+sleep 1
+
+DISPLAY="$GAME_DISPLAY" XAUTHORITY="$GAME_XAUTH" "$@" &
+GAME_PID=$!
+
+wait "$GAME_PID"
+```
+
+Set your Steam launch option to:
+```
+~/.local/bin/taptaploot-forward.sh %command%
+```
+
+## Usage
+
+1. Launch TapTapLoot via Steam (using the launch script above)
+2. In a terminal, run:
+
+```bash
+taptaploot-forwarder
+```
+
+Keypresses will be forwarded to the game without it needing focus. Press `Ctrl+C` to stop.
+
+## Bazzite / Immutable Distro Installation
+
+On Bazzite, Nobara, or SteamOS (which use immutable root filesystems), the recommended approach is to use a **Distrobox container**:
+
+```bash
+# Create an Arch-based container
+distrobox create --name taptaploot --image archlinux:latest
+distrobox enter taptaploot
+
+# Inside the container:
+sudo pacman -S xdotool python-pipx
+sudo usermod -aG input $USER
+pipx install git+https://gitea.example.com/yourname/TapTapLootForwarder.git
+
+# Export the command to your host
+distrobox-export --bin ~/.local/bin/taptaploot-forwarder
+```
+
+Then run `taptaploot-forwarder` from your host terminal as normal.
+
+## Troubleshooting
+
+**Permission denied on `/dev/input/`** — make sure you've added yourself to the `input` group and logged out/in. Temporarily use `sudo taptaploot-forwarder`.
+
+**Window not found** — ensure TapTapLoot is running via the Xwayland launch script. The forwarder checks every 10 seconds.
+
+**No keyboard devices found** — permission issue, see above.
+
+## Credits
+
+- [BongoCatXP](https://github.com/ITJesse/BongoCatXP) by [ITJesse](https://github.com/ITJesse) — original implementation this is based on
+- MIT License