Who needs to read this page?

Github and MediaPortal 2 are open to read for everybody. If you just want to get a readonly copy of the MediaPortal 2 repository, you do not need to read this page.

If you are a team member who wants to change code and push it to our Github repository, you need to have read/write access to the repository. On the MediaPortal 2 site at Github, Github provides different Git URLs which can be used in different situations. To have read/write access, you need to connect your local Git repository with a read/write URL, typically the SSH URL shown at the Source page of the MediaPortal 2 site on Github. To setup your system and to become able to push changes to Github, you can read the following guide to set-up your system. It depends a bit from your configuration which steps are exactly needed. For example, I use GitExtensions and TortoiseGit both together with msysgit. Others might use another configuration.

Needed Software

First of all you need to download the following programs:

• Putty
• msysgit
• TortoiseGit

During this installation you have to set some important settings. Please be sure that you set them correctly.

Create a SSH-Key

• Download Putty and install it in a folder of your choice, e.g. C:\Program Files\Putty
• Startup puttygen.exe
• Select SSH-2 RSA 1024

• Hit Generate Button and move mouse around to generate key
• Add Key comment and Key passphrase

• Save public and private key
• IMPORTANT: DO NOT USE the public-key-file that puttygen produced (public key for pasting into OpenSSH Authorized_keys
  file). This format with it’s comment at begin and end will not work with github
• Close puttygen.exe and reopen it for the next step

Register public key with github

• Reopen puttygen
• Load the private key from the file you created above.
• At the top of the screen is your OpenSSH SSH public keyword now in a format that can be used with github
• Copy string from “public key for pasting into OpenSSH Authorized_keys file” from the puttygen window
• Add key to your GitHub account (account/SSH Public Keys)

Add SSH Key to Pageant:

• Launch pageant.exe
• From system tray right click, select view keys (should be empty)
• Add key (browse for private key file *.ppk) use your password to read it in

You are now ready to use SSH.

Installing msysGit

• Start Installation program and follow the assistant
• at "Adjust your PATH environment" select "Run Git from Windows Command Prompt"

• at "Configuring the line ending conversions" select "Checkout Windows-style, commit Unix-style line endings"

Installing TortoiseGit

• Start Installation program and follow the assistant
• At "Choose SSH Client" select "TortoisePLink, coming from Putty, integrates with Windows better."

Config TortoiseGit

• Right click in the Explorer window on a file or an directory to call up the context menu
• Select TortoiseGIT->Settings
• Select Config
• Input your Name and Email from your GitHub account