Topend Sports Logo

How to Create Custom Scripts

You can create your own test by modifying a current script file or writing a new custom script file. You simply create a text file in the same folder as the beeptest software, using the following commands:

Command Usage
START n Start or move to another stage/level, where n = stage number.
RUN n Run ‘n’ number of laps.
REST n Rest/Pause for ‘n’ seconds, usually for some specific sport practice activity.
REPEAT n Repeat a series of beeptest commands 'n' times.
LapDistance=n Set the lap distance in meters (default is 20)
Stage3Laps=n This is an example of setting the number of laps for a particular stage (stage 3 in this case). If this is not set, the standard beep test defaults are used.
Stage7Speed=n This is an example of setting the running speed for a particular stage (stage 7 in this case). If this is not set, the standard beep test defaults are used. Speed unit is km/hr.

Example Usage

The following simple example script instructs the test to start at level 5, then to run six laps followed by a 10s rest, repeated 100 times.


For more examples, see the custom script library.

Create a TXT file

Locate the Team BeepTest folder where the software is saved on your computer. In this folder there are text script files, such as 'Standard Beeptest Script.txt'. Make a copy of one of these, or create a completely new file. Write the script you require using the code as described on this page or examples on the script page.

Saving the Script

Save this as xyz script.txt (replace xyz with a meaningful name, and be sure to leave ‘script’ in the filename) into the beeptest folder, and your test will appear in the fitness test pull down menu on the main beeptest window.

Changing Sounds Too

You can also customize the rest voice over or even the sound of the beeps by simply recording your voice or sound into a wav file of the same name as those already used. If you make alternative recordings and wish to share them, I can put them onto this site. Please contact me with details.

Related Pages

send us a comment Any comments, suggestions, or corrections? Please let us know.

Testing Extra

We have over 400 fitness tests listed, so it's not easy to choose the best one to use. You should consider the validity, reliability, costs and ease of use for each test. Use our testing guide to conducting, recording, and interpreting fitness tests. Any questions, please ask or search for your answer.

 → How to Cite