VoiceAttack Profile Manual

Changelog .................................................................................................................................................... 2
Contributors .................................................................................................................................................. 2
Installing the profile....................................................................................................................................... 3
Introduction and disclaimer ....................................................................................................................... 3
Train the Windows speech system ............................................................................................................ 3
Prepare Arma for Speakeasy .................................................................................................................... 5
“Select all units” alternative ....................................................................................................................... 5
Install VoiceAttack ..................................................................................................................................... 5
Install Speakeasy ...................................................................................................................................... 6
Install the Speakeasy Arma 3 user profile (optional) ................................................................................. 9
Keyboard and language settings ............................................................................................................. 11
Keybinding within Arma........................................................................................................................... 12
Editing the profile ........................................................................................................................................ 13
Change the keys that are pressed within a command ............................................................................. 13
Creating a new command from a template .............................................................................................. 18
Enabling feedback .................................................................................................................................. 24
Changing how to speak an existing command ........................................................................................ 28
Updating an existing and/or modified Speakeasy profile ............................................................................. 31
Commands to control the profile ................................................................................................................. 37
Help by voice .............................................................................................................................................. 38
Advanced AI commands ............................................................................................................................. 39
Fluid Commands ..................................................................................................................................... 39
Roles ...................................................................................................................................................... 40
Focus ...................................................................................................................................................... 41
Compound commands ............................................................................................................................ 41
Task Force Radio and ACRE2.................................................................................................................... 42
 To use Task Force Radio ........................................................................................................................ 42
To use ACRE2 ........................................................................................................................................ 42
The Speakeasy training scenario................................................................................................................ 43
General info about the Speakeasy key sheet.............................................................................................. 43
A few thoughts about spoken commands ................................................................................................ 43
Use the key sheet to make your own version of Speakeasy .................................................................... 44
Preparation .......................................................................................................................................... 44
Work with your key sheet and profile ................................................................................................... 45
Result .................................................................................................................................................. 45
Translating the profile ................................................................................................................................. 45
Troubleshooting .......................................................................................................................................... 46
Miscellaneous ............................................................................................................................................. 47
Links ....................................................................................................................................................... 47
Contact us............................................................................................................................................... 47
Mail Alpha-Kilo: alpha.kilo@zoho.eu........................................................................................................... 47

Changelog
Latest Release: Click to download
Version 2.0 published 2018-12-25
New: Fluid Commands
New: New training scenario
New: Three more keyboard layouts
New: Several custom commands
Updated: All commands as necessary

Version 1.0 published 2017-10-10

Release: Click to download

Contributors
Profile, English woofer
Profile, German Alpha-Kilo
Profile, framework woofer
Profile, special commands woofer
Key Sheet, English Alpha-Kilo
Key Sheet, German Alpha-Kilo
Manual, English woofer and Alpha-Kilo
Training Scenario, design Alpha-Kilo
 Training Scenario, scripting woofer
Advertisement, English Alpha-Kilo
Advertisement, German Alpha-Kilo
Logo nomisum
"Select all units" alternative JoJoTheSlayer
Australian keyboard layout Benji and Rockapes
Danish keyboard layout Prestien

Installing the profile

Introduction and disclaimer

This manual will help you get going with Speakeasy. It will also guide you on how to make changes
to it.
Use Speakeasy at your own risk. It is provided as is, without warranty of any kind. The authors are
not responsible for any direct, indirect, incidental or consequential damage of any kind, without
limitation.

Train the Windows speech system

Before you even start to install any third-party application you have to make sure that the Windows
speech system is trained to understand you properly. This has to be stated because it can make or
break your experience.
Use the training option for the windows speech recognition. It may or may not be obvious, but it's
not you who is being trained, but the computer. Each time you run the training session the system
gets more acquainted with your voice and your way of speaking. It then adjusts itself to better pick
out words from what you speak into the mic.
Do it once or twice the first time, but after some time playing with voice commands, make sure to
have spent at least an hour or so on it in total. It’ll really make a difference. If you find that windows
speech is having trouble understanding you, then try to speak as you would while playing. Usually
that is a lower and duller way of speaking - not like a newscaster as the training session tells you.
To accomplish this, go to the windows control panel and type “Speech” into the text box at the top
right. Then click “Change text to speech settings”.
In the resulting windows, click the “Speech Recognition” tab and then the “Train Profile” button.

Then follow the on-screen instructions.

 Tip: It is advisable to save your Windows Speech Profile externally so that it can easily be restored
in case of a fresh Windows installation. This saves you the time of training the computer again. You
might want to create a new Speech Profile which matches the name of your Arma player profile.

Prepare Arma for Speakeasy

Create a new player profile and choose the APEX control setup for this profile.
The new player profile allows you to experiment with Speakeasy without messing up your old
profile. At the same time it is a way of making sure that no user-made changes interfere with the
Speakeasy key bindings. So this is both for your own convenience and for easier troubleshooting
when talking to us. If you should ever contact us for help, be prepared to answer the question:
"Have you created a new player profile?"
Speakeasy has been designed with the APEX key setup in mind. If you use any of the other setups
several commands will not work as expected. Of course you can change any key binding to your
liking later on, but at first please make sure that everything works as it should.

“Select all units” alternative

The command "select all units" in Arma 3 does NOT always select all units. It only cycles between
ordered units and idle units. Only "forceCommand" in the key bindings file selects every unit in your
squad regardless of them being ordered somewhere or just following you.
If the "select all units" was swapped for the "forceCommand" function in the in-game keybinding
settings, then the game would always select all units. Unfortunately that was not the route chosen
by the developers. Fortunately it is not difficult to fix it on your computer. Just follow these steps:
● Start Arma with the new character you created for use with Speakeasy.
● Go to Options >> Controls >> Command and remove any key bindings from the vanilla command
"select all units". Press "OK".
● Go to C:\Users\YourUserName\Documents\Arma 3 - Other Profiles\YourProfileName folder, find the
file with the plain user name (the one that does not contain either ".3den" or ".vars" in the filename)
and and open it with a text editor.
● Search (for example by typing Ctrl + F) for "keyForceCommandingMode" and put 41 inside the {}.
So the line of code reads: "keyForceCommandingMode[]={41};" Save the file.
● Shut the game down and restart it.
● To test your changes go into the editor and put down a squad with you as the squad leader, or
launch any mission where you are the leader of an AI squad, for example the Speakeasy training
scenario. Order one of your AI to stop. Then press the tilde-key [^] or [~] (depending on the
language of your keyboard) and you should select all of your guys.
Thanks to JoJoTheSlayer for finding and documenting this fix!

Install VoiceAttack
We recommend getting VoiceAttack through Steam, since that way you get the benefit of automatic
updates:
http://store.steampowered.com/app/583010/
If you prefer to buy it directly from the developer, go to www.voiceattack.com to download
VoiceAttack and proceed to install it on your computer.
 There is a free test version available which supports only twenty commands. This is good enough to
test whether you can use VoiceAttack on your system but you will not be able to use Speakeasy
with the free test version.

Install Speakeasy
This will show how to get the Speakeasy profile working with VoiceAttack.
Download the Speakeasy profile here if you haven’t already:
https://docs.zoho.eu/folder/b8w469879dc4241d6439588276d888f769848

Extract the contents of the downloaded .zip file to a directory where you can find it.

Inside of the folder you've just extracted, the following files will be available.
Copy the folder “speakeasy_audio” into the VoiceAttack sound directory which will be located in
either of the following places:
● Assuming you are using the Steam version, the complete directory with the sound files would
be:
“C:\Program Files\Steam\steamapps\common\Voice Attack\Sounds\speakeasy_audio\”
● Assuming you are using the non-Steam version of VoiceAttack, the complete directory with the
sound files would be:
“{install dir}\Voice Attack\Sounds\speakeasy_audio\”

Start VoiceAttack.

Click the “More profile actions” button

Select “Import Profile”
Navigate to the extracted voice profiles (file type .vap), select the one with your preferred language
and click “Open”.

You will be presented with a "Confirm Import" screen. This warns you that the VoiceAttack profile is
using inline C# scripts which are needed for it to work. Click "Yes" or the profile won't import.

The profile will become selected after being imported.

 Restart VoiceAttack and make sure that your keyboard layout has been loaded. In this case I was
using a Swedish keyboard Layout.
If it looks like the image below with your keyboard layout language, the profile is working properly
and you are good to go.

Install the Speakeasy Arma 3 user profile (optional)

This is optional. You can use the entire profile without having to manually set the in-game keybinds,
to match Speakeasy. In the downloaded Speakeasy package zip-file we provide you with an already
prepared Arma user profile.
All you have to do is extract the .zip file and place the contents in your Arma documents folder.

You can now go and rename it if you wish and rename it in-game.
Switch to the Speakeasy profile by clicking the profile button in the top right corner of the Arma 3
main menu and then the active profile name. In this case the current active profile is "woofer".

Then select the Speakeasy profile and click "Edit".

 Change the player name to whatever you want (in this case playerName) and click "Apply".

Then click OK and you're done!

Keyboard and language settings

VoiceAttack like other voice control software is reliant on what language your keyboard is using in
order to press the correct buttons in game. Speakeasy rectifies this problem in the background by
translating the key layout.
Since there are a lot of keyboard layouts out there, we have decided to add them as they are
needed. The following ones have been implemented at first release:
● US English (default)
● UK English
● German
 ● Swedish
● French
● Spanish
● Portugese
● Canadian Multilingual
● Canadian French

These ones have been added with version 2.0:

● Australian
● Danish
● Norwegian

If you get a variation of the following message from VoiceAttack when starting the profile, then your
keyboard layout isn’t supported yet (Read lines from the bottom to the top.) In this case get in touch
with us in the BI forum thread.

Keybinding within Arma

Some keybinds of supported mods conflict with each other or even with the vanilla game. Our key
setup has been carefully designed to avoid such conflicts where possible. The Speakeasy
VoiceAttack profile supports this key setup out of the box. If you are unsure about the mods you
may want to start with vanilla Arma first. You don't have to alter Speakeasy in any way if you play
without mods.
For a conflict-free set-up of keybinds for the mods supported by Speakeasy, there is a key sheet
within the downloaded zip-file where you can find every command that’s in the profile and which
keys are bound to each of them. Any keys that you have to re-bind have been marked in yellow as
the example below shows.
Editing the profile

Change the keys that are pressed within a command

This is useful if you want to keep your current keybinds in the game. In this example we will change
a key that is activated manually and by Speakeasy.
Let’s say you have a keybind in-game for Compass (toggle) that is “R-Shift+K” and you want to use
that instead of the standard “2xK” that’s supported by Speakeasy.

Click the “Edit profile” button on the VoiceAttack main screen.

Find the command you want to change the keypresses of. In this example, we will change
“Compass (toggle)” from the default key to a new key with a modifier.
Double click the command and you will be presented with the following window:
Find the line saying “// Set the sequence of keypresses below here”. The lines directly below that
are the keypresses and pauses needed to make the command work.
In this case the K-key is pressed twice with a short interval. With arma default key-binds that means
that the compass will stay shown on screen until the K-key is pressed twice again.
To match the setting in Arma, let’s delete the two existing keypresses and the pause to start from
scratch.
Highlight the three rows, right click on them and select Delete.

The marked lines of code disappear, leaving only an empty comment line (marked blue in the image
below) under the comment “// Set the sequence of keypresses below here”.
Click the button “Key Press” to start creating a new key press.

You will be met with the following window, which will indicate what
Press the Right-Ctrl key and then the K-key. VoiceAttack will indicate that they have been registered
for the key press. In this case they will stay pressed for a duration of 0.1 seconds before being
released again. Simply click "OK".
 Your new line will show up below what was selected before you pressed the button “Key Press”.
Move the marked line up one step by pressing the button “Up”.

You should have ended up with the following.

Press "OK" in the “Edit a command” window, and you are done.
VoiceAttack will now send the keypress “Right-Ctrl+K” instead the regular “2xK”

Creating a new command from a template

There are a few templates within the profile that can be used to create new commands. The reason
for the different templates is that different things are happening in the background depending on
what type of action is performed.

This is a step-by-step guide to create a new command by using one of the templates:
Make sure the correct profile is active.

Then click the “Edit profile” button

The “Edit a profile” window will open and will look like this if it isn’t grouped by category:

Make sure to group by category by clicking the “Group by category” button at the bottom.

The button will now look like this:

Find the “Framework: TEMPLATES” Category and click it to expand it.

 Right-click the appropriate template and select “Duplicate”.
● “TEMPLATE ACTION/MOD KEYPRESS” - Used for actions within Arma or mod commands that
aren’t related to commanding an AI squad or the “help by voice”.
● “TEMPLATE HELP BY VOICE” - Used to create your own Help by voice commands.
● “TEMPLATE ROLE ASSIGNMENT” - Used to create your own roles that can be assigned to a
soldier, such as the “assign medic” command. Has to be created in conjunction with the following
template.
● “TEMPLATE ROLE SELECTION” - Used to create your own roles that can be used to select a
soldier, such as the “medic” command. Has to be created in conjunction with the previous template.
● “TEMPLATE AI ORDER” - Used for orders to the friendly AI.

In this case we are making a voice command to open the Arma main menu which would be the
same as pressing the escape-key on your keyboard. Since it’s a regular action within Arma, we will
use the ACTION/MOD template
Rename the duplicated command by typing into the “When I say:” text box.
This will be the voice command that activates the action.
Write a description for what the command does into the “Description” text box. Then select an
existing or write a new appropriate category in the “Category” text box.

Finally set the appropriate key press sequence below the following:

The template already contains an example that holds down L-Ctrl and presses the C-key once. It
can be replaced with any keypresses or mouse clicks in any sequence that you want.

In our example we want to open the main menu by pressing the escape-key once.
Remove the keypress lines directly below the comment by marking them and then pressing the
Delete-button.
Press the escape-key on your keyboard once. The “R” in the top right key indicator should turn into
the following:

Press "OK".
The keypress will end up below the line you had previously marked. To make it all look neat, move it
up one step so that it sits right below the comment as shown by making sure to mark the new line
and then pressing the Up-button.
 The following should be the result.

If you do not want any audible feedback to play when using this command, you can Click "OK" to
save your new voice command. It should now appear in the list of available voice commands under
the category we set above.

Enabling feedback
To enable a feedback beep sound to play for this particular action when “Feedback beep” is active,
do the following.
Edit the newly created “open main menu” command by double clicking on it.
Select and right click on the following indicated command starting with “DISABLED” and select
“Enable Action”.

To enable a text-to-speech feedback phrase to play for this particular action when “Speakeasy
spoken feedback” is active, do the following.
Select and right click on the following indicated command starting with “DISABLED” and select
“Enable Action”.
It is then possible to change the spoken phrase to something appropriate by double clicking on it
and typing the new phrase
Click "OK" to save the change.
 Click "OK" to save the new voice command.

Changing how to speak an existing command

To change how to speak a command, find the command in the “Edit a profile” window.
Click the “Edit profile” button
In this example we will edit the existing command for opening the game main menu that is supplied
with the profile.
Type in “menu” all lowercase into the search box at the bottom.

If the commands are grouped by category like in the picture above, expand the category containing
the wanted command by clicking on it.

Double click the command “Escape;game menu” to edit it.

In the resulting “Edit a command” window, change the “When I Say” text box to what you want to be
able to use as activation phrases. Separate them by semicolon. In this case the option to speak
“show menu” has been added.
Press "OK" to save the updated command.
There are advanced ways of writing the “When I say” phrases to streamline them and make for a
better overview. Many of the Speakeasy commands use this method. Here is a brief overview of the
most common ways to write a phrase:
Obviously SPACE separates words in a phrase, as in "Open fire"
 As shown in the picture above a SEMICOLON separates phrases in a command. You can say
either "Escape" or "game menu" or “show menu” to execute this command. Note that there is no
space after a semicolon.
SQUARE BRACKETS separate dynamic phrases, such as "Compass [on;off;]". You can say
"Compass on" or "Compass off" or just "Compass" because the final semicolon means that the
other terms in the square brackets are optional.
Please refer to the VoiceAttack help documentation if you want to know more. Find the chapter
“Command Screen” and refer to the first pages of section “1 - Command Input”.

Updating an existing and/or modified Speakeasy profile

The profile relies on a framework that works in the background to support every command in the
profile. It allows for more advanced functionality and helps streamline the development.
It is possible to update only the framework. This is useful when you have changed commands in the
profile or added your own. Just importing a new version of the entire Speakeasy profile will have
you start from square one with your own edits.
Start by making a backup of the profile you are trying to update.

Click the “More profile actions” button

Select “Export Profile”

Make sure that all commands are selected and click "Export".
Save the backup to an appropriate directory.

Now, in the "Edit a Profile" window, click "Import commands".

Select the profile from which you want to import the framework.

Any red text for the spoken commands means that they will overwrite whatever is in the profile you
are trying to update.

IMPORTANT: Make sure that only the framework commands are marked for importing by first
clicking "Select None" and then re-selecting the ones starting with either F_ or FB_ according to the
following images.
With all commands deselected.
Check the box for each of the framework commands to overwrite only those. Click "Import" when
done.
You will be asked for a confirmation that you wish to overwrite some commands. Click "Yes".
 You will also be warned that the imported functions contains compiled inline functions. These are
needed for the framework to function. Click "Yes".

Finally click "Done" and you will have updated your Speakeasy framework.

Commands to control the profile

Some of the commands in Speakeasy change the way the profile operates within VoiceAttack. They
begin with the word “Speakeasy” and have different uses.
The following commands are especially important to operate the profile. Check the category
“Addons: Voice Attack: Profile:” in VoiceAttack for more commands.
 Command Usage

Speakeasy spoken Toggles text-to-speech feedback on

feedback certain commands. On by default.

Speakeasy beep Plays a beep sound after selected

commands that lack in-game verification
to let you know that they have been
executed. Useful for when you cannot see
the VoiceAttack program. Off by default.

Speakeasy universal beep Plays a beep after each and every

command. Useful when you want to be
absolutely sure that every command has
been executed. Good in conjunction with
spoken feedback.

Speakeasy feedback off Turns off all feedback.

Speakeasy slow Slows down the profile for when the game
is running at low FPS and commands
have trouble being activated within the
game. Off by default.

Speakeasy fast Sets the profile speed to fast speed. On

by default.

Speakeasy save settings Saves settings done to the profile so that

they are loaded automatically every time
the Speakeasy profile is loaded. Also
works between VoiceAttack program
restarts.

Speakeasy on Turns on Voice Attack listening.

Speakeasy off Turns off Voice Attack listening.

Help by voice
You can get help spoken by text-to-speech. You activate it by speaking one of the commands:
[help by voice] or [Speakeasy help]
This will make the profile read out help texts that lists a few categories and tells you how to activate
them. You can find all help texts in the Speakeasy key sheet. If you want to add your own help
commands or edit an existing one, we suggest you make changes in the key sheet and then copy
 them over to the profile in VoiceAttack. Text is not formatted properly in the VoiceAttack window and
this method will give you a better overview.
You can access any help section directly by speaking the appropriate command. That way you have
a direct way of referencing the topic in question without taking your attention away from the game.
For example:
[Help squad movement]

Advanced AI commands

Fluid Commands
A traditional command to the AI has to be given like this: "[Two] [pause] [Three] [pause] [hold fire]".
The pauses are necessary because you have to wait until the game has highlighted the soldiers in
the command bar before you can issue the order. This sounds robot-like and artificial.
Speakeasy now has a system that allows for soldier selection and order to be strung together so
that the complete command can be given fluidly without any robot-like pauses. We call this system
Fluid Commands. It provides a separate voice command for every possible combination of units and
orders. This generates several hundred thousand commands in the Speakeasy profile. The profile
supports both the traditional way of giving orders and the new fluid style. (Hint: If you change the
spoken phrase of any command to your AI subordinates in your Speakeasy profile it makes sense
to change both the vanilla command and the Fluid Command.)
With Fluid Commands you can say "[Soldier Two Three hold fire]" in a smooth and natural fashion.
The word "soldier" is a prefix that tells Voice Attack you are speaking a Fluid Command. The same
method works with colour teams or the entire squad with the prefixes "Team" and "Squad". The
prefixes for users of the German profile are "Soldat", "Trupp", and "Gruppe".
Because of how VoiceAttack works, Fluid Commands can only support a selection of individual
squad members up to a maximum of ten.
Another limitation is that the selection must be made in a specific order. Soldiers must be selected
in ascending order from 1 to 10. Colour teams must be selected in the order they are listed in the
Arma control options:
● Red
● Green
● Blue
● Yellow
● White

This means the following commands will work:

[Soldier Two Four Six hold fire]
[Team Red Blue Yellow hold fire]
[Squad hold fire]

But the following commands will not work properly:

[Soldier Four Two hold fire] (The soldiers are not selected in ascending order.)
 [Team Blue Red Green hold fire] (The teams are not selected in Arma's order of colours.)
[Red Blue Yellow hold fire] (The prefix "team" is missing.)
[Soldier Ten Eleven hold fire] (The highest possible number in Fluid Commands is ten.)

Fluid Commands also supports the C2 mod. The prefix word for C2 is "unit" - the same word that we
use for the selection of C2 personnel in traditional commands. Use "unit soldier" to select individual
soldiers with C2, "unit team" for selecting C2 colour teams, and "unit squad" for an entire C2 squad
of up to ten soldiers. The prefixes for users of the German profile are "C-Zwo Soldat", "C-Zwo
Trupp", and "C-Zwo Gruppe". The order of the selection is the same as in the vanilla game:
Individual squad members must be selected in ascending order and colour teams must be selected
in the order listed in the Arma control options.

Here are some working examples for fluid C2 commands:

[Unit soldier Two Four Six hold fire]
[Unit team Red Blue Yellow hold fire]
[Unit squad hold fire]

Roles
Roles will let you assign and call soldiers in your squad by their function. Such as rifleman, medic or
driver for example. You will need to assign them before you can call them. You won’t have to peek
at the squad bar as much to find out what number or color team is associated with the medic to be
able to select that soldier.
Example:
[eight] [assign medic] would assign unit 8 as the medic.
Speaking [medic] would then select unit 8.
Default possible roles are:
● Ammobearer
● AA
● AT 1 (or simply AT)
● AT 2
● Demolitions
● Engineer
● Grenadier 1 (or simply Grenadier)
● Grenadier 2
● MG 1 (or simply MG)
● MG 2
● Marksman
● Medic 1 (or simply Medic)
● Medic 2
● Rifleman 1 (or simply Rifleman)
● Rifleman 2
● Rifleman 3
● Sniper
● Spotter
● UAV
Focus
The profile provides a system where it is possible to have commands go directly to a given set of
units without having to call them first. You will have to set which units it should affect. It can be the
entire squad, sets of colour teams or sets of individual soldiers.
It is especially useful when you will only give orders to the entire squad for a while or when you want
to take two guys with you to do some specific task without having to constantly call their number or
roles.
We suggest to go through the following example in the game. This helps to understand better how
the focus feature works.
It is important to make sure no soldiers are selected before using a focus feature, or it will not work
as intended.
For example:
[five] [focus soldier]
[eight] [focus soldier]
[Disregard] (This makes sure no soldiers are selected)
[Hold fire]
[halt]
[prone]
The resulting action will be that soldiers five and eight will hold fire, then stop and finally go prone.
It is possible to do the same for the entire squad, but you don’t have to tell every individual soldier
that he is in focus.
[focus squad]
[Disregard] (This makes sure no soldiers are selected)
[Hold fire]
[halt]
[prone]
It is possible to focus on several color teams in the same fashion as with individual soldiers.
For example:
[team red] [focus team]
[team blue] [focus team]
[Disregard] (This makes sure no soldiers are selected)
[Hold fire]
[halt]
[prone]
The resulting action will be that team red and team blue will hold fire, then stop and finally go prone.

Compound commands
The compound commands are several regular commands put together for convenience. Let’s say
you want to take your squad and retreat from an engagement. Instead of manually saying the
following commands:
 [prevent combat] [force disengage] [squad] [disengage] [squad] [hold fire] [squad] [stay frosty]
[squad] [regroup] [squad] [formation file]
You can instead just say:
[squad retreat]
This particular command will then press all the buttons needed for you to be able to run away with a
squad that is as responsive to your orders as it can be.

Task Force Radio and ACRE2

The profile comes with support for the radio mods Task Force Radio and ACRE2.
There is one catch though: Because they share similar spoken commands, both of them cannot be
active in the profile at the same time. There cannot be two voice commands that are spoken exactly
the same way.
To counter this fact we decided to have Task Force Radio activated by default. ACRE2 commands
are deactivated and have the word ACRE in front.

To use Task Force Radio

All the Task Force Radio commands are categorized as: Addons: TFAR:
You don’t need to do anything to use these commands.
If you don’t have any use for ACRE2 you can remove the ACRE2 commands from the profile but
you don’t have to because they are de-activated already.

To use ACRE2
All the ACRE2 commands are categorized as "Addons: ACRE2": and are prefixed by the word
"ACRE". If you do not want to say "ACRE" before the ACRE2 commands you have to get rid of
TFAR in one of the following way:
● Either delete all the TFAR radio commands from the profile or, if you decide to keep them,
change their spoken phrases so that they all begin with TFAR. Make sure you also deactivate
them by clearing the tick box “When I Say”.

● Proceed to activate the ACRE2 commands by checking the tick box “When I Say” and removing
the word “ACRE” from the spoken phrase.
The Speakeasy training scenario
There is a dynamic scenario that you can use to test and hone your skills for use with the
Speakeasy profile in Arma. These are the current features:
● Both Multiplayer and Singleplayer ready
● Playable vanilla or with modifications
● The list of modifications which are supported but not required includes
○ ACE3
○ TFAR
○ ACRE2
○ Command and Control
○ ... and several others which are listed in the key sheet.
● Pre-made, recruitable AI that match the available roles within Speakeasy
● Pre-made vehicles
● Zeus access for all players
● Dynamic enemy creation on demand within a compound where you can test actual combat
using voice
The training scenario is included in the compressed file that the profile came with and it is available
on the Steam workshop at:
https://steamcommunity.com/sharedfiles/filedetails/?id=1601768205
The mission is not intended for dedicated servers, but it is so small that hosting it should be quite
enough.

General info about the Speakeasy key sheet

BI offers several presets which differ slightly. Make sure to set your game to the APEX preset.
In column A of the key sheet you will find an identification number for each command. This
command ID is used for a script which translates Speakeasy to other languages. It also helps to
discuss translated commands across language barriers.
Columns B and C of the key sheet list the categories and descriptions of all commands for the mods
Speakeasy supports and for the vanilla game. The categories are the same that you find in the
control options in the game and they are also used as categories and descriptions in the Speakeasy
profile. If a mod or game update changes a command you will see it in the control options of the
game provided that the mod in question uses CBA. Otherwise you will have to check the
corresponding config files. Copy new commands to the key sheet to keep it up-to-date.
Several add-ons such as ACE and TFAR use bare modifiers like "Shift" or "Ctrl" without specifying
whether the left or the right modifier has to be used. The game accepts these bare modifiers as both
left and right so you can decide which of the keys you want to press. Unfortunately Voice Attack
only accepts specified keys such as "Right Shift" or Left Shift". Therefore every bare modifier is
programmed as a left version in the Speakeasy profile.

A few thoughts about spoken commands

 Many objects in the game are toggled on or off. It is perfectly OK to simply say "GPS" to show it and
again "GPS" to hide it. But with some objects you have to use different commands to open and
close them. In order to avoid confusion it may make sense to also create dedicated commands for
toggled objects such as "Show GPS" and "Hide GPS". Speakeasy provides both ways of speaking
a command out-of-the-box.
For your spoken commands you can simply use the phrases that you first think of. These can
normally be remembered easily but in case you ever forget this phrase you are in trouble. But you
can also try a systematic approach which may lead to a somewhat generic and artificial kind of
commands but as they follow a specific rule it is virtually impossible to forget them. Example: You
could open and close all objects with the words "on" and "off" though you might also say "open" and
"close", "show" and "hide", etc. But if you always use the same type of command, programming
your Voice Attack profile is easier and cutting down on activation phrases may be a bit less taxing
on Voice Attack.
You can issue commands to yourself ("Show map", "Reload", etc.), to your AI squad, and to your
human mates in an online game. It makes sense to use the same commands you use for your
human mates also for your AI squad. This makes your life as a commander much easier because
you don't have to make a difference between commanding AI and real people. Some formations
and roles (such as medic and corpsman) are called differently by different armed forces. You should
use the word that you normally use and not necessarily the word used by BI. Commands to your
own avatar must differ from those you give the AI. Example: "Lie down" = avatar goes prone –
versus "Go prone" = AI does the same thing. If you used the same command in both cases your
Voice Attack could get a heart attack.

Use the key sheet to make your own version of Speakeasy

Many players use different input devices and almost everybody has some kind of individual key
configuration, be it to retain an old habit or because they prefer an individual way of controlling a
plane. Our key sheet helps you create your own version of Speakeasy. If you want to do this
systematically, it may be advisable to follow this procedure:

● Work with the key sheet first and transfer your changes subsequently to the profile.
● Test in-game if everything works satisfactorily. If necessary, make little changes to the profile
during your test.
● Update the key sheet if necessary to make sure that it corresponds with the latest version of
your profile.

The following step-by-step guide is a suggestion. It may make it a bit easier to make all the
necessary adjustments without getting lost in the process:

Preparation
● Make a working copy of the key sheet and name it like your Arma player profile.
● Make a new column in your freshly created key sheet and copy the contents of column E
(Speakeasy custom keys) into this column.
● Name the new column with your player name. Later, this column will contain your personal key
configuration.
● Add columns for any programmable input device that you use. Make a note of which button on
your device is assigned to a certain key combination.
 ● if you like, delete the lines of modifications you don't use.

Work with your key sheet and profile

Sift through your freshly created column from the top to the bottom and look at every key
combination:
● If you want to use one of the custom key combinations marked in yellow, overwrite the yellow in
your column in another colour, for example in blue.
● If you don't want to use one of the custom key combinations, then enter either the default keys
or your personal custom keys. Mark your changes in blue, too.
● if you want to use one of the unmarked default keys, don't change anything.
● If you don't want to use one of the default keys, enter your custom keys and mark them blue.
● Make a little remark for every deviation from default in the Notes column so that you can keep
track of your personal changes.
● If you don't like the existing spoken commands and confirmations, overwrite them with your own
phrases and mark the changes in blue.

When your personal column is complete, compare it with the Speakeasy custom keys column:

● Where-ever a blue mark in your column deviates from the entry in the Speakeasy column you
will have to make a corresponding change in the profile. It is advisable to test all changes to the
profile in-game.
● When everything is tested and you are happy with the profile you can delete the Speakeasy
custom keys column.
● The blue markings of the successfully changed and tested spoken commands and confirmations
can also be deleted.
● Should there be any default keys which are marked in blue, you can also delete these markings.

Result
Now there is a column with your personal key combinations in the key sheet which is in conformity
with your Speakeasy profile. All keys which deviate from the default are marked in blue. If you have
to re-install the game or the software of one of your programmable input devices these markings
help to make the necessary changes to the key configuration in the game quickly and easily.

Translating the profile

If you need the profile to work with your specific keyboard language, let us know. See section
"Keyboard and language settings" for details.

If you want to use Speakeasy in another supported language that you yourself want to use, get in
touch with us and we'll help you with the translation process and include it in the Speakeasy
release. All you have to do is translate the spoken phrases. Here's how we do translations:
● Use a copy of the English key sheet as a basis for your translation. Rename your working copy
so that it shows the target language in the file name. Do not change the version number. Add
new columns to the “Keys” tab for spoken commands and spoken confirmations in the target
 language. If you want to translate “Help by Voice” as well, add new columns to this tab, too. Do
not delete or overwrite the English columns, otherwise the scripted translation (see below) won't
work.
● Translate the phrases. If you want a spoken command or a spoken confirmation that doesn't
exist in the English version add it to the appropriate cell in the target language. (Tip: Make sure
that there aren't any spaces at the beginning and the end of a phrase, otherwise the scripted
translation won't work properly. Tip: Write your commands as described in “Changing how to
speak an existing command”.)
● Send your key sheet to woofer. He will make a scripted translation of the profile and send it back
to you. The scripted translation is not perfect. You will have to check each command and
manually correct any mistakes you may find.
● Make sure to test all phrases in-game. This test will reveal any problems with your new profile. If
you change a command in the profile, make sure to update your new key sheet accordingly.
● If everything works to your satisfaction you’re done. From now on you can speak your
commands and get spoken feedback in the language of your choice. Congratulations! Now you
can safely delete the English columns from your key sheet.
● Do you want to share your work with other users who speak your language? If you do please
delete "scripted translation" from the file name of the profile and send the final versions of your
profile and key sheet to woofer. Your files will be added to the Speakeasy online repository and
they will be included in the next official release of Speakeasy. You will be given proper credit as
a contributor and access to help keep the profile up-to-date.

Troubleshooting
What do you do if ...
● ... general recognition of spoken commands is poor?
Train your Windows speech profile more. Reference “Train your windows speech system” in the
installation section
● ... an individual command is not recognized?
Check in the VoiceAttack window that your command is registered correctly when you speak
and change the wording of your command if necessary.
● ... commands register properly in VoiceAttack but don’t always work in-game?
Use slow mode which has been designed for this purpose by saying [Speakeasy Slow] or
[Speakeasy langsam] if you use the German version. It will prevent Speakeasy from sending
commands faster than the game can handle at your current FPS. You’ll find the command in the
VoiceAttack category of the profile.
● ... an individual command is recognized but not executed at all, though physical keystrokes
work?
Edit the command by adding pauses between key presses. Avoid using keypresses of the type
“Press Left Ctrl+A and hold for 0.1 seconds”.
Instead use:
Press down Left Ctrl key
Pause 0.1 seconds
Press key A and hold for 0.1 seconds
Pause 0.1 seconds
 Release down Left Ctrl key
By using the “Recorder” button you can achieve this type of key press with ease.
● ... a command does not work at all, neither by using voice command nor by pressing physical
buttons?
Make sure that both the game and VoiceAttack are set to press the same keys. For the vanilla
game, the easiest solution is to make sure that you have the default APEX keybinds loaded.
Bear in mind that sometimes Speakeasy is set to press something other than the default keys
for mods, and you need to have the game set up according to the Speakeasy key sheet.

Miscellaneous

Links
A tutorial about controlling AI by Jester814: https://www.youtube.com/watch?v=3-fZJm7mhfk

Contact us
Discord: https://discord.gg/MF7TAzU
BI forum: https://forums.bohemia.net/forums/topic/211074-speakeasy-voiceattack-profile/
Mail woofer: woofer808@gmail.com

Mail Alpha-Kilo: alpha.kilo@zoho.eu