WinTAK Quick Start Guide
WinTAK Quick Start Guide
22 December 2021
REVISION RECORD
Table of Contents
1 INSTALLING WINTAK AND RELATED PLUG-INS .................................................... 1
1.1 Basic Installation .............................................................................................................. 1
1.2 Adding Plug-ins................................................................................................................ 4
1.2.1 Using the WinTAK Installer Modify Option.......................................................................... 4
1.2.2 Installing Plug-ins via a WPK file ........................................................................................ 8
1.3 Installing WinTAK through the Command Line ............................................................. 9
1.3.1 Basic Command Line Installation ....................................................................................... 10
1.3.2 Command Line Installation with Plug-ins .......................................................................... 10
1.4 Clearing WinTAK through Windows Defender Firewall .............................................. 12
2 LOADING DATA INTO WINTAK .................................................................................. 14
2.1 Placing Data Directly into WinTAK’s ProgramData folder .......................................... 14
2.2 Transferring Data into WinTAK Using Import Manager .............................................. 16
2.2.1 Importing into WinTAK using Directory Preferences ........................................................ 17
2.2.2 Importing into WinTAK using Drag and Drop Method ...................................................... 18
2.2.3 Importing into WinTAK Using File Navigation Method ..................................................... 20
2.2.4 Importing Data from OwnCloud/FTPS Servers .................................................................. 22
2.3 Transferring Data Between WinTAK and ATAK Using ATAK Manager ................... 23
2.4 Loading Elevation Data (DTED) into WinTAK ............................................................ 25
3 SAVING MAP IMAGERY FOR USE WHEN INTERNET CONNECTION IS NOT
AVAILABLE ............................................................................................................................... 27
4 CONNECTING TO A TAK SERVER .............................................................................. 30
4.1 Manually Establishing a TAK Server Connection ......................................................... 30
4.2 Establishing a TAK Server Connection via Pre-Configured Zip File ............................ 33
5 UNINSTALLING WINTAK FROM A WINDOWS MACHINE ................................... 34
APPENDIX A HIDDEN FILES AND FOLDERS ................................................................ 37
APPENDIX B LOCATING LOG FILES .............................................................................. 38
List of Figures
Figure 1 – WinTAK Setup Wizard ................................................................................................. 1
Figure 2 – Installation Folder Selection .......................................................................................... 2
Figure 3 – Plug-in Selection ........................................................................................................... 2
Figure 4 – WinTAK Shortcut Icon ................................................................................................. 3
Figure 5 – Release Information Screen ........................................................................................... 3
Figure 6 – WMS Map Source Selection ......................................................................................... 4
Figure 7 – WinTAK Blue Marble Earth View................................................................................ 4
Figure 8 – WinTAK Setup Wizard ................................................................................................. 5
Figure 9 – Modify, Repair or Remove Prompt ............................................................................... 5
Figure 10 – Available Plug-in List.................................................................................................. 6
Figure 11 – Custom Setup............................................................................................................... 7
Figure 12 – New Plug-ins Discovered Prompt ............................................................................... 7
Figure 13 - WinTAK Toolbar ......................................................................................................... 8
Figure 14 - Plug-in Manager Listing .............................................................................................. 9
Figure 15 - Plug-in Manager Preference ......................................................................................... 9
Figure 16 - Silent WinTAK Installation ....................................................................................... 10
Figure 17 – Finding Correct ADDLOCAL Section ...................................................................... 11
Figure 18 – Windows Defender Firewall...................................................................................... 12
Figure 19 – Select Change Settings to Enable Checkboxes ......................................................... 13
Figure 20 – Enable Network Communication .............................................................................. 13
Figure 21 – WinTAK ProgramData Subfolders ........................................................................... 15
Figure 22 – Copy Files into a WinTAK ProgramData Subfolder ................................................ 16
Figure 23 - Directory Preferences ................................................................................................. 18
Figure 24 – Multiple Directories................................................................................................... 18
Figure 25 – Drag and Drop File Import ........................................................................................ 19
Figure 26 – Import Strategy Prompt ............................................................................................. 19
Figure 27 – Import Successful ...................................................................................................... 19
Figure 28 – Import Failed ............................................................................................................. 20
Figure 29 – Import Directory ........................................................................................................ 20
Figure 30 – Folder Selection ......................................................................................................... 21
Figure 31 – Import Strategy Selection .......................................................................................... 21
Figure 32 – Import Status ............................................................................................................. 21
Figure 33 - Configure OwnCloud/FTPS Server ........................................................................... 22
Figure 34 - Import Selected File(s) ............................................................................................... 22
Figure 35 – ATAK Manager ......................................................................................................... 23
Figure 36 - Import File Selection .................................................................................................. 24
Figure 37 – Overlays Export ......................................................................................................... 24
Figure 38 - WinTAK ProgramData Overlays Folder ................................................................... 24
Figure 39 – ATAK’s Available File Listing ................................................................................. 25
Figure 40 – TAK.gov Download options ..................................................................................... 25
Figure 41 – Selecting DTED Level 0 ........................................................................................... 26
Figure 42 – DTED Level 0 Installer ............................................................................................. 26
Figure 43 – Preparing to Download Tileset .................................................................................. 27
Figure 44 – Download Region Rectangle ..................................................................................... 28
Figure 45 – Download options...................................................................................................... 28
List of Tables
Table 1 - Manual File Placement Within C:\ProgramData\WinTAK .......................................... 14
Table 2 - Import Manager Techniques.......................................................................................... 17
Navigate to the folder with the EXE file. Double left-click on the installer file name. A user
account control prompt will appear, indicating the WinTAK build number and requesting
permission to make changes to the device. If the installer is a signed version, the verified
publisher will be identified. Otherwise, the prompt will indicate that the publisher is unknown.
In either case, select Yes to allow changes to the computer.
The WinTAK Setup Wizard welcome page will display as depicted in Figure 1. Select Next
to continue.
By default, WinTAK installation files will be placed in the C:\Program Files\WinTAK folder
as shown in Figure 2. If a different location is desired, indicate an alternative folder before
selecting Next for the Select Installation Folder prompt.
All optional plug-ins that are appropriate for the current WinTAK build are included in the
installation EXE file. When the WinTAK plug-in prompt appears, select the desired plug-ins
to be installed, then select Next (shown in Figure 3). If unsure as to the necessity of a specific
plug-in, choose to install it. Installed plug-ins are easily disabled once WinTAK is launched
but adding an uninstalled plug-in later will require rerunning the WinTAK installer and
employing the modify option. Refer to the Adding Plug-ins using the WinTAK Installer
Modify Option section for directions. Installed plug-ins can be disabled by selecting Settings
from the top left corner drop-down menu. Choose Tool Preferences > Plug-in Management,
then uncheck the checkbox for the undesired plug-in.
Once Install is selected from the Ready to Install prompt, the installation process will begin.
When installation is finished, the WinTAK Setup Wizard completion prompt appears. Select
Finish to dismiss the wizard.
Upon successful installation, WinTAK.exe will appear in the installation folder. A shortcut,
bearing the WinTAK icon, will appear on the desktop, shown in Figure 4. Double left-click
(or right-click and select Open) the shortcut icon to launch WinTAK.
The WinTAK splash screen will appear, briefly displaying release information as depicted in
Figure 5.
The first time that WinTAK is launched, the End User License Agreement will appear. Please
review the terms, check the “I agree” box and select the “I agree” button to advance. A prompt
to choose which WMS (Web Map Service) map sources should be installed will then appear,
as shown in Figure 6. If unsure which to choose, verify that all checkboxes are checked before
selecting OK.
WinTAK will appear with the blue marble Earth view, shown in Figure 7.
Any available imagery overlay and Digital Terrain Elevation Data (DTED) data files can now be
loaded into WinTAK. Various available file import methods are explained in the Loading Data
into WinTAK section. It is highly recommended to import DTED. Level 0 DTED data is available
for download from takmaps.com. Refer to the Loading Elevation Data into WinTAK section for
directions.
Note: Some WinTAK plug-ins are not included in the main installer and are distributed via a
separate .wpk file.
Navigate to the folder with the WinTAK installer file. Double-click on the installer file name.
A user account control prompt will appear, indicating the WinTAK build number and
requesting permission to make changes to the device. If the installer is a signed version, PAR
Government will be identified as the verified publisher. Otherwise, the prompt will indicate
that the publisher is unknown. In either case, select Yes to allow changes to the computer.
The WinTAK Setup Wizard welcome page will display as depicted in Figure 8. Select Next
to continue.
As shown in Figure 9, the Modify, Repair or Remove installation prompt will appear. Select
the Modify icon, then select Next.
Scroll through the list to find plug-ins the user wishes to add. Items marked with a red X icon
are available but not currently installed (depicted in Figure 10). For each plug-in the user
would like to install:
• Select Will be installed on local hard drive from the drop-down menu. Upon selection of
new features, the hard drive space requirement will update.
Status icons for plug-ins prepared for installation will now depict a hardware device, instead
of a red X. In Figure 11, the Data Sync and ExCheck plug-ins have been selected. The dialog
box shows that 1116KB of additional space is required for the Data Sync plug-in. When all
desired plug-ins have been installed, select Next.
Once Install is selected from the Ready to Install prompt, the plug-in installation process will
begin. When installation is finished, the WinTAK Setup Wizard completion prompt will
appear. Select Finish to dismiss the wizard.
The first time that WinTAK is relaunched, after adding new plug-ins, the New Plug-ins
Discovered prompt will appear as shown in Figure 12. Check the checkbox for each of the
new plug-ins to be loaded into WinTAK, then select OK.
Most optional plug-ins will be added to the Plug-ins tab on the toolbar; however, not finding
the name of a specific plug-in in the Plug-ins tab does not necessarily indicate that the plug-in
installation or loading was not successful. Some plug-ins create multiple tools and/or new
toolbar tabs. Other plug-ins may not need to appear on the toolbar at all. In this example,
installing the ExCheck plug-in caused the tool to appear in the Plug-ins tab; however, installing
the Data Sync plug-in caused the Data Sync, New Feed and Timeline tools to appear in a new
Home tab group called Data Sync as shown in Figure 13.
From Windows file explorer the user double clicks on a WPK file. WinTAK will launch and
the plug-in will be installed.
If WinTAK is running, the user can drag and drop the wpk file from Windows file explorer
onto WinTAK. The WPK file is installed and available for use.
The third option is to install using Plug-in Manager. The plug-in manager allows users to
load/unload plug-ins while WinTAK is running. Using the plug-in manager, users can see the
list of plug-ins available (Figure 14) and load or unload the plug-ins. Plug-ins can be installed
from a Local Plug-ins Directory or from an Over the Air (OTA) server if one has been
configured. The location for the plug-ins is configured in the Plug-in Manager settings screen
(Figure 15).
A user account control prompt will appear, indicating the WinTAK build number and requesting
permission to make changes to the device. If the installer is a signed version, the verified publisher
will be identified. Otherwise, the prompt will indicate that the publisher is unknown. In either
case, select Yes to allow changes to the computer. There will be no indication that WinTAK was
installed successfully. Go to the Windows’ Desktop to find the WinTAK shortcut that was added
or type “WinTAK” into the Search area and the WinTAK App will appear and can be selected.
Type or paste the following command, substituting the version of WinTAK that is being
installed. Be sure to enter the whole path where the install.log file should be saved:
Run WinTAK
Select the plug-ins to be installed (In this example Data Sync and ExCheck were chosen)
Close WinTAK
Search for the word (Ctrl-F) ADDLOCAL. Look for the instance that also has the terms
PROPERTY CHANGE found on the same line. The desired section of the log will look
similar to Figure 17
Note that in the comma separated list of strings, two optional plug-ins (in this example, DataSync
and ExCheck) can be seen that were selected in Step 4.
This log section must be modified either in a separate document or on the command line itself.
The beginning of the log section (ADDLOCAL property. Its value is ‘) must be changed to:
ADDLOCAL=“. The ending of the log section (’.) must be changed to: ”
Paste in the same command as in the previous section (substituting the current version of
WinTAK being installed) i.e., “WinTAK-4.5.0.68-mil-installer-x64.exe /exenoui /qn for the
WinTAK 4.5 release.
The command created in Step 13 can now be distributed to silently install WinTAK on any
Windows machine.
It is not recommended to use the same ADDLOCAL value that was generated with a previous
build because the value for ADDLOCAL may change in between versions of WinTAK.
Select the Start button or in the Cortana search field on the taskbar and type “firewall.” Select
Windows Defender Firewall from the search window that appears.
When Windows Defender Firewall opens, select Allow an app or feature through Windows
Defender Firewall, as depicted in Figure 18.
A list of applications will appear. Select the Change Settings button (shown in Figure 19) to
unlock the list.
Scroll to find WinTAK and/or wintak.exe in the list. As depicted in Figure 20, check the box
to the left of each if they are unchecked, then check boxes to the right for Domain, Private and
Public as appropriate to allow communication on these networks.
If WinTAK does not appear on the list, select Allow another app, and browse to the location
of wintak.exe, which is by default located at C:\Program Files\WinTAK\WinTAK.exe.
C:\ProgramData\WinTAK
This folder is created when WinTAK is installed. Files that are placed into this folder structure
while WinTAK is not running will be available for use when WinTAK is launched. Refer to Table
1 for appropriate subfolder placement of specific file types.
Note: KMZ files that contain both imagery and vector data need to be placed in both locations for
both types of data to be loaded into WinTAK.
Note: Files that are added to WinTAK via Import Manager or created by WinTAK, will not
necessarily appear in the WinTAK ProgramData folder locations as described above. Different
subfolders and virtual links are sometimes used by WinTAK.
Follow these steps to copy files directly into WinTAK’s ProgramData folder structure:
Open a Windows Explorer window and navigate to the location of the source file(s) to be
copied to WinTAK.
C:\ProgramData\WinTAK
Note: The ProgramData folder is hidden by default. See Appendix A for instructions on how
to change folder visibility and access for Windows devices.
Using Table 1 for reference, double left-click the name of the WinTAK subfolder that the user
needs to open for the file type being used. In the following example (Figure 21), a KML file
will be added to the C:\ProgramData\WinTAK\Overlays folder. Therefore, Overlays must be
opened.
Select a file (or files) from the source folder and copy into the WinTAK subfolder, as shown
in Figure 22.
The transferred file(s) will be available once WinTAK is launched. Refer to Table 1 for
information on where to find the transferred data within WinTAK.
Import Manager
Folder
Where to Find within WinTAK
File
Zip
File Type
Program
Note: Import of a KMZ that contains both imagery and vector data will cause the imagery portion
to appear under Overlays > GRG and the vector portion to display under Overlays > File Overlays
> KML.
Choose the desired directory then select, for example, Add DTED Source to manage which DTED
folders will be processed. Select the Folder icon, navigate to the location of the DTED folder and
then select OK twice. WinTAK will now read from that folder for DTED information. Additional
folders can be added and WinTAK will read from all folders that are added (as shown in Figure
24).
As stated above multiple directories can be established for not only DTED, but for Imagery,
Overlays and GRGs.
Launch WinTAK.
If WinTAK is in full-screen mode and no external monitors are attached to the Windows
machine:
• Select the restore down button (layered squares icon) in the top right corner of the WinTAK
screen.
• Drag an edge or corner of the WinTAK frame to resize it, allowing access to the desktop.
Near the WinTAK window, open a Windows Explorer window. Navigate to the location of
the source file(s) to be imported into WinTAK.
Select and drag the desired file (or files) onto WinTAK.
Dependent on file type, an import strategy prompt may appear as shown in Figure 26. Choose
the appropriate strategy and select OK.
When the process is complete, Import Manager will report the success or failure of the import.
This is depicted in Figures 27 and 28.
Successfully imported file(s) will now be available in WinTAK. If necessary, refer to Table 1
for information on where to find the transferred data within WinTAK.
Launch WinTAK.
Select Import Manager from the drop-down menu on the top left corner of the WinTAK pane.
Choose to import a directory, or individual files. In this example (Figure 29), a directory will
be imported.
Dependent on file type, an import strategy prompt may appear. Choose appropriate strategy
and select OK, as shown in Figure 31.
When the process is complete, Figure 32 shows how Import Manager will report the status of
the import.
Successfully imported files will now be available in WinTAK. If necessary, refer to Table 1
for information on where to find the transferred data within WinTAK.
After the server is configured, the user selects the server and is presented with a file browser
window. The user clicks the download icon, selects the desired file(s) and then can choose to
download the files for later use or select to import them immediately (Figure 34).
2.3 Transferring Data Between WinTAK and ATAK Using ATAK Manager
Imagery, overlays, DTED, Image Overlays, video files, data packages and apk files can be
transferred between WinTAK and ATAK via the ATAK Manager plug-in. Only files that reside
within the ATAK folder structure are available for import into WinTAK. Follow these steps to
transfer files:
To transfer data to or from ATAK, the “atak” folder structure must exist. This folder is created
the first time that ATAK is launched on an Android device. Quit ATAK if it is currently
running.
Connect the Windows machine to the Android device with a USB cable. The Android device
may prompt for permission for the Windows machine to access data. Allow this access.
On WinTAK, activate the ATAK Manager plug-in from the toolbar. The ATAK Manager tool
will appear. Select the type of files to be transferred, as depicted in Figure 35.
In this example (Figure 36), Overlays was selected. All files of selected type, available for
import from ATAK, will appear. To import files from ATAK into WinTAK, check the
checkboxes of desired files, then select Import. Selected files will be copied into WinTAK.
To transfer files from WinTAK into ATAK, select the Export button as shown in Figure 37.
The WinTAK ProgramData Overlays folder contents will display. Notice that files imported
in previous example now appear in the content list (Figure 38). Choose desired files from
current directory or navigate to another to choose files from a different location to be
transferred from WinTAK, select Open.
Any files, exported from WinTAK to ATAK, will now appear in ATAK’s available file listing
as shown in Figure 39.
To download and import DTED Level 0 data into WinTAK using the installer:
Login to TAK.gov.
Select the Resources tab (Figure 40), then select Available Resources.
Launch WinTAK-DTED0Data.exe and grant permission for it to run. It will install DTED0
files into the appropriate directory (Figure 42).
If mission specific DTED files have been provided in .zip format, they will need to be installed
via the Import Manager. To install from a zip file:
Launch WinTAK
Drag and drop the provided DTED zip folder onto the WinTAK application.
When the DTED import is complete, WinTAK will display an All Files Successfully Imported
message.
Select the MOBILE tab. If the Map Source type is set to Local, switch to Online.
Select desired map source from the listing as shown in Figure 43.
Click to select 2 locations on the map, denoting the download rectangle. The first location will
mark one corner. The second location will mark the opposite corner. This is depicted in Figure
44.
If desired, create a custom name for the download file by replacing the default name that
appears in the New Layer Name field.
Note the download size and number of tiles, indicated in the lower right corner of the blue
rectangle outline. Creating tilesets less than 1,000 tiles will take a few minutes. Creating a
very large tileset could take hours. The number of tiles being downloaded is limited to the
available space on the C: drive. Moving the blue dots on the slider bar will change the
resolution of the download. Adjustments to the map resolution or the size of yellow download
rectangle will have a direct effect on the number of tiles in the download and the granularity
when viewing the downloaded tileset.
When desired download parameters have been set, select the OK button, as shown in Figure
45.
Once the download has begun, it can be cancelled by selecting the Red X on the status bar or
the Cancel Download (cloud with down arrow and red line icon) button at the top left of the
Maps & Favorites panel.
• Note: The download progress can be monitored by the download status bar and tile count
indicators as shown in Figure 46.
Multiple tilesets from different map sources can be downloaded simultaneously. To download
additional tilesets once the initial download has started, select the desired map source, select
the Download button and repeat the process used for the first downloaded tileset. Each tileset’s
download progress will be listed at the bottom of the Maps & Favorites panel.
When download(s) is complete, switch from Online to Local and find the newly created
tileset(s) in the MOBILE tab listing.
Selecting the outline (green outline icon) button will cause the newly created SQLite image to
appear outlined on the map as shown in Figure 47, differentiating it from the cached tiles that
are currently available on the device. Zoom out on the map view to see the full outline if
necessary.
This tileset will remain in WinTAK until the Clear Content function is performed.
• Note: If the user’s TAK Server supports Client Provisioning they will need only the
TrustStore .p12 certificate file.
Launch WinTAK.
Select Settings > Network Preferences > Manage Server Connections > Add Item.
In the Description field, enter a descriptive name for the server connection.
Enter the TAK Server’s Host Address and Port number as depicted in Figure 48.
From the Protocol drop-down menu, select SSL (or TCP if non-secure connection is desired).
If SSL is selected:
If the user’s TAK Server supports Client Provisioning and wish to use it, check the Enroll
for Client Certificate box and go on to Step 8. Otherwise, select Install Client Certificate
button.
i. Navigate to the folder with server certificates.
ii. Select the client certificate, then Open.
Select OK to submit the server connection. The newly created TAK Server connection will
now appear in the listing If the TAK Server connection was successfully established, the
green check cloud icon will appear in the server connection listing as shown in Figure 52.
If the connection is disabled or nonfunctional, the cloud icon will appear red with an X as
depicted in Figure 53.
Launch WinTAK.
Drag and drop (or import via Import Manager’s file navigation) the zip file onto WinTAK.
If the zip file did not include the passwords, a prompt will appear. If prompted, enter
passwords, then select OK.
The newly created TAK Server connection will now appear in the listing. As shown in Figure
54, if the TAK Server connection was successfully established, the green check cloud icon will
appear in the server connection listing. Unchecking the checkbox will disable the server
connection. Disabled and unestablished TAK Server connections will be indicated with red
cloud icons with an X.
Choose Uninstall a program from the Programs section as shown in Figure 55.
Select WinTAK from the list (shown in Figure 56), then select Change from the toolbar.
When the WinTAK Setup Wizard appears, select Next (Figure 57).
To initiate removing the WinTAK program from the computer, select Remove icon from the
Modify, Repair or Remove installation prompt, shown in Figure 58, then select Next.
If the uninstall is being performed in preparation for a WinTAK upgrade installation, the
WinTAK application data should most likely be left intact. In this case, verify the Remove All
WinTAK Application Data checkbox on the WinTAK Setup window is unchecked before
selecting the Remove button.
If the uninstall is being performed to entirely remove WinTAK from the windows machine (or
before a clean install), the Remove All WinTAK Application Data checkbox should be checked
before selecting the Remove button. This is depicted in Figure 59.
Application files that are removed by this process include all files within these folders:
Overlay files (including GPX, KML, KMZ and Shape), created by WinTAK export features, are
not removed, and will remain in C:\Users\username\Documents\WinTAK\Export file.
When uninstallation is finished, the WinTAK Setup Wizard completion prompt appears.
Select Finish to dismiss the wizard.
Upon successful uninstallation, the WinTAK installation folder will be deleted. The WinTAK
shortcut will disappear from the desktop, as well.
Windows 10:
Select the View tab > Options > Change folder and search options.
Select the View tab > select “Show hidden files, folders and drives”, then select OK.
• These are text files that are named in the format Errors-WinTAK-(date).txt, Log-WinTAK-
(date).txt or Fatal-WinTAK-(date).txt
- Windows 8 or10 allow for you to use %appdata% to shorten the path – to go right to
the logs open a Windows Explorer window and type %appdata%/wintak/logs in the
path field
Dump files:
• These are large, detailed files that WinTAK produces on a crash. They have a .DMP
extension and are commonly 40-60MB in size.