kmscript Start - KMScript

Microsoft Windows
- first run
  - goto Download in top, click the link to download for you OS
  - after download, just unzip(such 7-zip winrar) to any directory(without install)
  - move into kms directory, double click the play.bat to run
  - after run will got an command window(call console), that's the kmsciprt main interface, keep open(don't close)
  - if u got the firewallwarning, just cancel(or allow the remote access, other device can browse the http://IP:8181 to access)
  - open the browser(such Microsoft Edge, IE, Mozilla Firefox, Google Chrome), goto http://127.0.0.1:8181u will see the loginform
  - by default the password is manage, enter the password to login, u can see the kmscript main config(W3Config, the password can change here)
    (try move over and hold the link/field u will get the tip for help)
  - don't forget change the default password
  - now goto the KMSZ guide(for user) or KMS design(for developer) to continue
- close
  - just close the command(console) window
    if KMS is running, do close the window may break any file in the writing
- uninstall
  - just delete the kms directory(folder)
- update
  - download the update(such kms-update.zip), then unzip to same directory
    make sure the kmscript not running before update
  - the update very small and can use for all version
  - the update will not overwrite the KMS and resources you created, nor will it affect the existing settings
  - the update can also use the menu named ROM Upgrade in the kmscript
    recommand for remote access
- other
  - in Windows, the WMI service(Winmgmt) must enabled
  - kmscript can run with any JRE, such openJDK, oracle JRE
  - if the KMSZ is locked, u need an keyfrom developer and must online to activation, and few the cloud function also need online
Linux / BSD
- kmscript are B/S design, especially on ARM-box, todo that see Integration with kmscript
- first run
  - download the kmscript, two options:
    - use the standalone kmscript(include the JRE, but not recommend)
      goto Download in top, click the link to download for you platform, for example: linux ARM HF
    - use the linuxdistribution's JRE(recommend, the certificates, font, audio mixer got right)
      - enter the shell(or Terminal), get the distribution infomation, such cat /etc/issue
      - install the java JRE 8 or high, such openJDK, Oracle JRE
        remmeber: headless is first option, the headless much less(without graphical user interface so without X11 etc..). unless the image engine required(such demo.Tester)
        Red Hat/Fedora, here official wiki, for example java-1.8.0-openjdk-headlessor java-1.8.0-openjdk
        Ubuntu, here official tutorials, such openjdk-8-jre-headlessor openjdk-8-jre
        Debian, here official wiki, such default-jre-headlessor default-jre
        ArchLinux, here official wiki, such jre8-openjdk-headlessor jre8-openjdk
        FreeBSD, here official wiki, such openjdk8-jre
        FONTCONFIG is recommend
        X11 is option (headless)
        Gentoo, here official wiki, such openjdk
        headless-awt is option(headless)
      - goto Download in top, get the link from Other
  - upzip to an directory, such /root/
    tar -xpf /tmp/kms-*.tgz -C /root/ rm /tmp/kms-*.tgz
  - run /root/kms/play.sh
    - play.sh support the parameter, syntax: play.sh [-v | kmsz[KEY_1013_SCRIPT_OPTIONS]], for example:
      - show the version
        sh /root/kms/play.sh -v
      - scan the kmscript ip address on local area network(takes 1 minute)
        sh /root/kms/play.sh --scan
      - override the Startup Script in W3Config
        sh /root/kms/play.sh pub/demo1.kmsz
      - override the Startup Script and Script Variable in W3Config
        sh /root/kms/play.sh pub/demo1.kmsz "{'$a': 1, '$b': 'test1'}"
      - override the Script Variable(without Startup Script) in W3Config
        sh /root/kms/play.sh null "$a=1"
- update
  - see Microsoft Windows same part
- other
  - kmscript not require the root authority, and will not change(read/write) outside of the kms directory
  - few the engine(such camera, multi-keyboard) may need same access so run as root is recommend.
    u can ask the KMSZ developer for that, for now inside the kmscript require:
    the /sys/class/gpio/* when use GPIO function
    the /sys/class/leds/* when use LED function
    the /dev/video* when use local camera image engine
Apple Mac OS
- see Linux
Google Android
- see Android Manual

UI: li_tag