Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Kinect Application Framework including some demo apps

branch: master
README.md

Atos Origin Kinect

This Kinect application framework and demo apps are made by Marco Franssen and Jan Saris. During competence development at their company Atos Origin they started on februari 2011 by creating some apps and a framework with Microsoft Kinect. They started with a implementation in c#/WPF using the PrimeSense drivers and OpenNI SDK.

Contributors

Goal

Our goal is to create a framework for developers on top of Kinect. This Framework should support easy access to gestures etc. All the demo apps we created to test our framework are included. We would love it when you guys help to extend and improve the framework. Don't forget to add your own demo apps so you can show of all the cool stuff you made to the other developers participating.

Install Git

Install Git Extensions. This will provide you a good GUI to Git (easy for Git starters), includes GIT.

SSH Key for github repo access

In order to connect to your github repository you need a SSH Key, so if you don't have one follow the following instructions.

  1. Generate a ssh key

    Navigate to your directory where you did install GitExtensions. (Default: C:\Program Files (x86)\GitExtensions)
    Open the folder PuTTY and click the executable puttygen.exe and click the button Generate.

  2. Save private key

    Optionally configure a password for your private key and then save the private key to a location on your harddrive. (For example: c:\sshKeys\github.ppk)

  3. Paste public key on your github profile

    Optionally save your public key to your harddrive. Then navigate to https://github.com/account/ssh and click add another public key. Copy the public key from puttygen.exe and paste it in the Key input-field and click save. (Title field not required)

How to fork

  1. Fork the Kinect repo

    Fork the Kinect repo by clicking the Fork button on https://github.com/atosorigin/Kinect

  2. Clone the Kinect project

    Navigate to the folder where you want to add the Kinect folder. Right-Click this folder and choose for Git Bash here. Run the following code: (replace username by your own Github username)
    $ git clone git@github.com:username/Kinect.git

  3. Configure remotes

    When a repo is cloned, it has a default remote called origin that points to your fork on GitHub, not the original repo it was forked from. To keep track of the original repo, you need to add another remote named upstream:
    $ cd Kinect the active directory in the prompt to the newly cloned "Kinect" directory
    $ git remote add upstream git@github.com:atosorigin/Kinect.git Assigns the original repo to a remote called "upstream"
    $ git fetch upstream

  4. Pushing

    Pushing is always done to you fork
    $ git push origin master

  5. Fetch the upstream with your fork

    When you want to get the latest changes fetched from the upstream into your fork, you need to fetch the upstream.
    $ git fetch upstream
    $ git merge upstream/master

  6. Pull requests

    Don't forget to do a pull request when you have added value to the project.

Installation

Something went wrong with that request. Please try again.