Eclipse Download and Installation
(for Python) Instructions


Install Python before installing Eclipse; Eclipse installs Java.

You may want to print these instructions before proceeding, so that you can refer to them while downloading and installing Eclipse. Or, just keep this document in your browser. You should read each step completely before performing the action that it describes.

This document shows downloading and installing Eclipse (2021-06) on Windows 10 in Summer 2021. You should download and install the latest version of Eclipse. The current latest (as of Summer 2021) is Eclipse 2021-06.

Remember that you must install Python, and Eclipse as 64-bit applications. In fact, Eclipse can be installed only as a 64-bit application.


Eclipse: (2021-06)

The Eclipse download requires about 54 MB of disk space; keep it on your machine, in case you need to re-install Eclipse. When installed, Eclipse requires an additional 350 MB of disk space.

Downloading

  1. Click Eclipse

    The following page will appear in your browser. If your computer uses Windows, continue below; otherwise choose either Mac OS X or Linux instead.

  2. Click the orange Download x86_64 button. (If necessary, click the Windows x86_64 link, located under Download on the right side of the big blue banner).

    You will see the following page (don't worry about the name of the institution underneath the orange Download button).

  3. Click the orange Download button. The site named here, beneath the button: Canada - RafalRzeczkowski (http) is the random one chosen by the download page this time; yours may differ.

    The following pop-up window titled Opening eclipse-inst-jre-win64.exe will appear.

    Click the Save File button.

    This file should start downloading in your standard download folder. This file is about 115 Mb so it might take a while to download fully if you are on a slow internet connection (it downloads quickly over a cable modem).

    The file should appear as

    Terminate the tab browsing the Eclipse webpage.

  4. Move this file to a more permanent location, so that you can install Eclipse (and reinstall it later, if necessary).

  5. Start the Installing instructions directly below.


Installing Eclipse (for Python)

Python should be installed before installing Eclipse

  1. Double-click the icon labeling the file eclipse-inst-win64.exe.

    It might take a few seconds to a a few minutes, but watch for the following Eclipse Installer pop-up window to appear.

    It will soon disappear and be replaced by another Eclipse Installer pop-up window. Scroll down in this window until you see Eclipse IDE for Eclipse Committers

  2. Click on Eclipse IDE for Eclipse Committers.

    Another Eclipse Installer pop-up window will appear.

  3. Click the Install button.
    (When I installed Eclipse on my Surface, I was first presented with an Eclipse Foundation Software User Agreement, on which I clicked Accept Now. After installation, there was no Oomph License Confirmation.)

    The Eclipse Installer pop-up window will continue to show a green progress bar

    Eventually, an Oomph License Confirmation pop-up window will appear.

  4. Click the Accept button.

    The Eclipse Installer pop-up window will continue to show a green progress bar

    Eventually, the Ecliplse Installer pop-up window will appear.

  5. Click the Launch button.

    The installer will create a shortcut (the "death-star" icon) on your desktop to the eclipse.exe file in this eclipse folder. Generally, you will double-click this icon to start Eclipse.

    But the Eclipse Installer will automatically start it for you, at which point the following splash window will appear

    and then an Eclipse Launcher pop-up window will appear.

    In the Workspace text box, your name should appear between C:\Users\ and \eclipse-workspace, instead of pattis.

    Leave unchecked the Use this as the default and do not ask again box. Although you will use this same workspace for the entire quarter (checking projects in and out of it), it is best to see this Workspace Launcher pop-up window each time you start Eclipse, to remind you where your workspace is located.

    In fact, it is a good idea to create on your desktop a shortcut to your workspace folder; but you must click Launch (see below) before Eclipse creates this folder and you can create a shortcut to it.

  6. Click Launch.

    If you have an older version of Eclipse installed, the following pop-up window will apperar.

    If this pop-up window appears, click Continue to update the workspace for the newer version of Eclipse.

    Progress bars will appear on the Splash window as Eclipse loads.

    Eventually the Eclipse Workbench will appear.

    If it shows as being covered with a Welcome tab, terminate it by clicking X on the Welcome tab. You will not see the Welcome tab when you start Eclipse again, after this first time.

    If it further shows a Donate tab, terminate it by clicking X on the Donate tab.

  7. Click Help (on the far right of the line below this window's blue title eclipse-workspace - Eclipse IDE) and then click Install New Software... in its pull-down menu, as shown below.

    The Install pop-up window will appear.

  8. Enter the text (or cut/paste from this document) http://pydev.org/updates into the Work with text box and press Enter (if that doesn't work, try http://www.pydev.org/updates).

    In a few seconds the information under Name should change from
    There is no site selected to Pending and ultimately to

    Select only the top PyDev checkbox; do NOT select the PyDev Mylyn Integration (optional) box.
    Check before proceeding that the Install pop-up window appears as

  9. Click Next >

    A new Install pop-up window will appear.

  10. Click Next >

    A new Install pop-up window will appear.

    Select the I accept the terms of the license agreement radio button, so the window appears as

  11. Click Finish

    The lower right-hand corner of the eclipse-workspace - Eclipse IDE window will show the various operations it is performing and a progress bar for each one.

    Because the installer is fetching various files online, this process might take a few minutes.

    If you see a Security Warning pop-up window

    Click Install anyway.

    The installation will finish (the progress bar will disappear).

    A Software Updates pop-up window will appear.

  12. Click Restart Now

    Eclipse will terminate and restart. Once again will show the Eclipse Workbench.

    As you did in step 4, if you see a Welcome Tab covering the window, terminate it by clicking OK on the Welcome Tab.

    If a Windows Security Alert pop-up window appears

    click Allow Access.

    Notice in the upper right-hand corner of the Eclipse Workbench, you should see the following 2 icons.

  13. Click the left icon, which displays an Open Perspective pop-up window. Click on the "double-snake" Python icon labelled PyDev and then click on the Open button.

    The Eclipse Workbench will now appear as

    Repeat this process selecting the "green bug" icon labelled Debug in the Open Perspective pop-up window. Now the top-right corner should show four icons:

    Next, right-click the "J" icon (the second one) and then click Close.

    Finally, click on the "double-snake" icon. Now the top-right corner should show three icons:

  14. Click Window (to the left of Help on the far right of the line below this window's blue title eclipse-workspace - Eclipse IDE) and then click Preferences in its pull-down menu, as shown below.

  15. Drill down to select the interpreter:
    • Disclose PyDev by clicking the > in front of PyDev or double-clicking PyDev (after the >); the > changes to a v.
    • Disclose Interpreters by clicking the > in front of Interpreters or double-clicking Interpreters (after the >); the > changes to a v.
    • Select/Click Python - Interpreter.

    The Preferences pop-up window should appear as follows.

  16. Click New... at the top-right of the top pane and then click Browse for python/pypy.exe.

    A Select Interpreter and Open pop-up window appear. In the Open pop-up window, navigate to that folder in which Python was installed: C:\Users\pattis\AppData\Local\Programs\Python\Python39.

    Double-click python.exe (or select it and click Open).

    Change the Interpreter Name in the Select Interpreter pop-up window from python to Python39 (or whatever the latest version of Python you have installed). The Select Interpreter pop-up window should appear as

  17. Click OK.

    A Selection needed pop-up window will appear.

    Your window should have all four of these checkboxes checked.

  18. Click OK.

    Click the Libraries tab (2nd one) above the lower pane. The Preferences pop-up window will appear as

    Actually, on my system I had to first shrink the Name tab and then enlarge the Location tab for the top pane, so that I could see the entire path to the Python interpreter.

  19. Click Apply and Close.

    A Progress Information pop-up window will appear.

    During installation, it will show the various operations it is performing and a progress bar for each one. Eventually the installation will terminate.

    If the following pop-up window appears

    Ensure the "Public networks, such as those in airports...." checkbox is NOT checked, and then click Allow Access.

  20. Locate the workspace folder created in step 5 (see C:\Users\yourname\eclipse-workspace) and download the courselib.zip file into this workspace and unzip it there, producing the courselib folder; it should should contain a bunch of Python module files (ending in .py). From time to time you may be asked to put other course-specific Python module files into this courselib folder; these modules will be usable (via import) in all Python projects in Eclipse.

  21. Inform Eclipse to use the courselib folder in all Python projects.
    • Select Window | Preferences.
    • Disclose PyDev by clicking the + in front of PyDev or double-clicking PyDev (after the +); the + changes to a -.
    • Disclose Interpreters by clicking the + in front of Interpreters or double-clicking Interpreters (after the +); the + changes to a -.
    • Select Python - Interpreter.
    • Click the Libraries tab (2nd above the bottom pane).

    • Click the New Folder button (topmost, right of the bottom pane).
    • Browse to the courselib folder (added above) in the Browse for Folder pop-up window (C:\Users\yourname\eclipse-workspace\courselib).
    • Click the courselib folder selected, and then click SelectFolder.
      Notice a fifth entry (C:\Users\yourname\eclipse-workspace\courselib) appears in the bottom-right pane named System PYTHONPATH. Reorder with Drag & Drop.
    • Click Apply (you will see some progress bars).
      The pop-up window should now appear as

    • Cick Apply and Close. You will see a brief progress bar on your screen.

  22. Terminate (click X on) the Eclipse window.

    You may see a Confirm Exit pop-up window.

    If you do, Click the Exit button.

    Eclipse will terminate.

Eclipse is now installed for Python. It can be activated by click the Eclipse shortcut icon which should appear on your desktop. It's actual name will be Eclipse IDE for Eclipse Committers - 2021-06 but I suggest just renaming it Eclipse.