Skip to main content

Downloading from GitHub

Most workshop materials are stored in GitHub repositories.

If you know how to use git, you can clone the repositories to your computer to download the files.

If you don’t know how to use git (which is completely OK), you can download the contents of the repository as a .zip file.

On the main page for each repository, there is a green Clone or Download button. Click this button, and then choose Download Zip:

This will download a .zip file to your computer. The specifics of your web browser, operating system, and settings will determine where the file downloads to and whether it is automatically unzipped. Unless you direct the file to be saved elsewhere, you should be able to find it in your Downloads folder or whatever directory you use to save files from the web.

The file will be named something like name-of-repository-master.zip. If the file is not unzipped automatically, try double clicking on it to open it, or right-click on it to find an unzip option.

You likely want to move the folder somewhere else on your computer where you can find and access it. The workshop instructor will provide you with instructions on what files, if any, to open and use for the workshop.

Downloading Individual Files

It’s generally best to download the entire repository following the instructions above. If you’re trying to download an individual file, then you need to make sure to download the RAW version of the file.

Click through the GitHub repository until you’re on the page for an individual file. Then click the Raw button to see the raw version of the file.

For most file types (such as .Rmd, .R, .ipynb), this will open a plain text version of the file in the web browser (for certain file types, it might instead prompt you with a download option, which you can use).

You want to save this plain text version of the file. From the web browser menu (File menu, or right-click on page), choose Save Page As (or similar option). For the format or file type, make sure you’ve chosen an option of All Files (or similar). Then save the file. You want the file you download to have the same file extension as you see in GitHub, without .txt or .html added.

If you try to open the file and it looks garbled, try deleting the file you downloaded (overwriting it sometimes doesn’t work correctly) and go through the steps again, making sure you get the Raw version and saving it as All Files type.