Documentation

Keera Posture is a computer program that notifies you when you change your sitting position for too long. It can be used to help you sit correctly while you use your computer or while you read.

Disclaimer: only a doctor or a qualified therapist can teach you how you should sit to avoid injuries. We are not qualified to teach you that. We are neither doctors nor therapists. This program does not teach you ergonomics and we cannot be liable for any injuries you suffer while you use this software. By using it you agree not to sue us. Do not use this program if you do not agree with these terms. Do not purchase this software if you do not agree with these terms. All licences and purchases are non-refundable.

The steps to use the program are really simple: install it, start it, register your license, and calibrate the software. After that, the program will remember how you sat when you calibrated it and will warn you if you sit in a different position for more than a few seconds.

Requirements

To use Keera Posture you need:

  • A PC with Windows XP or above (32bit compatible) or GNU/Linux (x86 or amd64 architecture)
  • A working webcam that is compatible with your operating system. Keera Posture uses OpenCV, so it must be compatible with it as well.
  • 30MB (linux) – 50MB (windows) of free space in your hard disk.
  • 256MB of RAM memory. The program uses between 15 and 25 MB of RAM during normal operation.
  • A light room where you can be seen through the webcam.

The effectiveness of the program depends on the lighting conditions of the room where you work and the quality of your webcam. We have been able to use it with 320×240 colour webcams at 2fps. However, we cannot guarantee that it will work in very complex setups. If unsure, you can download it and test it for up to one hour without a licence, but the program will stop working after that time if no licence is provided. That should be enough to know if you want to purchase a licence or not.

Downloading, Installing and Registering your licence

Starting from October 29th, you’ll be able to buy this program at http://keera.es/shop/. Once you buy it, a licence file and a link to the installation files will be sent to your email. This licence will work with the current version of Keera Posture at the time of purchase and all future versions for an unlimited time.

Follow the instructions in the email to download and install the software.

  • If you are using GNU/Linux, you’ll have the option to download a DEB file (for Ubuntu or Debian).
  • If you are using Windows, you’ll be able to download an Installation file (as an EXE).

Once the program is installed, you’ll be able to find it in Start > Programs > Keera Studios > Keera Posture in Windows or Applications > Keera > Keera Posture in Gnome/KDE. The location in other configurations might differ.

Start the program ‘Keera Posture’ and you will see it dock in your traybar or notification area (most likely, on one of the right corners of the screen, next to the clock).

Attached to the email we send you there is a copy of your licence file. Save this file somewhere in your computer (i.e. Desktop or ‘My Documents’) and remember the location where you saved it. Right click on the Keera Posture status icon that docked in your traybar and click preferences. Go to Registration, and click the button labelled ‘Load file’. A file dialog will show up where you can select the licence file and open it.
If you have done this successfully, the preferences dialog should show a green tick-like symbol with the text “This is a valid licence file”.
In this case, and as long as the licence has not been flagged for being used in many different computers, Keera Posture will run indefinitely.

Program calibration and normal operation

Keera Posture must be calibrated before you can use it. Essentially, you must let the program know how you should sit.

Keera Posture needs exclusive access to your webcam. That means you have to stop using your webcam with Skype, Google Talk or any other program. Most webcams have a blue or green light on them that turns on when the webcam is being used. If Keera Posture is disabled and the light is still on, that means another program is using it and you will not be able to use Keera Posture at the same time. Close the other program first or stop using the webcam with them if such option exists.

Once your webcam is free, sit correctly and right click on the tray icon, then click on Calibrate. You will probably see your webcam’s light flash for two seconds. If the program has been able to detect you correctly, you only need to activate it by clicking on its tray icon once. If the detection system is activated, the webcam light will be on.

If you need to use the webcam with another program for a while, you can easily disable Keera Posture by just clicking on it once. The icon will tell you whether it’s currently enabled or not. Click it once again to turn it back on.

Other notification methods

When Keera Posture notifies you, it changes it’s icon in the tray bar or status bar and it plays a very subtle click sound. If you prefer, you can activate an overlay translucent warning window as your notification system. Just right click on the icon and enable or disable the notification methods “Notify by sound” and “Notify by overlay” to suit your needs.

Preferences

Keera Posture allows a reasonable degree of customisation to more complex environments. There are four elements that can be adapted to the user’s needs:

  • Language: Select the language that you understand the better. If you select automatic, Keera Posture will try to use you system’s language if available.
  • Webcam: select the webcam you want to use with Keera Posture. The default value is 0, which means “the first webcam the system can find”, and you can get it up to 10.
  • Delay: the program must detect you sitting in the wrong position for a few seconds before it notifies you. Just moving won’t trigger a warning, because we all move a little while we work. If you increase the delay, the program will take longer to notify you when you stay in the wrong position. Although provided, values below 4 (frames) are probably unsuitable.
  • Correction: the program uses a complex algorithm to decide whether it has to notify you or not. By default, this value is set to work best at a distance of 50cm from the webcam. If you increase this value, you’ll be relaxing that algorithm so that it notifies you less. This may be useful if it’s notifying you even when you don’t move much (if you are very, very close). If the value you set here is too high, it will not notify you at all.
  • Keera Posture needs exclusive access to your webcam. That means you have to stop using your webcam with Skype, Google Talk or any other program while Keera Posture uses it. Most webcams have a green or yellow light on them that turns on when the webcam is being used. If Keera Posture is disabled and the light is still on, that means another program is using it and you will not be able to use Keera Posture at the same time. Close the other program first or stop using the webcam with them if such option exists.

    Once your webcam is free, sit correctly and right click on the tray icon, then click on Calibrate. You will probably see your webcam’s light flash for two seconds. If the program has been able to detect you correctly, you only need to activate it by right clicking on its tray icon and selecting ‘Enable’. If the detection system is activated, the webcam light will be on.

    Troubleshooting

    • I click on ‘Enable’ but the program doesn’t do anything or The light doesn’t turn on when I click on ‘Enable’.
      • The program will silently refuse to be enabled if you have not calibrated it or if it could not detect you during the calibration phase. Check that you are in the webcam’s viewing angle and that the lighting conditions are good enough. Then right click on the tray icon and select Calibrate. If the problem persists, use any software capable of recording from your webcam to check that you are effectively in the webcam’s viewing angle. Check also the program preferences and reset them to their default values if necessary.
    • Keera Posture does not work with my webcam.
      • We want to make sure that our program works with as many webcams as possible. Please, contact us at ‘support AT keera DOT es’ if your webcam works with your Operating System but refuses to work with Keera Posture. We’ll channel your message to the appropriate destination so that support for it may be added in future versions.