1. Customizing the NOAA SOS Public Kiosk Keith Searight Senior/Lead Software Engineer for SOS 2015 Science On a Sphere ® Users Collaborative Network Workshop December 2-4, 2015

2. 2 SOS Users Collaborative Network Workshop Dec. 2-4, 2015 Widely requested General public users Touch screen controls Standard hardware Trackball style sphere motion Multi-language support Easy and flexible configuration NOAA SOS Public Kiosk

3. 3 SOS Users Collaborative Network Workshop Dec. 2-4, 2015 Basic Information How to get it?  E-mail us at: sos.gsd@noaa.gov to get a download linksos.gsd@noaa.gov What does it cost?  Free to SOS sites What hardware is needed?  All-in-1 touch screen PC or separate PC and touch screen monitor  Kiosk mounting hardware What software is needed?  Windows 7 or 8 (WinXP & Win10 may work)  Free FTP client software (optional) What support is offered?  NOAA Kiosk manual: sos.noaa.gov/Support/noaa-sos-public-kiosk.htmlsos.noaa.gov/Support/noaa-sos-public-kiosk.html  Same free support as other SOS software

4. 4 SOS Users Collaborative Network Workshop Dec. 2-4, 2015 Software and Utilities Used Kiosk Machine (Windows) NOAA Kiosk Software Public User Interface Administration User Interface Notepad (text editor) FTP Client – optional (e.g., FileZilla or FireFTP) SOS Machine (Ubuntu) SOS (Automation Command Protocol) media2kiosk (command line utility) FTP Server – optional (vsftpd)

5. 5 SOS Users Collaborative Network Workshop Dec. 2-4, 2015 Public User Interface Using the Kiosk: 1.Select a Group 2.Select a Dataset 3.View Information 4.Control SOS 5.Select Overlays 6.Repeat Steps 1-5 Other options: 1.Kiosk Info 2.Change Language

6. 6 SOS Users Collaborative Network Workshop Dec. 2-4, 2015 Installation and Initial Setup 1.Install the kiosk software download NOAA_SOS_Kiosk_5.0-Setup.exe from link on sos.noaa.gov run setup and follow the instructions 2.Run the Kiosk from the desktop icon 3.Click on Administration Button & enter default password: 1234 4.Edit Properties kiosk_server: 127.0.0.1 → SOS machine IP or name password: 1234 → something harder to guess 5.Apply, then Function > Exit Application 6.Verify the kiosk interacts with your SOS

7. 7 SOS Users Collaborative Network Workshop Dec. 2-4, 2015 Data and Configuration Files Kiosk Machine (Windows) Directories under c:\shared\sos\kiosk config: settings.txt, logo image, localized text resource: buttom images datasets (auto generated) : button & sphere images, localized text groups (auto generated) : button image, localized text SOS Machine (Ubuntu) Dataset Playlists & Media (images/movies, thumbnails, data catalog) Directories under /shared/sos/kiosk images: group images playlists: kiosk, groups, group datasets, localized datasets & group text

8. 8 SOS Users Collaborative Network Workshop Dec. 2-4, 2015 Using the Admin UI SOS Settings Viewpoint Correction (Configuration tab) : Ready → Rotate → Set autoplay: 0 (off), 1 (within group), or 2 (random) duration: dataset play time (autoplay on) timeout: autoplay resume time (autoplay on) Colors and Fonts Title Area: banner_background, banner_fontcolor Main UI: background, fontcolor Information Box: content_fontsize Buttons Datasets and Overlays: circlecolor, nowcolor (current selection) Groups: nowcolor (current selection) Language Options locale_default: xx_YY (ISO Locale: xx = language, YY = country; en_US is the default) locale_options: comma separated locale list (e.g., “en_US,zh_TW,es_MX”)

9. 9 SOS Users Collaborative Network Workshop Dec. 2-4, 2015 Customizing UI Text UI text files Not autogenerated on SOS machine Uses locale naming: xx_YY.txt (ISO Locale: xx = language, YY = country; en_US is the default) Propery file format: name = value lines (plus comments) Notepad.exe can edit Minimum requirements config\en_US.txt: title, subtitle, dataset, overlays config\info\en_US.txt: freeform text about SOS and how to use the kiosk Add translated versions for locales in locale_options property xx_YY.txt files under config and config\info Anything missing defaults back to en_US version

10. 10 SOS Users Collaborative Network Workshop Dec. 2-4, 2015 Configuring Groups and Datasets Playlists on SOS machine define Group Column, Overlay Column, and Dataset Rows kiosk.sos: master playlist for the kiosk include = lines for each group playlist in order (top-to-bottom) Group playlists include = lines for each dataset in order (left-to-right) icons = path to button image (non-standard use of this keyword) playlist name is default group label (e.g., air.sos for “air” group) Datasets: default name & description from SOS Data Catalog

11. 11 SOS Users Collaborative Network Workshop Dec. 2-4, 2015 Customizing Dataset and Group Text Customize and localize using playlists Use to autogenerate datasets and groups files on SOS machine Uses locale naming: xx_YY.sos (ISO Locale: xx = language, YY = country; en_US is the default) Files go in playlists/locale/dataset and playlist/locale/groups Groups Files go in playlist/locale/groups Use include = and rename = lines for each group Datasets Files go in playlists/locale/dataset Use include =, rename =, and description = lines for each group Default kiosk installation en_US for all groups and datasets zh_TW for all groups and some datasets

12. 12 SOS Users Collaborative Network Workshop Dec. 2-4, 2015 Setting Groups and Datasets on the Kiosk Run media2kiosk command line utility on SOS machine Reads playlists and generates the groups and datasets file hierarchy Do not edit the generated files! Modify the playlists and rerun media2kiosk. Must transfer groups and datasets files to the kiosk machine Two options: “Sneaker net”: use a flash drive to copy files Use FTP (instructions in NOAA SOS Public Kiosk manual) SOS machine: vsftpd (free FTP server) Windows: free client (e.g., FileZilla or FireFTP)

13. 13 SOS Users Collaborative Network Workshop Dec. 2-4, 2015 Questions?