When you run SWAGView for the first time the display will be empty because the SWAG database has not been installed.
To install SWAG do the following:
-
Go to the SWAG releases page on Github.
-
Choose the latest v1.0.x release (SWAGView doesn't know how to read any version including or after v1.1.x).
-
Download the zip file named
dd-swag-<version>.zip where <version> is the release version number. Make a note of the folder where you downloaded the file.
-
In SWAGView, click the Install SWAG Database... button.
-
In the resulting dialogue box enter the full path and file name of the zip file you downloaded in the edit box. You can click the ... (ellipsis) button to the right of the edit box and choose the file from a standard file open dialogue box.
-
Click the Install button. This button will only be enabled if the file you entered exists.
-
Wait for the database to be installed. A window will be displayed during this process. Expect it to take a few seconds to extract the data from the zip file and to copy it to the correct location – there are hundreds of small files to copy.
If everything goes OK the SWAG categories will be displayed in the left hand pane of the main window. See the Overview topic for information above how to use the program.
The next time you start SWAGView it will find the database, so you don't need to do this process again.
Problems?
If anything goes wrong a message describing the problem will be displayed. This can happen for a few reasons:
-
There was a file system problem. You might need to re-download the zip file.
-
The file you selected is corrupt or is not a zip file. Try again and choose the correct file.
-
The zip file does not contain the SWAG database. Try again and choose the correct file.
-
The version of the database in the zip file is not supported. Try downloading a suitable version and try again.
Regardless of the reason for failure, the main display will remain empty and you can use the Install SWAG Database... button to try again.
Back to index page