Skip to content

Commit 224c329

Browse files
authored
Update versions.markdown
Add links to trees and downloads.
1 parent 2840df0 commit 224c329

File tree

1 file changed

+28
-33
lines changed

1 file changed

+28
-33
lines changed

versions.markdown

Lines changed: 28 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -4,49 +4,40 @@ title: Flavors and Versions
44
categories: getting-started
55
---
66

7-
By default, Psychtoolbox provides the so called **`beta`** branch or flavor.
8-
The **`beta`** branch provides the latest features, performance enhancements
9-
and bug fixes. These features have been tested by the [developers][] on the
10-
system configurations at their disposal and should be reasonably safe for real
11-
world use.
12-
13-
However, there may be undiscovered bugs, and with the very limited resources
14-
new stuff needs to see real world use to shake out remaining bugs. We rely on
15-
*you* for the testing of new features and for feedback about problems or bugs.
16-
177
Versioned Releases
188
------------------
199

20-
The `beta` branch of PTB is normally updated for the purpose of introducing
21-
bug fixes, new features or incremental improvements. Thus the `beta` branch
22-
pushes out rolling releases.
10+
Psychtoolbox is normally updated for the purpose of introducing bug fixes, new
11+
features or incremental improvements. New releases usually habe a bump in the
12+
4th version number, the `z` in `3.x.y.z`.
2313

2414
Executing the command `PsychtoolboxVersion` should return the *version number,
2515
flavor and revision number* of your current Psychtoolbox. The command also
2616
prints a web URL, which points to the online change log where you can read in
2717
detail what has changed between different revisions. *Since 8th January 2024,
2818
this may no longer be the case for new Psychtoolbox downloads and updates.*
2919

30-
Before any potentially disruptive changes are merged into the `beta` branch, we
31-
tag and release a new version of Psychtoolbox following the versioning scheme
20+
Before any potentially disruptive changes are released, we tag and release a new
21+
version of Psychtoolbox with the `y` bumped following the versioning scheme
3222
**`Psychtoolbox-3.x.y`**. Examples of such disruptive changes would be the
3323
discontinuation of support for an operating system, Matlab version, or a computer
3424
hardware platform - anything that could introduce functional regressions into your
35-
existing hardware and software environment. We recommend to stick with the `beta`
36-
branch, unless you have good reason not to do so, as it is the only officially
25+
existing hardware and software environment. We recommend to keep up with the latest
26+
release, unless you have good reason not to do so, as it is the only officially
3727
tested and supported branch.
3828

3929
Previous Releases
4030
-----------------
4131

42-
The following releases of old Psychtoolbox versions are available.
32+
The following releases of old Psychtoolbox 3.x.y versions are available.
4333

4434
*To download and install the following versions, go to our GitHub repository
45-
and checkout or download the correspondlingly named Git branch.*
35+
and checkout or download the correspondlingly named Git branch. Or simply download
36+
the linked zip file with the latest release of a given 3.x.y branch.*
4637

4738
`Psychtoolbox-3.0.20`
48-
: A snapshot of the code as of 30th March 2025: This was the final 3.0.20 release
49-
before start of the 3.0.21 series. 3.0.20 was the last version to support:
39+
: [A snapshot of the code as of 30th March 2025: This was the final 3.0.20 release
40+
before start of the 3.0.21 series. 3.0.20 was the last version to support:](https://github.com/Psychtoolbox-3/Psychtoolbox-3/releases/tag/3.0.20.4)
5041

5142
* Last version tested on macOS 12. Future versions may or may not work on the macOS 10.13-10.15 and macOS 11.x/12.x operating systems.
5243

@@ -63,8 +54,8 @@ and checkout or download the correspondlingly named Git branch.*
6354
identical to the final 3.0.20.4 release in every aspect.
6455

6556
`Psychtoolbox-3.0.19`
66-
: A snapshot of the code as of 14th December 2024: This was the final 3.0.19 release
67-
before start of the 3.0.20 series. 3.0.19 was the last version to support:
57+
: [A snapshot of the code as of 14th December 2024: This was the final 3.0.19 release
58+
before start of the 3.0.20 series. 3.0.19 was the last version to support](https://github.com/Psychtoolbox-3/Psychtoolbox-3/releases/tag/3.0.19.16):
6859

6960
* Last version tested on macOS 12. Future versions may or may not work on the macOS 10.13-10.15 and macOS 11.x/12.x operating systems.
7061

@@ -76,9 +67,11 @@ and checkout or download the correspondlingly named Git branch.*
7667
Future versions will require a paid license key for macOS and Windows, whereas the Linux versions
7768
remain free to use until future notice.
7869

70+
[Download link for zip file for 3.0.19.](https://github.com/Psychtoolbox-3/Psychtoolbox-3/releases/download/3.0.19.16/3.0.19.16.zip)
71+
7972
`Psychtoolbox-3.0.18`
80-
: A snapshot of the code as of 17th February 2023: This was the final 3.0.18 release
81-
before start of the 3.0.19 series. 3.0.18 was the last version to support:
73+
: [A snapshot of the code as of 17th February 2023: This was the final 3.0.18 release
74+
before start of the 3.0.19 series. 3.0.18 was the last version to support:](https://github.com/Psychtoolbox-3/Psychtoolbox-3/releases/tag/3.0.18.13)
8275

8376
* 64-Bit Octave-6.3 and 6.4 for MS-Windows and Apple macOS.
8477

@@ -92,9 +85,11 @@ and checkout or download the correspondlingly named Git branch.*
9285

9386
Requires 64-Bit GStreamer 1.18.5 MSVC on Microsoft Windows for both Matlab and Octave. GStreamer 1.18 recommended on macOS.
9487

88+
[Download link for zip file for 3.0.18.](https://github.com/Psychtoolbox-3/Psychtoolbox-3/releases/download/3.0.18.13/3.0.18.13.zip)
89+
9590
`Psychtoolbox-3.0.17`
96-
: A snapshot of the code as of beginning of October 2021: This was the final 3.0.17 release
97-
before start of the 3.0.18 series. 3.0.17 was the last version to support:
91+
: [A snapshot of the code as of beginning of October 2021: This was the final 3.0.17 release
92+
before start of the 3.0.18 series. 3.0.17 was the last version to support:](https://github.com/Psychtoolbox-3/Psychtoolbox-3/releases/tag/3.0.17.12)
9893

9994

10095
* 64-Bit Octave-6.1 and 6.2 for MS-Windows and Apple macOS.
@@ -111,8 +106,8 @@ and checkout or download the correspondlingly named Git branch.*
111106
Requires 64-Bit GStreamer 1.18 MSVC on Microsoft Windows for both Matlab and Octave. GStreamer 1.18 recommended on macOS.
112107

113108
`Psychtoolbox-3.0.16`
114-
: A snapshot of the code as of beginning of November 2020: This was the final 3.0.16 release
115-
before start of the 3.0.17 series. 3.0.16 was the last version to support:
109+
: [A snapshot of the code as of beginning of November 2020: This was the final 3.0.16 release
110+
before start of the 3.0.17 series. 3.0.16 was the last version to support:](https://github.com/Psychtoolbox-3/Psychtoolbox-3/releases/tag/3.0.16.8)
116111

117112

118113
* 64-Bit Octave-5 for MS-Windows and Apple macOS.
@@ -130,8 +125,8 @@ and checkout or download the correspondlingly named Git branch.*
130125
* Official Windows-7, Windows-8 and Windows-8.1 support. However, older versions than Windows-10 should currently continue to work with v3.0.17, but are no longer tested or guaranteed to stay compatible.
131126

132127
`Psychtoolbox-3.0.15`
133-
: A snapshot of the code as of beginning of August 2019: This was the final 3.0.15 release
134-
before start of the 3.0.16 series. 3.0.15 was the last version to support:
128+
: [A snapshot of the code as of beginning of August 2019: This was the final 3.0.15 release
129+
before start of the 3.0.16 series. 3.0.15 was the last version to support:](https://github.com/Psychtoolbox-3/Psychtoolbox-3/releases/tag/PTB_Beta-2019-07-25_V3.0.15)
135130

136131

137132
* 64-Bit Octave-4.4.1 for MS-Windows.
@@ -147,8 +142,8 @@ and checkout or download the correspondlingly named Git branch.*
147142

148143

149144
`Psychtoolbox-3.0.14`
150-
: A snapshot of the code as of beginning of September 2018: This was the final 3.0.14 release
151-
before start of the 3.0.15 series. 3.0.14 was the last version to support:
145+
: [A snapshot of the code as of beginning of September 2018: This was the final 3.0.14 release
146+
before start of the 3.0.15 series. 3.0.14 was the last version to support:](https://github.com/Psychtoolbox-3/Psychtoolbox-3/releases/tag/PTB_Beta-2018-05-26_V3.0.14)
152147

153148

154149
* 64-Bit Octave-4.2 for MS-Windows.

0 commit comments

Comments
 (0)