ReST: High-Precision Soccer Player Tracking via Motion Vector Segmentation

1. App Deployment

• Clone the repository

git clone https://github.com/MrFahad/ReST.git

• Goto the cloned folder.

cd ReST

• Create a virtual envirnoment (Recommended, If you dont want to disturb python packages)

## For Linux Users
python -m venv ReST
source ReST/bin/activate

## For Windows Users
python -m venv ReST
activate

Steps to run Code:

python rest.py

streamlit run rest.py

Enjoy the app in localhost:8505

License

Copyright (C) 2026 Fahad Majeed.

This project is licensed under the GNU General Public License v3.0.

You may copy, distribute and modify this software under the terms of the GNU GPL v3. For full details, see the LICENSE file or visit: https://www.gnu.org/licenses/gpl-3.0.en.html

Citations

If you find GameFlow is useful in your research or applications, please consider giving us a star 🌟 and citing it.

@article{majeed2025real,
  title={Real-time analysis of soccer ball--player interactions using graph convolutional networks for enhanced game insights},
  author={Majeed, Fahad and Nazir, Maria and Swart, Kamilla and Agus, Marco and Schneider, Jens},
  journal={Scientific Reports},
  volume={15},
  number={1},
  pages={21859},
  year={2025},
  publisher={Nature Publishing Group UK London}
}

@article{majeed2026echonet++,
  title={EchoNet++: A multilingual soccer match audio commentary dataset: F. Majeed et al.},
  author={Majeed, Fahad and Nazir, Maria and Agus, Marco and Schneider, Jens},
  journal={Scientific Reports},
  year={2026},
  publisher={Nature Publishing Group UK London}
}

@inproceedings{majeed2024mv,
  title={Mv-soccer: motion-vector augmented instance segmentation for soccer player tracking},
  author={Majeed, Fahad and Gilal, Nauman Ullah and Al-Thelaya, Khaled and Yang, Yin and Agus, Marco and Schneider, Jens},
  booktitle={Proceedings of the IEEE/CVF Conference on Computer Vision and Pattern Recognition},
  pages={3245--3255},
  year={2024}
}

@inproceedings{majeed2025rest,
  title={ReST: High-Precision Soccer Player Tracking via Motion Vector Segmentation},
  author={Majeed, Fahad and Al Thelaya, Khaled Ahmed Lutf and Gilal, Nauman Ullah and Swart-Arries, Kamilla and Agus, Marco and Schneider, Jens},
  booktitle={Proceedings of the International Joint Conference on Computer Vision, Imaging and Computer Graphics Theory and Applications},
  volume={2},
  pages={138--149},
  year={2025},
  organization={Science and Technology Publications, Lda}
}