diff --git a/docs/source/conf.py b/docs/source/conf.py
index 9076ba895d..17d70c22dd 100755
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -33,7 +33,8 @@
'sphinx.ext.mathjax',
'sphinx.ext.napoleon',
'sphinx.ext.intersphinx',
- 'sphinx.ext.viewcode']
+ 'sphinx.ext.viewcode',
+ 'sphinx_design', 'sphinx_copybutton']
autoclass_content = 'both'
autosummary_generate = True
diff --git a/docs/source/download.rst b/docs/source/download.rst
index a4b99742d2..07002ec2db 100644
--- a/docs/source/download.rst
+++ b/docs/source/download.rst
@@ -8,39 +8,72 @@ Download
For the easiest installation download and install the Standalone package.
+.. tab-set::
+
+ .. tab-item:: Windows
+
+ For the easiest installation download and install the Standalone package.
+
+ .. button-link:: https://github.com/psychopy/psychopy/releases/download/2024.2.1/StandalonePsychoPy-2024.2.1post4-win64-py310.exe
+ :color: primary
+
+ PsychoPy |version| modern (py3.10)
+
+ .. button-link:: https://github.com/psychopy/psychopy/releases/download/2024.2.1/StandalonePsychoPy-2024.2.1-win64-py3.8.exe
+ :color: primary
+
+ PsychoPy |version| compatibility+ (py3.8)
+
+ The *Compatibility+* version is for users who need to run older scripts that are not compatible with the newer versions of Python (PsychoPy has supported Python 3.10 since 2022.2.0).
+
+ .. tab-item:: MacOS
+
+ For the easiest installation download and install the Standalone package.
+
+ .. button-link:: https://github.com/psychopy/psychopy/releases/download/2024.2.1/StandalonePsychoPy-2024.2.1-macOS-py3.10.dmg
+ :color: primary
+
+ PsychoPy |version| modern (py3.10)
+
+ .. button-link:: https://github.com/psychopy/psychopy/releases/download/2024.2.1/StandalonePsychoPy-2024.2.1-macOS-py3.8.dmg
+ :color: primary
+
+ PsychoPy |version| compatibility+ (py3.8)
+
+ The *Compatibility+* version is for users who need to run older scripts that are not compatible with the newer versions of Python (PsychoPy has supported Python 3.10 since 2022.2.0).
+
+ The *modern* version uses a more recent version of Python and cannot run experiments that use PsychoPy<2023.2.0
+
+ .. tab-item:: Linux
+
+ The following will install PsychoPy into
+
+ .. code-block:: bash
+
+ # create a virtual environment and activate it
+ python3.10 -m venv ~/.psychopy_py310
+ source ~/.psychopy_py310/bin/activate
+
+ # fetch and run install script
+ python -c "$(curl -fsSL https://raw.githubusercontent.com/psychopy/psychopy/dev/installPsychoPy.py)"
+
.. raw:: html
**For all versions** see the `PsychoPy releases on github `_
diff --git a/installPsychoPy.py b/installPsychoPy.py
index d272688e8f..a3b4315740 100644
--- a/installPsychoPy.py
+++ b/installPsychoPy.py
@@ -1,4 +1,18 @@
-## python script to install psychopy including dependencies
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+# Part of the PsychoPy library
+# Copyright (C) 2002-2018 Jonathan Peirce (C) 2019-2024 Open Science Tools Ltd.
+# Distributed under the terms of the GNU General Public License (GPL).
+"""
+Python script to install psychopy including dependencies
+
+NB: At present, for windows and MacOS you may as well just use `pip install psychopy` but
+in the future we may add some additional functionality here, like adding application
+shortcuts, checking/recommending virtual envs etc.
+"""
+
+# Author: Jonathan Peirce, based on work of Flavio Bastos and Florian Osmani
import os, sys
import pathlib