myRoupeiro 〜 soccer match data logger and analyzer 〜 How to use

myRoupeiro 〜 soccer match data logger and analyzer 〜 How to use


What is myRoupeiro?

“myRoupeiro” is a free app for supporting your video analysis of soccer matches.

  • Recording who, when, where and how was involved in the event from the video of the match and visualize the match results
  • Visualize various events such as shoots and passes in the game
  • Visualized results can be viewed interactively
  • The analysis results are saved in html files so you can view those on other devices or share them with your teammates
  • The data is saved in the csv file and xml file, so you can separately process those as you like and use those
  • You can record the data in detail, or you can roughly record only what you care about
  • Also supports a half-size court, can be used for analysis of youth soccer
  • Completely free app

This program was originally created by the operator of this site (me) to support video analysis of our team’s matches. myRoupeiro is an application version that anyone can use. (android app only)

myRoupeiro – soccer analyzer
Get it on Google Play

Roupeiro (Portuguese) is an important behind-the-scenes support for a soccer team, meaning a soccer team’s equipment clerk.

After that, named the app as myRoupeiro, hoping that it would be a useful tool to support your team.

We hope you can use the data analyzed by myRoupeiro for your daily practice and the next game etc.

It’s like this

Visualize the events during the match

  • Shots
  • Goals
  • Passes
  • Freekicks etc.

Take a look at the team data

  • Stats table
  • Team event data
  • Pass matrix

analyze individual data

  • Individual event data
  • Pass direction, distance, ratio of success / failure
  • Heat map
  • Event map

Follow the events during the match in chronological order


Data entry

record various events/results during the game with taps


  • Not include a video player
  • myRoupeiro is an application for recording and analyzing by paying attention to the player who played near the ball within the range that could be shot with a video camera.
    Therefore, it is not compatible with analysis such as the movement of the ball itself, the off-the-ball movement of players, and tracking data throughout the game.
  • a device with a large screen size, such as a tablet is recommended

How to use

<Data recording>

Record who, when, where and how was involved in the ball (we will call it an “event” here).

Launch and exit the app

Launch Just like launching a normal app, tap the icon to launch myRoupeiro

Just like exiting a normal app, tap the Android task button (□) to display the multitask screen, and swipe up myRoupeiro to exit.

Note: myRoupeiro does not have an auto-save feature. We recommend that you save your data frequently.

Screen description

Main screen

When you start the app, the main screen will be displayed. We can enter event data here.


Menu bar

*この図は横向き画面で表示していますThis figure is displayed on a landscape screen.
TitleEnter the title of the data to be analyzed
team settingsMoves to the team information input screen
import filesImport existing data files
get ext-filesImport the data file of myRoupeiro created on another terminal etc. so that it can be used on the terminal currently in use
hide adsYou can hide all ads for a period of time by completing watching a short video ad
manualGo to the manual page (external page = this page)
licenseshow the license
privacy policyGo to the privacy policy page (external page = another page of this blog)

Note: When the screen width is narrow, the menu may be hidden in ≡.

Video time input ・ First half / second half selection ・ Kickoff time input


Video Time・Enter the displaied time (hours, minutes, seconds) of the video in which the event you want to record occurred
*The up arrow to move forward one by one, the down arrow to go back one by one
1st period
/ 2nd period
Select the first half period or the second half period
(otherwise it is considered to be the first half)
KickoffEnter the kick-off year (last two digits of the year), month, day, and hours: minutes

Note: Since myRoupeiro assumes that we will record while watching the video, it is assumed that we use “video time”.


The name of my team / the name of the opponent team
*These are set on the my team settings screen and opp team settings screen
Enter the score of your team / opponent team
*final result is OK
The player list of my team / opponent team
*these are set on the my team settings screen / opp team settings screen
*Select the players involved in the event from here
*”Dest” is used to record the destination of the ball when there is no receiver for the ball
Area to specify where players were involved in the event on the pitch
clear dotsDeselect a player and erase the points drawn where they were involved in the event
change endsSwap the ends of both teams
pitch sizecoat size
*select normal size or half size from the drop-down list
*If not selected, it will be considered as normal size
*In the above figure, “Normal” cort size is already selected

Before event

The state of the ball before the event


ball holder; ball holder before the event

oneself oneself
allymy team players
oppopponent team players
loose ballLoose ball / no ball holder
drop balldrop ball
NoneNot applicable

ball state; Ball height condition

lowball in the air from pitch to head
highball in the air above the head


Event selection tab; type of event (9 types)

PASSEvents related to the passes
SHOTEbents related to the Shots
RECOVERYEvents related to ball recovery and clearance, etc.
FAULT RECEIVEDevents related to received fouls
SET PIECESet pieces, throw-ins, kick-offs, etc.
BALL OUTEvents which led to out of play
CHALLENGEChallenging plays such as pressing, tackles, duels and dribbles
CARRYDribbles (just for carrying the ball), traps or ball-keepings

Event content selection button; Buttons for selecting event contents

attemptSubcategory of event types (what was attempt to)
result1Success and failure (good / bad failure)
result2Content of the result (if applicable)
pressure state on the event
body partsBody parts involved in
Direct/IndirectDirect play or not
ball state afterBall height after the event
next playNext play after the event
next holderNext ball holder after the event

Other buttons / areas

add event buttonAdd the event data to the data table
︿ buttonClear the player selections and event points then move to the top of the screen
Notification areaMessage display area
stretch listExpand and display the data table
delete selected rowDelete the selected row of data table
Analyze!Run analysis of the data
Data tableTable for added events

Note; You can see the data content in a popup by long-tapping the data row

my team setting screen

A setting screen for my team; my team name, uniform numbers, player names and positions.


Menu bar

opp team settingsMove to the opp team setting screen to input opponent team information

Player information input area (up to 24 players)

#Shirts number
namePlayer name
posiPosition (select from dropdown list)

Player display area

Player display areaStarting members / substitutions

・ Double-tap the player icon to move the input cursor to the player information input area
・ Player positions and formation are not used for analysis, therefore not so important

opp team setting screen

A setting screen for opponent team; opponent team name, uniform numbers, player names, and positions.


Menu bar

back to mainBack to the main screen

Other elements are the same as the my team setting screen

How to record events

record with taps who, when, where and how was involved in the event from the video of the match

If you tap again on the selected button, the selection will be canceled.

1Enter the match title, kickoff time, score and pitch size
2Enter the team name and player information on the my team and opp team setting screen to return to the main screen
3Watching the video of the match, enter the time when the event occurred in Video Time
4Select first half period / second half period
5Select the player(s) involved in the event and tap the position in the pitch area

If there is a receiver of the ball (at the pass event etc.), select the receiver and tap the position where the ball was received (If there is no receiver of the ball due to failure etc., use “dest” instead of the player and tap the position the ball was destined)
*the ball passer always comes first to be inputed, the receiver comes next.
*clear dots button can be used to reset the player selections and the dots on the pitch area
6Select the ball holder and ball height before the event from Before event
7Select the event type from the Event Selection tab
8Select the each content from attempt to next holder
*If there is no applicable one, leave it as it is
9Press the add event button to add the event data to the data table
10Repeat 3 to 9
*contents can be selected in any order

If the events occuered at the same time, for example, if an interception event of the opponent’s ball led to a pass event immidiatey, it is better to treat and record those separately for two events, “recovery / intercept” and “pass”, respectively.

correction of event data

1Double-tap the row in the data table row you want to modify, you will be able to edit the event data.
The text of “add event” will change to “finish edit”
2When you have finished editing the event data, press the finish edit button to finish editing.

Note; If you long-tap a row of the data table, you can see the content of that row in a popup. To turn off the pop-up, tap anywhere on the screen.

Deletion of event data

1In the data table, tap a row(rows) to select for which you want to delete
2tap delete selected row button

Note; Deletion is irreversible, so be careful

Save data

Save the data.

1Tap save data on the menu bar
2Enter file names and tap the save button
3.xml and .csv files will be generated.
.xml filethis file stores match information and player information
.csv filethis file stores event data

・myRoupeiro does not have an auto-save feature. Saving your data frequently is recommended.
・The data is saved in the “Download” folder.

Import data

Import data files (.xml file, .csv file) generated by myRoupeiro

1Tap import data on the menu bar
2Select the .xml and .csv files to load and tap the load button
*You can also load files one by one

Loading external data

The myRoupeiro data created on other devices cannot be read as they are.

Therefore make those file readable for myRoupeiro on your using device.

1Tap get ext-files on the menu bar
2Select the .xml and .csv files (or one of them) created on other devices and tap the load button
3readable files for myRoupeiro on your using device are generated with “fetched-” added to the beginning of the file name.
4The generated files can be read from import data in the menu bar

<Data analysis>

Run analysis

Tap the Analyze! button to run the analysis then go to the Match Results screen.


Match Results screen

From this screen, you can show the results of each analysis.

Event DataEvent data analysis result
Team DataTeam data analysis results
Individual DataIndividual data analysis results
Time Series of EventsTime series of the events with positions where the event occurred

・Analysis results are saved in html files (data are saved in the “Downloads” folder), so you can check them on other devices with a browser and share them with your team.

<Event Data>

Data namedescription
GoalsEvents directly linked to the goal
CornersCorner kicks and the next events
FreekicksFree kicks and next events
ChallengesPress (including loose ones), duels, tackles and challenging dribbles
RecoveriesPass interceptions, ball recoveries, etc.
Turnoversswitching between offense and defense
For example, a pass was intercepted and the offense and defense changed, and so on
Shot AssistsEvent that assisted shots
AssistsEvent that assisted goals
PassesPositions of successful passers and receivers.
The arrow indicates the direction of movement of the ball
Passerspassers positions of successful passes
Receiversreceivers positions of successful passes


You can see the details in a popup when you mouse over the marker.

Example; Shots

rowexpression in pop-updescription
1(-23.32, -2.04)X-coordinate and y-coordinate with the center mark as the origin (0, 0) (approximate x-axis distance and y-axis distance (meters) from the origin)
2Time 52ʼ25”Video display time (does not match the elapsed time of the match)
3sane (no.10 Byern)Player name (number team name)
4oneselfBall holder before the event
5grounderBall height before the event
6SHOTEvent type
7SuccessSuccess or failure of the event (result1)
8GOALEvent result (result2)
9loose pressPressure status received at the time of the event (Other examples; yourself_on_partner)
10foot LPart played
11INDIRECTWhether it is direct play
12ON TARGETWhether it flew to the frame
13longThe flight distance of the ball after the event. long is about 30m above
14highBall height after the event (high; above the head)
15KICK OFFNext play after the event (if goal event, next play is kick off)

<Team Data>

Stats table

*Barcelona’s data were only recorded the essential events, so the pass numbers and success rates are different from actual.
BALL POSSESSIONBall retention rate (%)
*estimated from my team’s ball retention time
SHOTS(On target)Number of shots
*Including attempt of shots not touching the ball (result2; close to touch)
*Number of shots on target in parentheses
PASSES(Success)Number of successful passes. Success rate (%) in parentheses
The number of duel wins that are not aerial. Win rate (%) in parentheses
The number of duel wins in aerial. Win rate (%) in parentheses
CORNERSNumber of corner kicks
PENALTIESNumber of penalty kicks
CARDSNumber of cards issued

Tree Map

It summarizes all the events.

  • It is displayed separately in the first half and the second half.
  • There, the results sorted by event type are nested.
  • In addition, individual results are nested within each event.
  • The larger the area, the higher the number of events counted.
  • You can see the breakdown by tapping the nested part
    • Other breakdowns
      • Success / Good Failure / Bad Failure
      • Pressure condition (free / loose press / 1 on 1 / 1 on many / many on 1)
      • Body parts
      • Direct play/Indirect play
      • Ball direction
      • Ball distance (short / middle / long) etc.
        *You can also see the number of times the event was counted.
        *Please ignore “None”

Pass Matrix

A matrix table showing the passers and receivers of successful passes


*Vertical axis; passers / Horizontal axis; receivers

*The intensity of red is proportional to the number of passes

<Individual Data>

Individual data analysis results

Event tree mapEvents involving individuals and their breakdown
*You can see the details by tapping
Pass direction/distanceBreakdown of all passes
・number of passes
・success / failure ratio in that direction
*Regardless of the direction of the player’s body, the opponent’s goal line side is always on the top and the own goal line side is on the bottom
*From the inside of the circle
・ Short pass (approximately up to about 15m)
・ Middle pass (approximately from 15m to 30m)
・ Long pass (approximately 30m over)
*Color intensities are proportional to the number of passes
Heat mapPlayer’s positon and how many times involved in events
*The first half data and the second half data are shown so that the attack directions are the same.
Event mapPosition of event and type
*The first half data and the second half data are shown so that the attack directions are the same.
*You can turn points on / off by clicking the legend below.

<Time Series of Events>

You can check the events in chronological order along with the position of the event with animation.

The colors of the dots indicate the ball holder just before the event (based on the ball holder selected on the Before event).

●; my team’s ball

●; loose ball

●; opponent team’s ball

<Event definition / description>

*You can reinterpret and redefine these to make it easier to use according to your situation.

PASS; passes

Major classificationdescription
normalnomal passed
THROUGH BALLthrough ball
DEEP BALLHighball aimed at the back of the defense
Kick(GK)Passes by GK kick after catching the ball
Throw(GK)Passes by GK throw after catching the ball
VOLUNTARYReturned the ball Intentionally to the opposite team
OFFSIDEBe offside
CLEARANCEbe cleared
Loose ballLed to a loose ball
SAVEDSaved or caught the ball by the keeper
Mistake(opp)The quality of the pass was low, but it worked for some reason due to the mistake of the other party
Pass to oppsPassed to the opponent team
Aiming spaceFeed the ball as aiming a space
miskickMiskick / pass miss
OUTLed to out of play
INTERCEPTIONBe intercepted
REFEREE HITHit the referee

SHOT; shots

Major classificationDescription
SAVEDSaved or caught by a goalkeeper
WOODWORKHit the goal frame
OUTOut of the frame and goes to out of play
Close to touchNot able to touch the ball to shot (counted as a shot here)
REFEREE HITHit the referee
Direction Description
ON TARGETShot on goal
OFF TARGETShot out of goal

Recovery; Ball recofery

Major classificationDescription
Ball recoveryLoose ball / second ball recovery or intentional play
BLOCKEDBlocked shot / cross
Course blockProtect the ball by blocking the opponent’s direction
Catch(GK)GK caught the ball (when own team was defensive)
REFEREE HITHit the referee

FAULT RECEIVED; Received faults

Major classificationDescription
Get FKGot a free kick
ADVANTAGEAdvantage applied
PENALTYGot a penalty kick

BALL OUT; led to out of play

Major classificationDescription
CLEARANCECleared and made it out of play
VOLUNTARYmade it out of play Intentionally to stop play
FORCEDStop play by referee
END HALFEnd of first half / second half period
REFEREE HITHit the referee
MistouchFailed ball control and led to out of play
HAND BALLHand ball

SET PIECE; Set pieces

Major classificationDescription
GOAL KICKGoal kicks
FREE KICKFree kicks
FREE KICK SHOTFree kicks with intention to shot
CORNER KICKCorner kicks
THROW INThrow-in
KICK OFFkick offs
RETAKENRetaken a set piece
SAVEDSaved or caught by a goalkeeper
WOODWORKHit the frame
OUTOut of play as it is outside the frame
Aiming spaceFeed the ball as aiming a space
Own goalScored with own goal
ON TARGETShot on goal
OFF TARGETShot out of goal

CHALLENGE; Challenging plays

Major classificationDescription
pressingPressing (can be any kind of presses)
TACKLETackle s
DRIBBLEDribble (challenging)
GROUNDGround duels
AERIALAerial duels
ADVANTAGEApplied advantage
PENALTYGive a penalty kick
THEFTStolen the ball
WONWon a dual
LOSTLost a duel

Just for reference;
We record as “Success” for pressing with a noticeable good effect, “Bad failure” for pressing with a noticeable adverse effect, and “Good failure” for others.

CARRY; Carry/controll the ball

Major classificationDescription
DRIBBLEDribble(not challenging, just carrying)
TrapTrap the ball
keepKeep the ball
Ball outLed to out of play
THEFTStolen the ball
Loose ballLed to a loose ball


Event resultSuccessevent successful
Bad Failureunsuccessful due to “no good” play or poor quality
Good FailureIntentional and relatively good quality but unsuccessful
Pressure conditionFreeFree
Loose pressLoose pressure
1_on_1One-on-one or similar stuation
1_on_manyOne-on-many or similar situation
many_on_1Many-on-one or similar stuation
Opp_freeLet your opponent play for free (when your team is on the defensive side)
Body partsFoot R/Foot L/foot eitherRight foot / left foot / both or unknown
both handsBoth hands
hand RRight hand
hand LLeft hand
Direct playDIRECT/INDIRECTDirect/indirect play
Distanceshort/middle/long〜15m/15〜30m/30m〜 (approximately)
Ball heightgrounder/low/highGrounder / ground to head / above head
Next playinplayinplay
THROW INthrow in
GOAL KICKgoal kick
CORNER KICKcorner kick
FREE KICKfree kick
drop balldrop ball
PENALTYPenalty kick
KICK OFFkick off (as the next play after the goal)
lost scorelost srore
Next ball holdermy ball/opp ballmy team’s ball/opponent team’s ball
loose ballloose ball (i.e. no body)
Ball condition before the eventgrounder/low/highGrounder / ground to head / above head
ball holder before the event
allymy team
oppopponent team
loose ballloose ball
drop balldrop ball