diff --git a/.gitignore b/.gitignore
index e43b0f988..1992df166 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1 +1,28 @@
+# macOS system files
.DS_Store
+
+# Python venv
+.venv/
+
+# Jupyter
+*.ipynb
+.ipynb_checkpoints/
+
+# Python cache
+__pycache__/
+*.pyc
+*.pyo
+
+# Data / outputs
+data/
+out/
+runs/
+
+# IDEs
+.vscode/
+.idea/
+
+# Model weights & large files
+*.pt
+*.pth
+*.zip
\ No newline at end of file
diff --git a/Player_Tracking/afl_player_tracking_and_crowd_monitoring/player_tracking_logic/README.md b/Player_Tracking/afl_player_tracking_and_crowd_monitoring/player_tracking_logic/README.md
new file mode 100644
index 000000000..ca1cf27bf
--- /dev/null
+++ b/Player_Tracking/afl_player_tracking_and_crowd_monitoring/player_tracking_logic/README.md
@@ -0,0 +1,98 @@
+\# AFL Player Tracking Logic
+
+
+
+This folder contains scripts developed for the Redback Project AFL Player Tracking system.
+
+These scripts support syncing, merging, evaluating, and analyzing AFL player tracking and event data.
+
+
+
+\## š Scripts
+
+
+
+\- \*\*annotation\_converter.py\*\*
+
+ Converts annotation formats into a consistent structure for further processing.
+
+
+
+\- \*\*annotation\_sync.py\*\*
+
+ Syncs manual event annotations with YOLOv8 + DeepSORT tracking outputs.
+
+
+
+\- \*\*event\_timing\_analysis.py\*\*
+
+ Analyzes and visualizes the timing of events across match footage.
+
+
+
+\- \*\*merge\_synced.py\*\*
+
+ Merges multiple synced annotation files into a single dataset.
+
+
+
+\- \*\*prediction\_vs\_truth.py\*\*
+
+ Evaluates predicted events against ground truth annotations, producing precision/recall metrics.
+
+
+
+---
+
+
+
+\## Usage
+
+
+
+Each script can be run independently from the command line:
+
+
+
+```bash
+
+python annotation\_converter.py