FTC Auto Logger

KoalaLog is a logging framework for FTC robots that generates .wpilog files fully compatible with Advantage Scope. It enables rich telemetry and data capture — just like in FRC.

join the discord https://discord.gg/XunReBq5

---

🚀 Getting Started

To get started with KoalaLog, follow the setup instructions in the wiki:

📖 KoalaLog Wiki

• How to Add to Your FTC Project
• How to Use in Your Code
• How to Get the Log

---

📦 Project Structure

KoalaLogger

The core runtime library used in your robot code:

• AutoLogManager.java – Registers and manages all loggable instances.
• WpiLog.java – Manages .wpilog files, handles timestamps, and serializes data.
• Logged.java – Interface for objects that should be recorded in the log.

KoalaLoggingProcessor

Annotation processor for generating logging boilerplate:

• Automatically processes @AutoLog annotations.
• Generates Logged interface implementations at compile time.

LogPuller

Tools to retrieve logs from the Control Hub over ADB:

• FTCLogPuller.exe – Pull logs without deleting.
• PullAndDeleteLogs.exe – Pull logs and clean up the hub afterward.

LogPullerDevelopment

Build system and scripts to generate .exe tools:

• PowerShell scripts used for packaging.
• build_exe.bat – Converts .ps1 scripts to .exe using PS2EXE.

---

🙌 Contributions & Support

Want to improve or contribute? Found a bug?
Open an issue or a pull request here: https://github.com/ori-coval/Koala-Log