updating - wam-higgins/wam-ipad GitHub Wiki

Setting up the iPad

These settings will allow the iPad to sync with the files on this GitHub repository.

  1. Lock it down as necessary for Administrative security.
  2. Install Kiosk Pro Plus
  3. Kiosk Pro Plus settings:
    1. Homepage: wam-ipad-main/index.html
    2. Screensaver: wam-ipad-videos/screensaver.mp4
    3. Image Duration: 5 seconds
    4. Image fade: 1 second
    5. Display Section: All off
      1. Navigation bar: Show always,
      2. Placement: Bottom of screen,
      3. show icons: all on.
    6. Interaction: All off,
      1. Pinch to Zoom: Always Allow
    7. Content Refresh: 30 seconds
    8. Pause Idle Timer while Media is Playing: On
    9. Remote Update of Local Files (IMPORTANT!)
      1. Enable Remote Update of Local Files: ON
      2. Update Period (Minutes): 1. (1 for testing, higher for production.)
      3. Version XML File Location: https://raw.githubusercontent.com/wam-higgins/wam-ipad/refs/heads/main/localversion.xml
    10. Connect iPad to the internet and run Kiosk Pro Plus in view mode. Allow sync to complete. There is no clear indication on the iPad when this happens..... I wish there was a way around this.

Procedures for updating the iPad at WAM

  1. Log in to GitHub.
  2. Go to the main wam-ipad project page
  3. Create a new branch for your changes
  4. Change to that branch.
  5. Make all your changes in your new branch.
  6. Edit localversion.xml and change the integer to one more than you see there. This will tell the iPad to update.
  7. When you're done making changes, create a Pull Request.

From there, an admin or moderator will review your changes and if all looks good, will merge your changes into the "main" branch. At the completion of the merge, the iPad will update automatically.
The admin or moderator should then deploy the code to the test site so you can see your changes.

⚠️ **GitHub.com Fallback** ⚠️