From b2bbe8047d14eb1ff000f95bb0b6ec8c9c3b7a7e Mon Sep 17 00:00:00 2001
From: mscheltienne <mathieu.scheltienne@fcbg.ch>
Date: Thu, 30 May 2024 11:00:13 +0200
Subject: [PATCH 01/12] reorder examples

---
 ...0_player_separate_process.py => 00_player_separate_process.py} | 0
 examples/{00_peak_detection.py => 10_peak_detection.py}           | 0
 2 files changed, 0 insertions(+), 0 deletions(-)
 rename examples/{10_player_separate_process.py => 00_player_separate_process.py} (100%)
 rename examples/{00_peak_detection.py => 10_peak_detection.py} (100%)

diff --git a/examples/10_player_separate_process.py b/examples/00_player_separate_process.py
similarity index 100%
rename from examples/10_player_separate_process.py
rename to examples/00_player_separate_process.py
diff --git a/examples/00_peak_detection.py b/examples/10_peak_detection.py
similarity index 100%
rename from examples/00_peak_detection.py
rename to examples/10_peak_detection.py

From 73765a55c9f8097967b338d480d0fd0e53f2d560 Mon Sep 17 00:00:00 2001
From: mscheltienne <mathieu.scheltienne@fcbg.ch>
Date: Thu, 30 May 2024 11:02:26 +0200
Subject: [PATCH 02/12] improve peak detector example

---
 examples/10_peak_detection.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/examples/10_peak_detection.py b/examples/10_peak_detection.py
index 8fa0e46ff..4b0e5da1f 100644
--- a/examples/10_peak_detection.py
+++ b/examples/10_peak_detection.py
@@ -288,6 +288,7 @@ def __init__(
         self._stream.notch_filter(100, picks=ch_name)
         sleep(bufsize)  # prefill an entire buffer
         # peak detection settings
+        self._last_acq_time = None
         self._last_peak = None
         self._peak_candidates = None
         self._peak_candidates_count = None
@@ -301,6 +302,10 @@ def detect_peaks(self) -> NDArray[np.float64]:
             The timestamps of all detected peaks.
         """
         data, ts = self._stream.get_data()  # we have a single channel in the stream
+        if self._last_acq_time is None:
+            self._last_acq_time = ts[-1]
+        elif self._last_acq_time == ts[-1]:
+            return np.array([])  # nothing new to do
         data = data.squeeze()
         peaks, _ = find_peaks(
             data,

From 60b36c498f68f3ab50d5fa964134036bd7a5d183 Mon Sep 17 00:00:00 2001
From: mscheltienne <mathieu.scheltienne@fcbg.ch>
Date: Thu, 30 May 2024 11:11:52 +0200
Subject: [PATCH 03/12] update performance figure

---
 .../tutorials/qrs-detector-performance.png    | Bin 13339 -> 9389 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/doc/_static/tutorials/qrs-detector-performance.png b/doc/_static/tutorials/qrs-detector-performance.png
index 845ffd7c50416e8f79361212e81c31e22109e91e..82e3b4ed5b7ac346e6d07b765ab7963374920451 100644
GIT binary patch
literal 9389
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
RWdwdsoisHl{LSf){{wQ$uJix^

literal 13339
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
E0HXe&w*UYD


From 1654a2b61eb74297bfafaf817df39d21644f6c61 Mon Sep 17 00:00:00 2001
From: mscheltienne <mathieu.scheltienne@fcbg.ch>
Date: Thu, 30 May 2024 11:54:28 +0200
Subject: [PATCH 04/12] improve coverage and remove assert executor._shutdown

---
 mne_lsl/player/player_lsl.py            |  6 +++---
 mne_lsl/player/tests/test_player_lsl.py |  6 ++++++
 mne_lsl/stream/_base.py                 |  2 +-
 mne_lsl/stream/stream_lsl.py            | 14 +++++++-------
 4 files changed, 17 insertions(+), 11 deletions(-)

diff --git a/mne_lsl/player/player_lsl.py b/mne_lsl/player/player_lsl.py
index 982929db0..1290f9370 100644
--- a/mne_lsl/player/player_lsl.py
+++ b/mne_lsl/player/player_lsl.py
@@ -279,7 +279,7 @@ def _stream(self) -> None:
             else:
                 self._outlet.push_chunk(data, timestamp=self._target_timestamp)
             self._stream_annotations(start, stop, start_timestamp)
-        except Exception as exc:
+        except Exception as exc:  # pragma: no cover
             logger.error("%s: Stopping due to exception: %s", self._name, exc)
             self._del_outlets()
             self._reset_variables()
@@ -296,8 +296,8 @@ def _stream(self) -> None:
             sleep(delay)
             try:
                 self._executor.submit(self._stream)
-            except RuntimeError:
-                assert self._executor._shutdown  # pragma: no cover
+            except RuntimeError:  # pragma: no cover
+                pass  # shutdown
 
     def _stream_annotations(
         self, start: int, stop: int, start_timestamp: float
diff --git a/mne_lsl/player/tests/test_player_lsl.py b/mne_lsl/player/tests/test_player_lsl.py
index 41a8ecfb4..2127c6c4f 100644
--- a/mne_lsl/player/tests/test_player_lsl.py
+++ b/mne_lsl/player/tests/test_player_lsl.py
@@ -114,6 +114,7 @@ def test_player_context_manager_raw_annotations(raw_annotations):
     with Player(
         raw_annotations, chunk_size=200, name=name, annotations=False
     ) as player:
+        assert player.running
         streams = resolve_streams(timeout=2)
         assert len(streams) == 1
         assert streams[0].name == name
@@ -122,6 +123,7 @@ def test_player_context_manager_raw_annotations(raw_annotations):
     assert len(streams) == 0
 
     with Player(raw_annotations, chunk_size=200, name=name) as player:
+        assert player.running
         streams = resolve_streams(timeout=2)
         assert len(streams) == 2
         assert any(stream.name == name for stream in streams)
@@ -336,6 +338,7 @@ def test_player_annotations(raw_annotations, close_io):
     name = "Player-test_player_annotations"
     annotations = sorted(set(raw_annotations.annotations.description))
     player = Player(raw_annotations, chunk_size=200, name=name)
+    assert f"Player: {name}" in repr(player)
     assert player.name == name
     assert player.fname == Path(raw_annotations.filenames[0])
     streams = resolve_streams(timeout=0.1)
@@ -410,7 +413,10 @@ def test_player_n_repeat(raw):
     player = Player(
         raw, chunk_size=200, n_repeat=4, name="Player-test_player_n_repeat-2"
     )
+    assert player.n_repeat == 4
     player.start()
+    assert player.n_repeat == 4
+    assert player.running
     time.sleep((raw.times.size / raw.info["sfreq"]) * 1.8)
     assert player._executor is not None
     streams = resolve_streams(timeout=2)
diff --git a/mne_lsl/stream/_base.py b/mne_lsl/stream/_base.py
index e18ba2bf1..41c93a704 100644
--- a/mne_lsl/stream/_base.py
+++ b/mne_lsl/stream/_base.py
@@ -567,7 +567,7 @@ def get_data(
                     "The Stream is not connected. Please connect to the stream before "
                     "retrieving data from the buffer."
                 )
-            else:
+            else:  # pragma: no cover
                 logger.error(
                     "Something went wrong while retrieving data from a connected "
                     "stream. Please open an issue on GitHub and provide the error "
diff --git a/mne_lsl/stream/stream_lsl.py b/mne_lsl/stream/stream_lsl.py
index 323c03ac0..4c710b948 100644
--- a/mne_lsl/stream/stream_lsl.py
+++ b/mne_lsl/stream/stream_lsl.py
@@ -230,8 +230,8 @@ def _acquire(self) -> None:
                 sleep(self._acquisition_delay)
                 try:
                     self._executor.submit(self._acquire)
-                except RuntimeError:
-                    assert self._executor._shutdown  # pragma: no cover
+                except RuntimeError:  # pragma: no cover
+                    pass  # shutdown
                 return  # interrupt early
 
             # process acquisition window
@@ -249,8 +249,8 @@ def _acquire(self) -> None:
                 sleep(self._acquisition_delay)
                 try:
                     self._executor.submit(self._acquire)
-                except RuntimeError:
-                    assert self._executor._shutdown  # pragma: no cover
+                except RuntimeError:  # pragma: no cover
+                    pass  # shutdown
                 return  # interrupt early
             if len(self._added_channels) != 0:
                 refs = np.zeros(
@@ -296,7 +296,7 @@ def _acquire(self) -> None:
                     "argument or consider retrieving new samples more often with "
                     "Stream.get_data()."
                 )
-        except Exception as error:
+        except Exception as error:  # pragma: no cover
             logger.exception(error)
             self._reset_variables()  # disconnects from the stream
             if os.getenv("MNE_LSL_RAISE_STREAM_ERRORS", "false").lower() == "true":
@@ -305,8 +305,8 @@ def _acquire(self) -> None:
             try:
                 sleep(self._acquisition_delay)
                 self._executor.submit(self._acquire)
-            except RuntimeError:
-                assert self._executor._shutdown  # pragma: no cover
+            except RuntimeError:  # pragma: no cover
+                pass  # shutdown
 
     def _reset_variables(self) -> None:
         """Reset variables define after connection."""

From 6976f984978fe9ae3dcef236c7090712f69ff218 Mon Sep 17 00:00:00 2001
From: mscheltienne <mathieu.scheltienne@fcbg.ch>
Date: Thu, 30 May 2024 13:30:56 +0200
Subject: [PATCH 05/12] fix missed

---
 examples/10_peak_detection.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/examples/10_peak_detection.py b/examples/10_peak_detection.py
index 4b0e5da1f..9f0d5fed4 100644
--- a/examples/10_peak_detection.py
+++ b/examples/10_peak_detection.py
@@ -305,6 +305,7 @@ def detect_peaks(self) -> NDArray[np.float64]:
         if self._last_acq_time is None:
             self._last_acq_time = ts[-1]
         elif self._last_acq_time == ts[-1]:
+            self._last_acq_time = ts[-1]
             return np.array([])  # nothing new to do
         data = data.squeeze()
         peaks, _ = find_peaks(

From 49cccb61b521ab5e5653d2b8214006a219c2b8d4 Mon Sep 17 00:00:00 2001
From: mscheltienne <mathieu.scheltienne@fcbg.ch>
Date: Thu, 30 May 2024 13:54:55 +0200
Subject: [PATCH 06/12] try composite action to install liblsl

---
 .github/actions/install-liblsl/action.yaml | 33 ++++++++++++++++++++++
 .github/workflows/pytest.yaml              | 26 ++---------------
 2 files changed, 35 insertions(+), 24 deletions(-)
 create mode 100644 .github/actions/install-liblsl/action.yaml

diff --git a/.github/actions/install-liblsl/action.yaml b/.github/actions/install-liblsl/action.yaml
new file mode 100644
index 000000000..796f799e7
--- /dev/null
+++ b/.github/actions/install-liblsl/action.yaml
@@ -0,0 +1,33 @@
+name: "Install liblsl"
+description: "A composite action to install liblsl on different operating systems."
+
+runs:
+  using: "composite"
+  steps:
+    - name: Install liblsl (linux)
+      if: ${{ runner.os == 'Linux' }}
+      shell: bash
+      run: |
+        curl -L https://github.com/sccn/liblsl/releases/download/v1.16.2/liblsl-1.16.2-jammy_amd64.deb -o liblsl-1.16.2-jammy_amd64.deb
+        sudo apt update
+        sudo apt install -y binutils libpugixml-dev qtbase5-dev qt5-qmake
+        sudo apt install -y ./liblsl-1.16.2-jammy_amd64.deb
+        rm liblsl-1.16.2-jammy_amd64.deb
+    - name: Install liblsl (macOS)
+      if: ${{ runner.os == 'macOS' }}
+      shell: bash
+      run: |
+        curl -L https://github.com/sccn/liblsl/releases/download/v1.16.0/liblsl-1.16.0-OSX_arm64.tar.bz2 -o liblsl-1.16.0-OSX_arm64.tar.bz2
+        tar -xf liblsl-1.16.0-OSX_arm64.tar.bz2
+        mv lib/liblsl.1.16.0.dylib .
+        echo "MNE_LSL_LIB=$PWD/liblsl.1.16.0.dylib" >> $GITHUB_ENV
+        rm -R lib include bin
+        rm liblsl-1.16.0-OSX_arm64.tar.bz2
+    - name: Install liblsl (windows)
+      if: ${{ runner.os == 'Windows' }}
+      shell: bash
+      run: |
+        curl -L https://github.com/sccn/liblsl/releases/download/v1.16.2/liblsl-1.16.2-Win_amd64.zip -o liblsl-1.16.2-Win_amd64.zip
+        7z x -oliblsl liblsl-1.16.2-Win_amd64.zip
+        echo "MNE_LSL_LIB=$PWD/liblsl/bin/lsl.dll" >> $GITHUB_ENV
+        rm liblsl-1.16.2-Win_amd64.zip
diff --git a/.github/workflows/pytest.yaml b/.github/workflows/pytest.yaml
index 9fe6f7bf3..feabf860e 100644
--- a/.github/workflows/pytest.yaml
+++ b/.github/workflows/pytest.yaml
@@ -28,30 +28,8 @@ jobs:
         uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
-      - name: Install liblsl (linux)
-        if: ${{ matrix.os == 'ubuntu' }}
-        run: |
-          curl -L https://github.com/sccn/liblsl/releases/download/v1.16.2/liblsl-1.16.2-jammy_amd64.deb -o liblsl-1.16.2-jammy_amd64.deb
-          sudo apt update
-          sudo apt install -y binutils libpugixml-dev qtbase5-dev qt5-qmake
-          sudo apt install -y ./liblsl-1.16.2-jammy_amd64.deb
-          rm liblsl-1.16.2-jammy_amd64.deb
-      - name: Install liblsl (macOS)
-        if: ${{ matrix.os == 'macos' }}
-        run: |
-          curl -L https://github.com/sccn/liblsl/releases/download/v1.16.0/liblsl-1.16.0-OSX_arm64.tar.bz2 -o liblsl-1.16.0-OSX_arm64.tar.bz2
-          tar -xf liblsl-1.16.0-OSX_arm64.tar.bz2
-          mv lib/liblsl.1.16.0.dylib .
-          echo "MNE_LSL_LIB=$PWD/liblsl.1.16.0.dylib" >> $GITHUB_ENV
-          rm -R lib include bin
-          rm liblsl-1.16.0-OSX_arm64.tar.bz2
-      - name: Install liblsl (windows)
-        if: ${{ matrix.os == 'windows' }}
-        run: |
-          curl -L https://github.com/sccn/liblsl/releases/download/v1.16.2/liblsl-1.16.2-Win_amd64.zip -o liblsl-1.16.2-Win_amd64.zip
-          7z x -oliblsl liblsl-1.16.2-Win_amd64.zip
-          echo "MNE_LSL_LIB=$PWD/liblsl/bin/lsl.dll" >> $GITHUB_ENV
-          rm liblsl-1.16.2-Win_amd64.zip
+      - name: Install liblsl
+        uses: ./.github/actions/install-liblsl
       - name: Install dependencies
         run: |
           python -m pip install --progress-bar off --upgrade pip setuptools

From 142e4f45cc32a708a558a9a4ba8c762198d8b489 Mon Sep 17 00:00:00 2001
From: mscheltienne <mathieu.scheltienne@fcbg.ch>
Date: Thu, 30 May 2024 14:00:54 +0200
Subject: [PATCH 07/12] use action everywhere

---
 .../action.yaml                               |  0
 .github/workflows/doc.yaml                    |  9 ++-----
 .github/workflows/publish.yaml                | 11 +++-----
 .github/workflows/pytest.yaml                 | 27 +++++++------------
 .github/workflows/stubs.yaml                  |  9 ++-----
 5 files changed, 16 insertions(+), 40 deletions(-)
 rename .github/actions/{install-liblsl => install-system-dependencies}/action.yaml (100%)

diff --git a/.github/actions/install-liblsl/action.yaml b/.github/actions/install-system-dependencies/action.yaml
similarity index 100%
rename from .github/actions/install-liblsl/action.yaml
rename to .github/actions/install-system-dependencies/action.yaml
diff --git a/.github/workflows/doc.yaml b/.github/workflows/doc.yaml
index d8542c15d..20acd498b 100644
--- a/.github/workflows/doc.yaml
+++ b/.github/workflows/doc.yaml
@@ -22,13 +22,8 @@ jobs:
         uses: actions/setup-python@v5
         with:
           python-version: 3.11
-      - name: Install linux dependencies
-        run: |
-          curl -L https://github.com/sccn/liblsl/releases/download/v1.16.2/liblsl-1.16.2-jammy_amd64.deb -o liblsl-1.16.2-jammy_amd64.deb
-          sudo apt update
-          sudo apt install -y libpugixml-dev qtbase5-dev qt5-qmake optipng
-          sudo apt install -y ./liblsl-1.16.2-jammy_amd64.deb
-          rm liblsl-1.16.2-jammy_amd64.deb
+      - name: Install system dependencies
+        uses: ./.github/actions/install-system-dependencies
       - name: Install package
         run: |
           python -m pip install --progress-bar off --upgrade pip setuptools
diff --git a/.github/workflows/publish.yaml b/.github/workflows/publish.yaml
index 9a3865571..2f265cccc 100644
--- a/.github/workflows/publish.yaml
+++ b/.github/workflows/publish.yaml
@@ -15,14 +15,9 @@ jobs:
         uses: actions/setup-python@v5
         with:
           python-version: 3.11
-      - name: Install linux dependencies
-        run: |
-          curl -L https://github.com/sccn/liblsl/releases/download/v1.16.2/liblsl-1.16.2-jammy_amd64.deb -o liblsl-1.16.2-jammy_amd64.deb
-          sudo apt update
-          sudo apt install -y libpugixml-dev qtbase5-dev qt5-qmake optipng
-          sudo apt install -y ./liblsl-1.16.2-jammy_amd64.deb
-          rm liblsl-1.16.2-jammy_amd64.deb
-      - name: Install dependencies
+      - name: Install system dependencies
+        uses: ./.github/actions/install-system-dependencies
+      - name: Install package
         run: |
           python -m pip install --progress-bar off --upgrade pip setuptools
           python -m pip install --progress-bar off -e .[build,stubs]
diff --git a/.github/workflows/pytest.yaml b/.github/workflows/pytest.yaml
index feabf860e..41f76b0b5 100644
--- a/.github/workflows/pytest.yaml
+++ b/.github/workflows/pytest.yaml
@@ -28,9 +28,9 @@ jobs:
         uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
-      - name: Install liblsl
-        uses: ./.github/actions/install-liblsl
-      - name: Install dependencies
+      - name: Install system dependencies
+        uses: ./.github/actions/install-system-dependencies
+      - name: Install package
         run: |
           python -m pip install --progress-bar off --upgrade pip setuptools
           python -m pip install --progress-bar off .[test]
@@ -68,13 +68,9 @@ jobs:
         uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
-      - name: Install liblsl & linux dependencies
-        run: |
-          curl -L https://github.com/sccn/liblsl/releases/download/v1.16.2/liblsl-1.16.2-jammy_amd64.deb -o liblsl-1.16.2-jammy_amd64.deb
-          sudo apt update
-          sudo apt install -y binutils libpugixml-dev qtbase5-dev qt5-qmake
-          sudo apt install -y ./liblsl-1.16.2-jammy_amd64.deb
-      - name: Install dependencies
+      - name: Install system dependencies
+        uses: ./.github/actions/install-system-dependencies
+      - name: Install package
         run: |
           python -m pip install --progress-bar off --upgrade pip setuptools
           python -m pip install --progress-bar off .[test]
@@ -117,14 +113,9 @@ jobs:
         uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
-      - name: Install liblsl (linux)
-        run: |
-          curl -L https://github.com/sccn/liblsl/releases/download/v1.16.2/liblsl-1.16.2-jammy_amd64.deb -o liblsl-1.16.2-jammy_amd64.deb
-          sudo apt update
-          sudo apt install -y binutils libpugixml-dev qtbase5-dev qt5-qmake
-          sudo apt install -y ./liblsl-1.16.2-jammy_amd64.deb
-          rm liblsl-1.16.2-jammy_amd64.deb
-      - name: Install dependencies
+      - name: Install system dependencies
+        uses: ./.github/actions/install-system-dependencies
+      - name: Install package
         run: |
           python -m pip install --progress-bar off --upgrade pip setuptools
           python -m pip install --progress-bar off .[test]
diff --git a/.github/workflows/stubs.yaml b/.github/workflows/stubs.yaml
index 07e48a621..18105fc96 100644
--- a/.github/workflows/stubs.yaml
+++ b/.github/workflows/stubs.yaml
@@ -22,13 +22,8 @@ jobs:
         uses: actions/setup-python@v5
         with:
           python-version: 3.11
-      - name: Install linux dependencies
-        run: |
-          curl -L https://github.com/sccn/liblsl/releases/download/v1.16.2/liblsl-1.16.2-jammy_amd64.deb -o liblsl-1.16.2-jammy_amd64.deb
-          sudo apt update
-          sudo apt install -y libpugixml-dev qtbase5-dev qt5-qmake
-          sudo apt install -y ./liblsl-1.16.2-jammy_amd64.deb
-          rm liblsl-1.16.2-jammy_amd64.deb
+      - name: Install system dependencies
+        uses: ./.github/actions/install-system-dependencies
       - name: Install package
         run: |
           python -m pip install --progress-bar off --upgrade pip setuptools

From e089c5719ff2d36fc0f8b152c96268803a190898 Mon Sep 17 00:00:00 2001
From: mscheltienne <mathieu.scheltienne@fcbg.ch>
Date: Thu, 30 May 2024 14:08:34 +0200
Subject: [PATCH 08/12] add dataset caching

---
 .../actions/get-testing-dataset/action.yaml   | 23 +++++++++++++++++++
 .../install-system-dependencies/action.yaml   | 12 ++++++----
 .github/workflows/pytest.yaml                 |  6 +++++
 mne_lsl/datasets/testing.py                   |  2 +-
 4 files changed, 38 insertions(+), 5 deletions(-)
 create mode 100644 .github/actions/get-testing-dataset/action.yaml

diff --git a/.github/actions/get-testing-dataset/action.yaml b/.github/actions/get-testing-dataset/action.yaml
new file mode 100644
index 000000000..6f7b0a65e
--- /dev/null
+++ b/.github/actions/get-testing-dataset/action.yaml
@@ -0,0 +1,23 @@
+name: "Get MNE-LSL testing dataset"
+description: "A composite action to get MNE-LSL testing dataset from cache or remote."
+
+runs:
+  using: "composite"
+  steps:
+    - name: Get testing dataset version
+      shell: bash
+      run: |
+          curl https://raw.githubusercontent.com/mscheltienne/mne-lsl-datasets/main/version.txt -o mne_lsl_testing_data_version.txt
+    - name: Cache testing dataset
+      id: cache
+      uses: actions/cache@v4
+      with:
+        key: mne-lsl-testing-${{ runner.os }}-${{ hashFiles('mne_testing_data_version.txt') }}
+        path: ~/mne_data/MNE-LSL-data
+    - name: Download testing dataset
+      if: steps.cache.outputs.cache-hit != 'true'
+      shell: bash
+      run: python -c "import mne_lsl; mne_lsl.datasets.testing.data_path()"
+    - name: Remove dataset version file
+      shell: bash
+      run: rm mne_lsl_testing_data_version.txt
diff --git a/.github/actions/install-system-dependencies/action.yaml b/.github/actions/install-system-dependencies/action.yaml
index 796f799e7..edb569ec5 100644
--- a/.github/actions/install-system-dependencies/action.yaml
+++ b/.github/actions/install-system-dependencies/action.yaml
@@ -1,16 +1,20 @@
-name: "Install liblsl"
-description: "A composite action to install liblsl on different operating systems."
+name: "Install system dependencies"
+description: "A composite action to install liblsl and system dependencies on different operating systems."
 
 runs:
   using: "composite"
   steps:
-    - name: Install liblsl (linux)
+    - name: Install linux dependencies
       if: ${{ runner.os == 'Linux' }}
       shell: bash
       run: |
-        curl -L https://github.com/sccn/liblsl/releases/download/v1.16.2/liblsl-1.16.2-jammy_amd64.deb -o liblsl-1.16.2-jammy_amd64.deb
         sudo apt update
         sudo apt install -y binutils libpugixml-dev qtbase5-dev qt5-qmake
+    - name: Install liblsl (linux)
+      if: ${{ runner.os == 'Linux' }}
+      shell: bash
+      run: |
+        curl -L https://github.com/sccn/liblsl/releases/download/v1.16.2/liblsl-1.16.2-jammy_amd64.deb -o liblsl-1.16.2-jammy_amd64.deb
         sudo apt install -y ./liblsl-1.16.2-jammy_amd64.deb
         rm liblsl-1.16.2-jammy_amd64.deb
     - name: Install liblsl (macOS)
diff --git a/.github/workflows/pytest.yaml b/.github/workflows/pytest.yaml
index 41f76b0b5..1d19ce688 100644
--- a/.github/workflows/pytest.yaml
+++ b/.github/workflows/pytest.yaml
@@ -36,6 +36,8 @@ jobs:
           python -m pip install --progress-bar off .[test]
       - name: Display system information
         run: mne_lsl-sys_info --developer
+      - name: Get testing dataset
+        uses: ./.github/actions/get-testing-dataset
       - name: Run pytest
         run: pytest mne_lsl --cov=mne_lsl --cov-report=xml --cov-config=pyproject.toml -s
         env:
@@ -80,6 +82,8 @@ jobs:
           python -m pip install --progress-bar off --upgrade --pre --only-binary :all: -i https://pypi.anaconda.org/scientific-python-nightly-wheels/simple --timeout=180 numpy scipy
       - name: Display system information
         run: mne_lsl-sys_info --developer
+      - name: Get testing dataset
+        uses: ./.github/actions/get-testing-dataset
       - name: Run pytest
         run: pytest mne_lsl --cov=mne_lsl --cov-report=xml --cov-config=pyproject.toml -s
         env:
@@ -123,6 +127,8 @@ jobs:
           python -m pip install --progress-bar off mne==${{ matrix.mne-version }}
       - name: Display system information
         run: mne_lsl-sys_info --developer
+      - name: Get testing dataset
+        uses: ./.github/actions/get-testing-dataset
       - name: Run pytest
         run: pytest mne_lsl --cov=mne_lsl --cov-report=xml --cov-config=pyproject.toml -s
         env:
diff --git a/mne_lsl/datasets/testing.py b/mne_lsl/datasets/testing.py
index f245f026b..28f031bf0 100644
--- a/mne_lsl/datasets/testing.py
+++ b/mne_lsl/datasets/testing.py
@@ -44,7 +44,7 @@ def data_path() -> Path:
     path = (
         Path(get_config("MNE_DATA", Path.home())).expanduser()
         / "mne_data"
-        / "MNE-LSL"
+        / "MNE-LSL-data"
         / "testing"
     )
     base_url = "https://github.com/mscheltienne/mne-lsl-datasets/raw/main/testing"

From 32f8b868c3e3c4b0c0b33e5d613670eaed495481 Mon Sep 17 00:00:00 2001
From: mscheltienne <mathieu.scheltienne@fcbg.ch>
Date: Thu, 30 May 2024 14:09:03 +0200
Subject: [PATCH 09/12] fix var name

---
 .github/actions/get-testing-dataset/action.yaml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/actions/get-testing-dataset/action.yaml b/.github/actions/get-testing-dataset/action.yaml
index 6f7b0a65e..f4220e0e7 100644
--- a/.github/actions/get-testing-dataset/action.yaml
+++ b/.github/actions/get-testing-dataset/action.yaml
@@ -7,12 +7,12 @@ runs:
     - name: Get testing dataset version
       shell: bash
       run: |
-          curl https://raw.githubusercontent.com/mscheltienne/mne-lsl-datasets/main/version.txt -o mne_lsl_testing_data_version.txt
+          curl https://raw.githubusercontent.com/mscheltienne/mne-lsl-datasets/main/version.txt -o mne_lsl_dataset_version.txt
     - name: Cache testing dataset
       id: cache
       uses: actions/cache@v4
       with:
-        key: mne-lsl-testing-${{ runner.os }}-${{ hashFiles('mne_testing_data_version.txt') }}
+        key: mne-lsl-testing-${{ runner.os }}-${{ hashFiles('mne_lsl_dataset_version.txt') }}
         path: ~/mne_data/MNE-LSL-data
     - name: Download testing dataset
       if: steps.cache.outputs.cache-hit != 'true'
@@ -20,4 +20,4 @@ runs:
       run: python -c "import mne_lsl; mne_lsl.datasets.testing.data_path()"
     - name: Remove dataset version file
       shell: bash
-      run: rm mne_lsl_testing_data_version.txt
+      run: rm mne_lsl_dataset_version.txt

From ca2dc01c6af57043f03c9f55cf3c8203553f3b1c Mon Sep 17 00:00:00 2001
From: mscheltienne <mathieu.scheltienne@fcbg.ch>
Date: Thu, 30 May 2024 14:48:32 +0200
Subject: [PATCH 10/12] add action for both dataset download

---
 .../actions/get-testing-dataset/action.yaml   | 29 ++++++++++++++++---
 .github/workflows/doc.yaml                    | 11 +++----
 2 files changed, 31 insertions(+), 9 deletions(-)

diff --git a/.github/actions/get-testing-dataset/action.yaml b/.github/actions/get-testing-dataset/action.yaml
index f4220e0e7..523239a02 100644
--- a/.github/actions/get-testing-dataset/action.yaml
+++ b/.github/actions/get-testing-dataset/action.yaml
@@ -1,23 +1,44 @@
 name: "Get MNE-LSL testing dataset"
 description: "A composite action to get MNE-LSL testing dataset from cache or remote."
+inputs:
+  sample:
+    description: "If True, retrieve the sample dataset."
+    required: false
+    default: "false"
+  testing:
+    description: "If True, retrieve the testing dataset."
+    required: false
+    default: "true"
 
 runs:
   using: "composite"
   steps:
-    - name: Get testing dataset version
+    - name: Get dataset version file
       shell: bash
       run: |
           curl https://raw.githubusercontent.com/mscheltienne/mne-lsl-datasets/main/version.txt -o mne_lsl_dataset_version.txt
     - name: Cache testing dataset
-      id: cache
+      if: ${{ inputs.testing == 'true' }}
+      id: cache_testing
       uses: actions/cache@v4
       with:
         key: mne-lsl-testing-${{ runner.os }}-${{ hashFiles('mne_lsl_dataset_version.txt') }}
-        path: ~/mne_data/MNE-LSL-data
+        path: ~/mne_data/MNE-LSL-data/testing
     - name: Download testing dataset
-      if: steps.cache.outputs.cache-hit != 'true'
+      if: ${{ inputs.testing == 'true' && steps.cache_testing.outputs.cache-hit != 'true' }}
       shell: bash
       run: python -c "import mne_lsl; mne_lsl.datasets.testing.data_path()"
+    - name: Cache sample dataset
+      if: ${{ inputs.sample == 'true' }}
+      id: cache_sample
+      uses: actions/cache@v4
+      with:
+        key: mne-lsl-sample-${{ runner.os }}-${{ hashFiles('mne_lsl_dataset_version.txt') }}
+        path: ~/mne_data/MNE-LSL-data/sample
+    - name: Download sample dataset
+      if: ${{ inputs.sample == 'true' && steps.cache_sample.outputs.cache-hit != 'true' }}
+      shell: bash
+      run: python -c "import mne_lsl; mne_lsl.datasets.sample.data_path()"
     - name: Remove dataset version file
       shell: bash
       run: rm mne_lsl_dataset_version.txt
diff --git a/.github/workflows/doc.yaml b/.github/workflows/doc.yaml
index 20acd498b..c23b552ee 100644
--- a/.github/workflows/doc.yaml
+++ b/.github/workflows/doc.yaml
@@ -30,12 +30,13 @@ jobs:
           python -m pip install --progress-bar off .[doc]
       - name: Display system information
         run: mne_lsl-sys_info --developer
-      - name: Build doc
-        uses: nick-fields/retry@v3
+      - name: Get testing dataset
+        uses: ./.github/actions/get-testing-dataset
         with:
-          timeout_minutes: 10
-          max_attempts: 3
-          command: make -C doc html
+          sample: "true"
+          testing: "false"
+      - name: Build doc
+        run: make -C doc html
       - name: Prune sphinx environment
         run: rm -R ./doc/_build/html/.doctrees
       - name: Upload documentation

From 81553e2b7b527af392247363b44f6b467d07ae7e Mon Sep 17 00:00:00 2001
From: mscheltienne <mathieu.scheltienne@fcbg.ch>
Date: Thu, 30 May 2024 14:52:20 +0200
Subject: [PATCH 11/12] install optipng

---
 .github/workflows/doc.yaml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.github/workflows/doc.yaml b/.github/workflows/doc.yaml
index c23b552ee..e80aa349f 100644
--- a/.github/workflows/doc.yaml
+++ b/.github/workflows/doc.yaml
@@ -24,6 +24,8 @@ jobs:
           python-version: 3.11
       - name: Install system dependencies
         uses: ./.github/actions/install-system-dependencies
+      - name: Install optipng (for sphinx-gallery)
+        run: sudo apt install optipng
       - name: Install package
         run: |
           python -m pip install --progress-bar off --upgrade pip setuptools

From d6876638c5859c68cd460b69fe7d1a054556b878 Mon Sep 17 00:00:00 2001
From: mscheltienne <mathieu.scheltienne@fcbg.ch>
Date: Thu, 30 May 2024 14:56:49 +0200
Subject: [PATCH 12/12] fix step name

---
 .github/workflows/doc.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/doc.yaml b/.github/workflows/doc.yaml
index e80aa349f..909362fe7 100644
--- a/.github/workflows/doc.yaml
+++ b/.github/workflows/doc.yaml
@@ -32,7 +32,7 @@ jobs:
           python -m pip install --progress-bar off .[doc]
       - name: Display system information
         run: mne_lsl-sys_info --developer
-      - name: Get testing dataset
+      - name: Get dataset
         uses: ./.github/actions/get-testing-dataset
         with:
           sample: "true"