JudoTimer is a scoreboard and timer program that you can use as a standalone application or together with the JudoShiai. In the picture below JudoTimer has received information about the next matches. Contestants and the weight category are shown.




Automatic Rest Time

JudoShiai communicates the possible rest time when needed. The clock starts to count down using red numbers. Also name of the competitor is shown.

New Match

Choose an option from the Contest menu to start a new match.



Menu option




Contest duration from the JudoShiai program


2 min (short pin times)

Contest time is 2 min with short osaekomi times


2 min

Contest time is 2 min


3 min

Contest time is 3 min


4 min

Contest time is 4 min


5 min

Contest time is 5 min


Golden Score

Menu for the golden score time

Golden Score

JudoTimer will suggest the golden score itself. However, you can select it also from the Contest menu. In the pop-up menu there are times from one minute to five minutes and the automatic setting from the JudoShiai program.


In case of referee voting you have to tell the result by choosing the Contest menu option Hantei: Blue Wins or Hantei: White Wins.


Hansoku-make in JudoTimer gives the winner 10 points. Competitor can continue in the tournament. Note: Hansoku-make in JudoShiai disqualifies competitor and he/she cannot continue the tournament.

Clocks and Scoreboard

You can control clocks and scoreboard by using both the keyboard and mouse.


Shiai clock start/stop:

Click the shiai clock numbers or press the space bar.

Osaekomi clock start/stop:

Click the osaekomi clock numbers or press the Enter key.


Click the ”SONOMAMA” text or press the 's' key. To start the clocks redo the previous or click the shiai or osaekomi clocks.


Click the scoreboard number or use the keys:


Ippon for blue


Waza-ari for blue


Yuko for blue


Shido for blue and score white


Ippon to white


Waza-ari to white


Yuko to white


Shido to white and score blue


Remove score:

Remove a score by
- holding down the shift key while clicking or pressing a function key; or
- right-clicking the scoreboard.

Osaekomi scores:

After the osaekomi clock has been started you have to tell who is scoring. Click the blue or white area to the right of the osaekomi clock or press the up or down-key. The program adds the ippon automatically to the scoreboard and stops the clocks. Otherwise the points flash on the display and you have to give them manually by clicking the scoreboard or using the arrow keys.


You can change the looks and functionality of the program from the Preferences menu.


Menu option


Red Background

Change blue scoreboard background red.

Full Screen Mode

Display fills the whole screen.

No Koka

Koka is not used. The first shido doesn't score the opponent.

Leave Points for GS

Golden Score doesn't reset the scores.

If Equal Score Less Shido Wins

At the end of the fight, if scoring is equal, the one with less Shido wins.

Stop Clock on Ippon

Soremade ends the fight and stops the clock, not the ippon. Check this if you want ippon automatically stop the clock.

Confirm New Match

Confirmation for a new fight is asked in suspicious cases. Check this if you always want a confirmation question.

IPPON texts

No notification texts after ippon or the time ends.

Show Competitors

Show names of the competitors at the beginning of a new fight.

Display Layout

There are many possibilities to choose the display layout. You can create your own layout by editing a text file. Please see appendix X.

Name Format

Select how competitor's name should appear.

Contest Area

When communicating with the JudoShiai the program must know on which contest area it is used.

Communication Node

Normal usage: Set the address of the JudoShiai program.
Usage as a slave: Set the address of the master JudoShiai program.

Note: IP address makes programs find the correct address themselves.

Own IP Addresses

Check IP addresses of this computer.

Video Server

Set address for a MJPEG video server.

VLC Control

Embed score points and clocks on video stream.

Set Time

Correct the clocks either by one second at a time or everything at once. Works only when the clocks are not running.


You can create a master/slave pair to have two displays. Use master in the operated JudoTimer and slave in the other.


Select a folder containing PNG and GIF picture files. When a match starts one of the pictures is shown on the display for a couple of seconds.


Select a sound file to play on certain occasions (soremade, ippon).


Video Replay

You may connect JudoTimer to a video stream. Every time you stop the clock about 30 sec of the video will be saved in the memory. To display the video press the V button or select from the menu Contest → Video Replay. Video will start in a new window 5 seconds before the end. There are buttons for play, pause, reverse, slow motion, display live video, and close the window. You may use a slider to look at certain frames when the video has been paused.

To create a server connection set the URL in the menu Preferences → Video Server. Video server's URL has the format
for example:

The values depend on your video server. If you run the server in the same computer the address is Only the basic authentication is supported, but it should be enough for the most IP cameras.

Motion JPEG (M-JPEG) video is supported only. It is an informal name for a class of video formats where each video frame is separately compressed as a JPEG image. Originally developed for multimedia PC applications, where more advanced formats have displaced it, M-JPEG is now used by many portable devices with video-capture capability, such as digital cameras. Many network-enabled cameras provide M-JPEG streams that network clients can connect to.

HTTP streaming separates each image into individual HTTP replies on a specified marker. For M-JPEG streams the JPEG data is sent to the client with a correct HTTP-header. The TCP connection is not closed as long as the client wants to receive new frames and the server wants to provide new frames.

There exist network-enabled M-JPEG cameras with a build-in HTTP server. Still it may be easier and less expensive to have an USB web cam and server software running in the same computer.

VLC requires quite a lot of CPU power. In general you have to find out the correct balance between the picture quality (size, frames/sec) and the available CPU power. Appendix 5 has more information about how to set up a video server.

Note: This is not a substitute for a real referee camera! A cheap static camera most probably misses all the action details. Competitors are either too small or out of the picture. However, if somebody takes care of the shooting this feature may have some entertainment value for the audience and even referees may use it in less important tournaments that are not equipped with real cameras.

Log File

JudoTimer writes events to a log file. Log file name has the format


In Windows it is located in the folder


In Linux it is located in the directory


A new log file is created every time JudoTimer is started. The file looks as follows:

13:30:42 [-:--] <10002-03> Automatic next match 10003:1 (Heimo LUMME, Otalammen Judokat - Kristoffer ALA-KUJALA, Yukolan judoseura)

13:30:44 [3:00] <10003-01> MATCH START: CP-50: Heimo LUMME, Otalammen Judokat - Kristoffer ALA-KUJALA, Yukolan judoseura

13:30:44 [3:00] <10003-01> Shiai clock start

13:30:47 [2:56] <10003-01> Ippon to blue: IWYKS = 10000 - 00000

13:30:47 [2:56] <10003-01> CP-50: Heimo LUMME, Otalammen Judokat wins by 3,190000 s Ippon)!

13:30:47 [2:56] <10003-01> CP-50: Heimo LUMME, Otalammen Judokat wins by 3,190000 s Ippon)!

13:30:49 [2:55] <10003-01> Shiai clock stop

13:30:49 [2:55] <10003-01> CP-50: Heimo LUMME, Otalammen Judokat wins by 4,897000 s Ippon)!

13:30:51 [-:--] <10003-01> Automatic next match 10003:2 (Teemu NIEMELÄ, Otalammen Judokat - Volodymyr GULBANI, Salmen Judokat)

13:30:54 [3:00] <10003-02> MATCH START: CP-50: Teemu NIEMELÄ, Otalammen Judokat - Volodymyr GULBANI, Salmen Judokat

13:30:54 [3:00] <10003-02> Shiai clock start

13:30:56 [2:57] <10003-02> Osaekomi clock start

13:31:13 [2:40] <10003-02> Osaekomi clock stop after 16,958000 s

13:31:16 [2:38] <10003-02> Shiai clock stop

13:31:17 [2:37] <10003-02> Osaekomi score to white: IWYKS = 00000 - 00100

13:31:20 [2:37] <10003-02> Shiai clock start

13:31:28 [2:30] <10003-02> Shido to white: IWYKS = 00000 - 00101

13:31:30 [2:27] <10003-02> Shido to white: IWYKS = 00100 - 00102

13:31:34 [2:23] <10003-02> Ippon to white: IWYKS = 00100 - 10102

13:31:34 [2:23] <10003-02> CP-50: Volodymyr GULBANI, Salmen Judokat wins by 36,426000 s Ippon)!

13:31:34 [2:23] <10003-02> CP-50: Volodymyr GULBANI, Salmen Judokat wins by 36,426000 s Ippon)!

13:31:35 [2:22] <10003-02> Shiai clock stop

13:31:35 [2:22] <10003-02> CP-50: Volodymyr GULBANI, Salmen Judokat wins by 37,497000 s Ippon)!

13:31:39 [-:--] <10003-02> Automatic next match 10004:3 (Staffan NYBERG, Salmen Judokat - Erkki ELORANTA, Salmen Judokat)

At first there is the real time and then the remaining shiai time. Next there is the category code and the match number. At the end there is the event description.