# SCS TagUI Workshop __Date:__ 24th Oct '19 __Venue:__ Seminar Room, innovation 4.0, S117602 ## Installation (Set Up) One can follow the following steps in getting TagUI set up on their local machine. 1. Head over to [TagUI's Github repository](https://github.com/kelaberetiv/TagUI). 2. Scroll down to the '[Set Up](https://github.com/kelaberetiv/TagUI#set-up)' section and download the `.zip` file for your specific platform. 3. Upzip the `.zip` file to your preferred location. However, note that __TagUI won't work well with spaces in folder and file names__. 4. To use TagUI, open up your terminal, navigating to the `/src` folder of the unzipped TagUI contents, and invoking the `tagui` programme, as such: __Windows__ ```bat cd path/to/tagui/src tagui ``` __macOS__/__Linux__ ```shell cd path/to/tagui/src ./tagui ``` If TagUI works fine, you would be able to see an output similar to the following: ![https://i.imgur.com/LJUZpWO.png](https://i.imgur.com/LJUZpWO.png) 5. To test out a sample script, you can run the following: __Windows__ ```bat tagui samples/1_yahoo ``` __macOS__/__Linux__ ```shell ./tagui samples/1_yahoo ``` If you see an output like the following, the sample script has been run successfully. There would be some newly created `.png` files in the `/samples` folder. ![https://i.imgur.com/5LPOAb8.png](https://i.imgur.com/5LPOAb8.png) 6. __Important notes!__ Some of you might face some troubleshooting errors listed below: + For Windows computers, if you see 'MSVCR110.dll is missing' error, install [this from Microsoft website](https://www.microsoft.com/en-us/download/details.aspx?id=30679) (choose vcredist_x86.exe) - this file is required to run the Windows PHP engine packaged with TagUI. + For some newer macOS versions, if you get a 'dyld: Library not loaded' error, [install OpenSSL in this way](https://github.com/kelaberetiv/TagUI/issues/86#issuecomment-372045221). + For some flavours of Linux (Ubuntu for example), which do not have PHP pre-installed, google how to install PHP accordingly (e.g. Ubuntu, apt-get install php). Most Linux distributions would already come with PHP. + For Firefox automation, download an [older version here](https://ftp.mozilla.org/pub/firefox/releases/59.0/) (SlimerJS doesn't work with Firefox v60 onwards).