MediaPortal Windows Media Center
MediaPortal Wiki > MediaPortal 2 > Contribute > Development > Get the Sources > Git Installation

Git Installation

Was this page helpful?
Redirected from 2 MEDIAPORTAL 2/Contribute/Development/2 Git/Git Installation

    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:

    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

    GitKey_1.png

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

    GitKey_2.png

    • 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"

    Git3.png

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

    Git4.png

    Installing TortoiseGit

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

    TortoiseGit2.png

     

    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

    TortoiseGitConfig1.png




    Tag page (Edit tags)
    • No tags
    Running the latest version?

    V1.7.0 - released April 2014
    Releasenews | Download
    Changelog
     | Requirements
    HTPC
    Team-MediaPortal
     
    About
    Contact |  Press
    Partners