Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/supercilex/robot-scouter

:robot: Easy, efficient, and collaborative FIRST robot scouting
https://github.com/supercilex/robot-scouter

android firebase first first-robotics-competition frc frc-scouting robot-scouter robotics robotics-competition robotics-scouting scouting spreadsheet the-blue-alliance

Last synced: 2 months ago
JSON representation

:robot: Easy, efficient, and collaborative FIRST robot scouting

Host: GitHub
URL: https://github.com/supercilex/robot-scouter
Owner: SUPERCILEX
License: gpl-3.0
Created: 2016-09-18T00:04:05.000Z (over 8 years ago)
Default Branch: master
Last Pushed: 2022-12-12T04:08:34.000Z (about 2 years ago)
Last Synced: 2024-05-02T01:48:01.230Z (8 months ago)
Topics: android, firebase, first, first-robotics-competition, frc, frc-scouting, robot-scouter, robotics, robotics-competition, robotics-scouting, scouting, spreadsheet, the-blue-alliance
Language: Kotlin
Homepage: https://bit.ly/RobotScouter
Size: 151 MB
Stars: 106
Watchers: 11
Forks: 41
Open Issues: 47
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

        


    

        

    





    Robot Scouter





    Easy, efficient, and collaborative FIRST robot scouting





    

        

    





    

         

    



Robot Scouter is an open-source Android app with three core goals:

to make FIRST competition robot scouting _easy_, _efficient_, and _collaborative_.



    

        

    



## Table of Contents

- [Features](#features)

  - [Highlights](#highlights-)

  - [Scouting](#scouting-)

  - [Templates](#templates-)

  - [Exporting](#exporting-)

- [Contributing](#contributing-)

  - [Updating templates](#updating-templates-️)

  - [Learning](#learning-)

- [Environment setup](#environment-setup-)

- [Psst...](#psst-)

## Features

### Highlights ✨

- Full offline support 📡

- No setup required (i.e. no databases)

- Customizable scouting templates

- Advanced export capabilities

- Integration with [The Blue Alliance](https://www.thebluealliance.com)

### Scouting 📃

- Simple yet powerful collaboration both within and between teams 🔗

- Multiple people can scout the same team, different teams, or go solo on Android N and use split

  screen mode to scout several teams at once 😎

- Numerous metrics to choose from:

  - Header (title) 🔖

  - Checkbox (true/false) ✅

  - Stopwatch (for keeping track of cycle time) ⏱️

  - Counter (numerical) 🔢

  - Item selector (list) 📝

  - Notes (textual) 📜

### Templates 📋

- Fully customizable and independent from each year's game

- Defaults are provided for the current year's game

### Exporting 📊

- Advanced spreadsheet exporting:

  - Statistics and charts are automatically generated for each team

  - A global average sheet is included to compare teams against each other

  - Fancy formatting on devices with Android Lollipop (API 21) and above

- PSA: Excel spreadsheets can easily be

  [converted to Google Sheets](https://support.google.com/docs/answer/6055139)

- JSON exports are also supported for custom analysis (e.g. in Tableau)

## Contributing 💗

Want to add features, fix bugs, or just poke around the code? No problem! Just make sure to read

the [contribution guidelines](CONTRIBUTING.md) before getting in too deep.

If you know another language, please help

[translate Robot Scouter](https://www.transifex.com/supercilex/robot-scouter/)!

### Updating templates ⬆️

Anyone can do it! Simply follow

[the instructions](https://github.com/SUPERCILEX/Robot-Scouter/blob/master/app/server/functions/src/main/kotlin/com/supercilex/robotscouter/server/functions/Templates.kt)

throughout the file and send a pull request with your changes.

### Learning 📚

- Get familiar with [Firebase](https://firebase.google.com) to understand the core technologies behind Robot Scouter

- Take careful note of [Firestore](https://firebase.google.com/docs/firestore/) and

  [Firebase-UI](https://github.com/firebase/FirebaseUI-Android)

## Environment setup 💻

1. Run `./gradlew setup`

1. If you are working with Firestore or need access to other Firebase technologies,

   [create your own Firebase project](https://firebase.google.com/docs/android/setup)

   and replace the dummy [google-services.json](ci-dummies/google-services.json) with the one

   created in your Firebase project

1. Run `./gradlew presubmit` to make sure the CI build will pass

1. That's it! 🚀

## Psst... 🤐

If you want to get the latest build from master, you can join the

[alpha testers group](https://groups.google.com/forum/#!forum/supercilex-alpha-testers)

and the [beta](https://play.google.com/apps/testing/com.supercilex.robotscouter).