Skip to content

Releases

mef3io-studio v0.1.5

Choose a tag to compare

@github-actions github-actions released this 07 Nov 06:37
644cd38

This is 0.1.5, after 0.1.4: Join or trim checks much faster on big recordings and network drives, you always choose the channels (the ones you looked at in the viewer come ticked), and it uses mef3io 2.3.0, which fixes a case where a join with a time window could miss data (see below).

Please redo some joins made with 0.1.4

If you made a recording with Join or trim in Studio 0.1.4 and chose a time
window (keep only a part) for a recording whose saved segment times were
wrong, the new recording may be missing data.
Some recordings carry wrong
start or end times in their file headers (for example after a clock problem);
0.1.4 could then drop that recording's chosen part without saying so. The
library behind Studio (mef3io 2.3.0) fixes this, and 0.1.5 uses it. Please
make those recordings again with 0.1.5 and compare their length with what you
expect. Joins without a time window, and recordings with correct times, were
not affected. The originals were never changed.

Installers for Windows, macOS (14 or later) and Linux are attached below,
with the user manual (PDF) and the tutorial videos. Check your download
against the SHA256SUMS file.

These builds are not code-signed yet. Your computer will ask you to
confirm the first start:

  • Windows: "Windows protected your PC" → More info → Run anyway.
  • Mac: open the app once and close the warning, then go to System
    Settings → Privacy & Security
    and click Open Anyway next to the message
    about mef3io-studio. (On macOS 14: right-click the app → Open.) If
    macOS says the app "is damaged and can't be opened", the download was
    quarantined: move the app to Applications, run
    xattr -dr com.apple.quarantine /Applications/mef3io-studio.app in
    Terminal, then open it again.
  • Linux: make the AppImage executable (Properties → Allow executing),
    then double-click it.

Fixed

  • Studio now uses mef3io 2.3.0 (it was 2.2.0): the fix above, and fewer file requests when a short part of many
    recordings is copied, which matters most on network drives.

  • "Checking everything before starting" in Join or trim does less work
    on big recordings.
    Studio no longer opens every recording again or walks
    through all of its folders (that took tens of thousands of file requests).
    It uses what Explore already knows about each recording (when it starts and
    ends, its channels and its size), and touches each recording at most once
    per action: it looks at a few files only to see whether the recording has
    changed since Explore read it, which includes a recording that has grown
    while the page was open. If it has changed, the page says so, checks again
    and uses the new times. The library's own check and copy still read the
    recording (once in the check, once in the run); how much work they do is
    improved in the library's own release, not here. No time saving is promised.

  • Sending a range from the signal viewer to Join or trim now keeps your
    channel choice.
    Join or trim stops at the Channels step, with the
    channels you could see in the viewer kept and the ones you hid left out, so
    you can see and change which channels go into the new recording. If you
    hid every channel, none is ticked yet and the step says so.

Changed

  • Join or trim tells you about channels with different units or amplitude
    settings.
    After saving, the result says "Some channels have different units
    in different recordings" (the whole channel is labelled with the units of its
    first part, and nothing was rescaled) and "Some channels were recorded with
    different amplitude settings in different recordings" (the values are right
    in Studio, but some older programs, for example the mef_tools Python package,
    show those channels as all zeros), naming the channels. Mixed units no longer stop
    the join.

  • Choosing a few channels is easier to find. The channel step now says
    that a ticked box means "kept" and explains how to keep only a few: choose
    Exclude all, then tick the channels you want.

mef3io-studio v0.1.4

Choose a tag to compare

@github-actions github-actions released this 05 Nov 06:52
d4e32a7

This is 0.1.4, after
0.1.3: Join or
trim makes one new recording straight from the originals in one go (channels
left out, trimmed, anonymous if you like, with or without notes, as one file if
you like), the part to keep can be chosen on the map, and a user manual with
tutorial videos comes with the release.

Installers for Windows, macOS (14 or later) and Linux are attached below,
with the user manual (PDF) and the tutorial videos. Check your download
against the SHA256SUMS file.

These builds are not code-signed yet. Your computer will ask you to
confirm the first start:

  • Windows: "Windows protected your PC" → More info → Run anyway.
  • Mac: open the app once and close the warning, then go to System
    Settings → Privacy & Security
    and click Open Anyway next to the message
    about mef3io-studio. (On macOS 14: right-click the app → Open.) If
    macOS says the app "is damaged and can't be opened", the download was
    quarantined: move the app to Applications, run
    xattr -dr com.apple.quarantine /Applications/mef3io-studio.app in
    Terminal, then open it again.
  • Linux: make the AppImage executable (Properties → Allow executing),
    then double-click it.

New

  • A user manual (PDF) and captioned tutorial videos come with every
    release. They show joining and trimming, making a recording anonymous and
    saving it as one file, step by step, on made-up recordings; the app itself
    makes the pictures and the videos, so they match the screens you see.

  • Choose what to keep on a map. In Join or trim, the What to keep step
    now shows the same map as Explore's combined timeline (when each recording
    has data, with zoom and moving along it) with two lines, Start and
    End, that you drag with the mouse or move with the keyboard (S or E to
    pick a line, then the arrow keys). Below it, Start and End each have a
    date and time (UTC, to the microsecond) and a time as a number
    (microseconds since 1 January 1970, UTC)
    ; the lines and both fields
    always show the same moment, and a time that cannot be read says so and
    moves nothing. The window applies to every chosen recording: each keeps only
    its data inside it, and a recording with no data there is greyed on the map
    and left out, with a note. This is the default when you choose several
    recordings; Choose for each recording is still there (the map then shows
    what each keeps as shaded parts). The times are the real times of the
    recordings, and the step says so when you make the new recording anonymous
    with moved dates.

  • Join or trim can make the new recording anonymous, and save it as one
    file, in a single go.
    A new step, Privacy, comes after What to
    keep
    : keep the patient details (as before), or Make it anonymous,
    with the Anonymize page's own choices for one recording: keep the real
    dates or move every date by the same number of whole days, a pseudonym,
    what to clear, and whether to remove or keep the text of notes and events.
    The New recording step has a new Save as choice: a folder
    (.mefd), or one file (.mefd.tar), which this app opens directly.
    An anonymous recording is made straight from the originals, trimmed and
    without the channels you left out: a copy with the patient's details is
    never written to your computer, and no second trip through the Anonymize
    page is needed.

  • Free space is checked before anything is written for the busiest moment
    of the chosen steps, and the message says how much room is needed.

  • One progress bar for all the steps, each named in plain words (keeping
    the chosen part of each recording, joining, packing, checking the file).
    Stop works at every step and leaves nothing behind.

  • Join or trim: notes and events, keep or leave out. The Privacy
    step has a new choice, Notes and events: Keep them / Leave them out
    (Keep is the default). Leaving them out removes every note and event from
    the new recording, with its time, at every level; the signal, times and
    channels are as without it. It works for any new recording, anonymous or
    not (for an anonymous one that keeps them, the choice to remove or keep
    their text still applies). The result screen says when they were left out.

  • Join or trim makes the new recording in one pass. On mef3io 2.2.0 the
    kept part of each recording, the channels left out, making it anonymous, the
    notes choice and the new passwords all happen in one pass over the data,
    straight from the originals: no temporary copy of any part is written
    any more (so the hidden folder is only used to pack one file), the
    originals are read once to make the new recording and once to check it, and
    far fewer files are opened, which helps most on a network drive. Free
    space needed is now the size of the new recording (twice that for one
    file). Stop still leaves nothing behind. A recording with notes that was
    cut and joined to another no longer fails its own check.

Changed

  • The app now needs mef3io 2.2.0 (it was 2.1.1).

  • Join or trim has one more step (Privacy), so "New recording" is now step 5.

  • The small preview of kept parts under the list on What to keep is replaced
    by the map.

mef3io-studio v0.1.3

Choose a tag to compare

@github-actions github-actions released this 04 Nov 03:54
c178629

This is 0.1.3, a fix release after
0.1.2: the
signal viewer no longer leaves a page empty after a brief read error.

Installers for Windows, macOS (14 or later) and Linux are attached below.
Check your download against the SHA256SUMS file.

These builds are not code-signed yet. Your computer will ask you to
confirm the first start:

  • Windows: "Windows protected your PC" → More info → Run anyway.
  • Mac: open the app once and close the warning, then go to System
    Settings → Privacy & Security
    and click Open Anyway next to the message
    about mef3io-studio. (On macOS 14: right-click the app → Open.) If
    macOS says the app "is damaged and can't be opened", the download was
    quarantined: move the app to Applications, run
    xattr -dr com.apple.quarantine /Applications/mef3io-studio.app in
    Terminal, then open it again.
  • Linux: make the AppImage executable (Properties → Allow executing),
    then double-click it.

Fixed

  • The signal viewer no longer leaves a page empty after a brief read
    error.
    If part of a recording could not be read for a moment (for
    example a network or USB drive that dropped out and came back), the next
    page could stay empty until you moved again. It is now read again; only
    an error that lasts is reported.

mef3io-studio v0.1.2

Choose a tag to compare

@github-actions github-actions released this 04 Nov 00:04
ab67728

This is 0.1.2, a fix release after
0.1.1: the
signal viewer is fast again.

Installers for Windows, macOS (14 or later) and Linux are attached below.
Check your download against the SHA256SUMS file.

These builds are not code-signed yet. Your computer will ask you to
confirm the first start:

  • Windows: "Windows protected your PC" → More info → Run anyway.
  • Mac: open the app once and close the warning, then go to System
    Settings → Privacy & Security
    and click Open Anyway next to the message
    about mef3io-studio. (On macOS 14: right-click the app → Open.) If
    macOS says the app "is damaged and can't be opened", the download was
    quarantined: move the app to Applications, run
    xattr -dr com.apple.quarantine /Applications/mef3io-studio.app in
    Terminal, then open it again.
  • Linux: make the AppImage executable (Properties → Allow executing),
    then double-click it.

Fixed

  • The signal viewer is fast again. Paging, scrolling, changing the
    size of the signals or the montage took 2 to 4 seconds with many
    channels, and the window froze meanwhile. Each step now takes about a
    tenth of a second, and the first page appears in about half a second
    (measured with 64 channels). Traces may look slightly finer on standard
    screens; on high-resolution screens they look as before.
  • On screens scaled to 125% or 175%, moving the pointer over the signals no
    longer redraws them each time.

mef3io-studio v0.1.1

Choose a tag to compare

@github-actions github-actions released this 03 Nov 07:20
14cf36a

This is 0.1.1, a small release after
0.1.0, the first
full release. It adds one feature: cutting a recording into pieces.

Installers for Windows, macOS (14 or later) and Linux are attached below.
Check your download against the SHA256SUMS file.

These builds are not code-signed yet. Your computer will ask you to
confirm the first start:

  • Windows: "Windows protected your PC" → More info → Run anyway.
  • Mac: open the app once and close the warning, then go to System
    Settings → Privacy & Security
    and click Open Anyway next to the message
    about mef3io-studio. (On macOS 14: right-click the app → Open.) If
    macOS says the app "is damaged and can't be opened", the download was
    quarantined: move the app to Applications, run
    xattr -dr com.apple.quarantine /Applications/mef3io-studio.app in
    Terminal, then open it again.
  • Linux: make the AppImage executable (Properties → Allow executing),
    then double-click it.

What's new since 0.1.0

Cut into pieces. Make several new recordings from one, for example one
per day. Open it from the Explore list's right-click menu (Cut into
pieces…
) or the File menu.

  • Cut every few hours or days, optionally from midnight in the time zone
    the app shows, so "1 day" gives one piece per calendar day (23 or 25 hours
    on the days the clocks change), or at times you type.
  • A list shows every piece before anything is made: start, end, length and
    an estimated size. Pieces that would hold no signal (a gap in the
    recording) are left out, and the window says which.
  • Names come from a pattern with <name>, <number> and <date>. The
    suggested pattern starts with the recording's name, which can hold the
    patient's name: leave it out if it does.
  • New copies can get passwords, as everywhere else in the app.
  • Each piece is a new, checked copy; the original is never changed.
    Pieces fit together exactly: no sample is lost or repeated at a cut.
    Stop leaves nothing half-made, and a batch interrupted by a crash can
    be continued.

Known limitations

  • Not code-signed (see above).
  • Cut marks are typed, not dragged on the time line, and every piece
    keeps all channels (to leave channels out, use Make new recordings
    afterwards).
  • The other limits of 0.1.0 still apply (no changes in place except renaming
    and adding notes, rename undo only until the app closes, passwords only on
    new copies, copies made one after another); see the
    0.1.0 notes.

Reporting a problem

Open an issue on GitHub.
Issues are public, so:

  • Never attach a recording, a screenshot that shows patient details, or
    real names, dates or folder names. Describe what you did and what you saw
    instead.
  • Say which version you use (Help → About mef3io-studio; on a Mac, in
    the mef3io-studio menu) and on which computer (Windows, Mac or Linux).
  • If the app itself does not seem to work, Help → Check this
    installation
    tests it with a small made-up recording; tell us what it
    says.
  • The app's log (Help → Open the log folder) leaves out patient details,
    names, folder paths and dates. Still, read it before you attach it.

If you find that an anonymized copy still contains patient details or a real
date, please do not open a public issue. Report it privately instead:
report a privacy problem.

mef3io-studio v0.1.0

Choose a tag to compare

@github-actions github-actions released this 03 Nov 04:15
b2af45e

This is 0.1.0, the first full release of mef3io-studio. It is no
longer a test version: it is the latest release on the
Releases page, and it
is still an early version, so we would like to hear what is unclear or does
not work. It builds on
0.1.0.dev6.

Installers for Windows, macOS (14 or later) and Linux are attached below.
Check your download against the SHA256SUMS file.

These builds are not code-signed yet. Your computer will ask you to
confirm the first start:

  • Windows: "Windows protected your PC" → More info → Run anyway.
  • Mac: open the app once and close the warning, then go to System
    Settings → Privacy & Security
    and click Open Anyway next to the message
    about mef3io-studio. (On macOS 14: right-click the app → Open.) If
    macOS says the app "is damaged and can't be opened", the download was
    quarantined: move the app to Applications, run
    xattr -dr com.apple.quarantine /Applications/mef3io-studio.app in
    Terminal, then open it again.
  • Linux: make the AppImage executable (Properties → Allow executing),
    then double-click it.

What the app does

  • Explore recordings without loading any signal: channels, times, gaps,
    notes, history, a check for problems, several recordings on one time line,
    a table of times (CSV), and a Privacy check.
  • Anonymize recordings into new, checked copies, one or many, also as
    unattended batches that can be continued after a crash.
  • Join or trim: keep part of a recording, or join parts of several into
    one new recording.
  • View signals of one or several recordings as one, with montages,
    filters, notes and events, and an optional edit mode to add notes.
  • Rename recordings safely, edit details into a new copy, give new
    copies passwords, and make new recordings from many at once.
  • Pack a recording into one file, or unpack it.

The originals are never changed, except when you rename them or, in edit
mode, add notes after you confirm. Nothing leaves your computer.

What's new since 0.1.0.dev6

  • Rename recordings safely, in time order. The Rename window lists
    the selected recordings by when they were recorded, builds names from a
    pattern (or lets you type them), checks every name before anything
    happens (too long, not allowed, already taken, two recordings with the
    same name), and renames the folder, the notes of the whole recording and
    the names kept inside the files together. Each recording is renamed on its
    own; if one cannot be, the others go on. Undo the last rename puts the
    old names back.
  • Edit details (makes a new copy). Change the patient's name and ID, the
    place, the recording description and the channel descriptions. The result
    is a new recording that the app checks against the original; the original
    stays as it is. Dates and times cannot be changed, and a text that is too
    long is refused, never cut.
  • Password choices on every new copy. Anonymize, Join or trim and Edit
    details all offer the same choice: no password, or two new ones. The
    originals' passwords are never carried over, and passwords are never
    stored.
  • Saved channel choices and one "Make new recordings" batch. Save a
    choice of channels under a name, share it as a small file, and apply it to
    many recordings at once, together with details and new passwords. It runs
    as an unattended batch with progress, Stop, and a way to continue after a
    crash.
  • Built on mef3io 2.1.1.

Known limitations

  • Not code-signed (see above).
  • No changes in place. Details and channels are changed only by making a
    new copy. Changing or removing a note that is already stored is not
    possible yet; edit mode only adds notes.
  • Cutting one recording into several pieces is not available yet.
    Keeping a part and joining parts of several recordings is (Join or trim).
  • Undo of a rename lasts until the app is closed. After that, rename the
    recordings back by hand.
  • Passwords are chosen only for new copies. Adding or removing the
    password of an existing recording is not possible.
  • Copies are made one after another, not several at once.
  • The limits of the earlier versions that still apply (joining and trimming
    rules, one choice for all note text when anonymizing, one archive for a
    whole batch, no saved anonymization report, very short names when
    continuing a batch) are listed in the
    0.1.0.dev6 notes
    and explained in the
    user guide.

What to try

Please use copies of recordings you are allowed to work with, or test
recordings without patient data. Rename a few of them and undo it, make a
copy with changed details, and make new recordings from several at once.
Tell us which words or steps were confusing: that is as useful to us as
a bug. Settings (File → Settings) and About (Help → About
mef3io-studio
) are in the mef3io-studio menu on a Mac.

Reporting a problem

Open an issue on GitHub.
Issues are public, so:

  • Never attach a recording, a screenshot that shows patient details, or
    real names, dates or folder names. Describe what you did and what you saw
    instead.
  • Say which version you use (Help → About mef3io-studio; on a Mac, in
    the mef3io-studio menu) and on which computer (Windows, Mac or Linux).
  • If the app itself does not seem to work, Help → Check this
    installation
    tests it with a small made-up recording; tell us what it
    says.
  • The app's log (Help → Open the log folder) leaves out patient details,
    names, folder paths and dates. Still, read it before you attach it.

If you find that an anonymized copy still contains patient details or a real
date, please do not open a public issue. Report it privately instead:
report a privacy problem.

mef3io-studio v0.1.0.dev6

Pre-release

Choose a tag to compare

@github-actions github-actions released this 31 Oct 19:41
ad7f873

This is a test version for students and researchers who work with MEF 3.0
recordings. It is not the finished app: some features are still missing, and
we would like to hear what is unclear or does not work. It adds a way to
look at the signals of your recordings, on top of
0.1.0.dev5;
0.1.0.dev2
has the full list of what the app can do.

Installers for Windows, macOS (14 or later) and Linux are attached below.
Check your download against the SHA256SUMS file.

These builds are not code-signed yet. Your computer will ask you to
confirm the first start:

  • Windows: "Windows protected your PC" → More info → Run anyway.
  • Mac: open the app once and close the warning, then go to System
    Settings → Privacy & Security
    and click Open Anyway next to the message
    about mef3io-studio. (On macOS 14: right-click the app → Open.) If
    macOS says the app "is damaged and can't be opened", the download was
    quarantined: move the app to Applications, run
    xattr -dr com.apple.quarantine /Applications/mef3io-studio.app in
    Terminal, then open it again.
  • Linux: make the AppImage executable (Properties → Allow executing),
    then double-click it.

What's new since 0.1.0.dev5

A signal viewer. Look at the traces of one recording, or of several at
once, without changing anything. In Explore, select recordings and
choose View signals (the button under the list, or the right-click
menu). On the Join or trim page, View these recordings opens the same
window.

  • Several recordings as one. They are shown on one shared time line.
    A thin band above the traces shows which recording holds data at each
    moment, with a letter and a colour for each; stretches with no data are
    hatched. Where one recording ends and the next begins there is a clear
    line, and a short message ("Now showing recording B") appears over the
    traces. The keys { and } jump to the previous and next such line.
  • Montages. As recorded, Referenced to a channel (you choose the
    channel every other channel is shown against), and Lead bipolar.
  • Filters for slow drift and fast activity, and a mains filter (50 or
    60 Hz, with its harmonics if you wish). Each cutoff can be typed, moved
    with a slider, or set from a short list of usual values, and the traces
    follow as you move it. Show response… draws what the filters keep:
    as a share of the signal, in decibels, and (for filters that shift
    waves in time) the time shift. A line of plain words under it says what
    the filters do.
  • Moving around. Keys for a page, half a page or one second forward
    and back, the start and the end, and the mouse wheel, dragging and
    zooming. Jump (Ctrl+K) takes a time of day, a day and time, a date, a
    move such as +10m, or a recording letter. Press ? in the viewer for
    the full list of keys. On a Mac, two keys differ: more or less space
    between rows is Alt+Up and Alt+Down (Ctrl+Up and Ctrl+Down are used by
    the system).
  • Clinical scales: sensitivity in µV/mm, timebase in mm/s, space
    between rows in mm, and a choice of colours.
  • Notes and events are shown on the traces, in a list you can search,
    and by type; [ and ] step from one to the next.
  • Export range. Mark a start and an end on the traces (keys S and
    E, or by dragging the edges), copy the times, keep a list of ranges and
    save it as CSV or JSON, or send the range straight to Join or trim.
  • Privacy follows Explore. Patient details and the text of notes stay
    hidden until you show them for that recording, in Explore or with the
    Show button in the viewer, and hiding them in Explore hides them in
    the viewer too.
  • Fast on big recordings. Only what is on the screen, and a few pages
    ahead, is read. File → Settings has a Signal viewer section: how
    many things are loaded and filtered at once, how many pages are loaded
    ahead, and how much memory the viewer may use. The three settings for
    loading and filtering and the memory setting are "Automatic" unless you
    change them; pages loaded ahead starts at 2 (0 to 8). Changes apply to
    viewer windows opened afterwards.

Edit mode (optional, off by default). The Edit mode button in the
viewer lets you add notes and events. It is off every time you open the
viewer, and a banner reminds you that your changes are a draft.

  • Add a note or event at the pointer (key A, the Add… button, or the
    right-click menu), or use the keys 1 to 9 for the quick types (Note,
    Seizure onset, Seizure end, Spike, Artifact, Sleep). Key 1 (Note) opens
    the form, because a plain note needs words; the other types are added at
    once, without text. A note can last
    until a later time and can belong to the whole recording or to one
    channel.
  • Undo and redo (Ctrl+Z, Ctrl+Shift+Z), and Discard the draft.
  • Import notes and events from a CSV or JSON file and export them
    to one (the file holds real dates and the text of notes, so the app
    reminds you to store it with care).
  • Save… first shows what will be added to each recording. Nothing is
    written before you agree. Notes are only added to the recording: what
    is already stored is never rewritten. For a password-protected recording
    the app asks for both passwords, the one it already holds and the other.
    If a note falls where two recordings both hold data, you choose which
    recording gets it.
  • Recordings packed in a single-file recording (.mefd.tar) cannot get new notes;
    unpack them first.

Built on mef3io 2.1.1 (it was 1.5.1 in 0.1.0.dev5).

Good to know: times are shown in UTC until you choose the time zone
of the place where the recordings were made (View → Time zone…). The
viewer opens the recordings you selected; it never changes them unless you
use edit mode and save.

What to try

Please use copies of recordings you are allowed to work with, or test
recordings without patient data.

  1. In Explore, select a recording and choose View signals. Move through
    it with the keys and the mouse. Is it clear what is on the screen?
  2. Select two or three recordings from one patient and open them together.
    Can you tell where one ends and the next begins, and which is which?
  3. Try the three montages and move the filter cutoffs. Does Show
    response…
    match what you see in the traces?
  4. Turn on Edit mode on a copy of a recording, add a note or two, then
    Save…. Do you find the new notes in Explore afterwards?
  5. Tell us which words or steps were confusing. That is as useful to us
    as a bug.

The user guide
explains every step. Settings (File → Settings) and About (Help →
About mef3io-studio
) are in the mef3io-studio menu on a Mac.

Known limitations

  • Not code-signed (see above).
  • Edit mode only adds. You can change or take out a note in the draft,
    but changing or removing a note that is already stored in a recording
    is not possible yet: it will need a new copy of the recording, which comes
    in a later version. Such changes stay in the draft and cannot be saved.
  • The quick types for the keys 1 to 9 are fixed lists of words for now;
    there is no screen to change them yet.
  • Not in this version yet: cutting one recording into several pieces,
    sorting and renaming recordings, viewing and editing their details,
    adding or removing password protection on an existing recording, and
    saving a choice of channels to reuse.
  • Recordings that cannot share one time line are refused when you open
    them together, with the reason in plain words. Open them one by one
    instead.
  • Join or trim: two kept parts that run at the same time must not share
    a channel you keep (leave the shared channels out to join them); the
    recordings must be of the same patient and have the same sampling rate per
    channel. A recording opened only with its basic password cannot be used
    here: open it in Explore with the full-access password.
  • Notes of a recording protected with a full-access password are not
    shown in the viewer unless you opened the recording in Explore with that
    password.
  • One choice for all note text when anonymizing: the text of notes is
    either removed from every copy or kept in every copy. Choosing per note is
    not possible yet.
  • Copies are made one after another, not several at once.
  • One archive for the whole batch cannot be opened in the app directly.
    Extract it first with any archive tool (7-Zip, the one built into Windows
    or macOS, or tar); you then get the recordings back as usual.
  • There is no saved report of an anonymization yet, apart from the list
    of original and new dates (saved only if you ask).
  • Left-out channel names inside longer words: if kept note text holds the
    name of a channel you left out glued into a longer word (for example "a3a3"
    when channel a3 is left out), the app refuses the copy before starting.
    Removing the note text avoids it.
  • Continuing a batch with very short names: when you kept note text or
    descriptions and the patient's name or ID, or the name of a channel you
    left out, has a part only one or two letters long (for example the O in
    O'Brien, or a channel called E), Make them
    again
    may treat another copy of the same recording, with the same name
    and dates but with that text removed, as its own and make it again. Your
    batch's own copies are never affected, and this matters only if such a
    copy appeared at the destination while the batch was stopped
    (#39).

Reporting a problem

Open an issue on [GitHub](https://github.com/bnelair/mef3io-studio/issues/new/...

Read more

mef3io-studio v0.1.0.dev5

Pre-release

Choose a tag to compare

@github-actions github-actions released this 21 Oct 21:04
0ef4824

This is a test version for students and researchers who work with MEF 3.0
recordings. It is not the finished app: some features are still missing, and
we would like to hear what is unclear or does not work. It adds a new page to
0.1.0.dev4;
0.1.0.dev2
has the full list of what the app can do.

Installers for Windows, macOS (14 or later) and Linux are attached below.
Check your download against the SHA256SUMS file.

These builds are not code-signed yet. Your computer will ask you to
confirm the first start:

  • Windows: "Windows protected your PC" → More info → Run anyway.
  • Mac: open the app once and close the warning, then go to System
    Settings → Privacy & Security
    and click Open Anyway next to the message
    about mef3io-studio. (On macOS 14: right-click the app → Open.) If
    macOS says the app "is damaged and can't be opened", the download was
    quarantined: move the app to Applications, run
    xattr -dr com.apple.quarantine /Applications/mef3io-studio.app in
    Terminal, then open it again.
  • Linux: make the AppImage executable (Properties → Allow executing),
    then double-click it.

What's new since 0.1.0.dev4

A new page: Join or trim. It makes one new recording from parts of
others; the originals are never changed.

  • Trim: keep only part of one recording, for example its first two
    hours, its last 30 minutes, or everything between two times.
  • Join: keep a part of each of several recordings and put them together,
    one after another or side by side: for example the last hour of one
    recording and the first hour of the next, or two recordings of the same
    hour made with different channels. Three or more work the same way, each
    trimmed at the start, the end or both.
  • From Explore: select recordings in the Explore list and choose Join
    or trim these…
    (a button under the list, or the right-click menu).
  • A preview shows every recording on one timeline with the part you
    keep, so gaps and parts running at the same time are easy to see. Parts
    that would clash are shown in red, with the reason.
  • Leave out channels, give the new recording a name, and protect it with new
    passwords if you want. Check and save checks everything before
    anything is written, then makes the new recording with one progress bar
    and a Stop button, and checks it against the originals before it
    gets its name.
  • "The last hour" is exactly the last hour of signal, whichever program made
    the recording.

Good to know: as before, times are shown in UTC until you choose the
time zone of the place where the recordings were made (View → Time
zone…
). Joining never moves anything in time.

What to try

Please use copies of recordings you are allowed to work with, or test
recordings without patient data.

  1. Trim a recording: keep its last 10 minutes, then open the new
    recording in Explore. Does it hold what you expected?
  2. Join the last hour of one recording with the first hour of the next.
    Is the gap between them where you expected it on the timeline?
  3. Try three recordings, trimming the first at its start and the last at its
    end, and try starting from a selection in Explore.
  4. Tell us which words or steps were confusing. That is as useful to us
    as a bug.

The user guide
explains every step. Settings (File → Settings) and About (Help →
About mef3io-studio
) are in the mef3io-studio menu on a Mac.

Known limitations

  • Not code-signed (see above).
  • Not in this version yet: cutting one recording into several pieces,
    sorting and renaming recordings, viewing and editing their details,
    adding or removing password protection on an existing recording, and
    saving a choice of channels to reuse. A signal viewer comes later.
  • Join or trim: two kept parts that run at the same time must not share
    a channel you keep (leave the shared channels out to join them); the
    recordings must be of the same patient and have the same sampling rate per
    channel. A recording opened only with its basic password cannot be used
    here: open it in Explore with the full-access password. The user guide has
    no picture of this page yet.
  • One choice for all note text: the text of notes is either removed from
    every copy or kept in every copy. Choosing per note is not possible yet.
  • Copies are made one after another, not several at once.
  • One archive for the whole batch cannot be opened in the app directly.
    Extract it first with any archive tool (7-Zip, the one built into Windows
    or macOS, or tar); you then get the recordings back as usual.
  • There is no saved report of an anonymization yet, apart from the list
    of original and new dates (saved only if you ask).
  • Left-out channel names inside longer words: if kept note text holds the
    name of a channel you left out glued into a longer word (for example "a3a3"
    when channel a3 is left out), the app refuses the copy before starting.
    Removing the note text avoids it.
  • Continuing a batch with very short names: when you kept note text or
    descriptions and the patient's name or ID, or the name of a channel you
    left out, has a part only one or two letters long (for example the O in
    O'Brien, or a channel called E), Make them
    again
    may treat another copy of the same recording, with the same name
    and dates but with that text removed, as its own and make it again. Your
    batch's own copies are never affected, and this matters only if such a
    copy appeared at the destination while the batch was stopped
    (#39).

Reporting a problem

Open an issue on GitHub.
Issues are public, so:

  • Never attach a recording, a screenshot that shows patient details, or
    real names, dates or folder names. Describe what you did and what you saw
    instead.
  • Say which version you use (Help → About mef3io-studio; on a Mac, in
    the mef3io-studio menu) and on which computer (Windows, Mac or Linux).
  • If the app itself does not seem to work, Help → Check this
    installation
    tests it with a small made-up recording; tell us what it
    says.
  • The app's log (Help → Open the log folder) leaves out patient details,
    names, folder paths and dates. Still, read it before you attach it.

If you find that an anonymized copy still contains patient details or a real
date, please do not open a public issue. Report it privately instead:
report a privacy problem.

mef3io-studio v0.1.0.dev4

Pre-release

Choose a tag to compare

@github-actions github-actions released this 21 Oct 02:17
2abbd86

This is a test version for students and researchers who work with MEF 3.0
recordings. It is not the finished app: some features are still missing, and
we would like to hear what is unclear or does not work. It is a small update
of 0.1.0.dev3;
0.1.0.dev2
has the full list of what the app can do.

Installers for Windows, macOS (14 or later) and Linux are attached below.
Check your download against the SHA256SUMS file.

These builds are not code-signed yet. Your computer will ask you to
confirm the first start:

  • Windows: "Windows protected your PC" → More info → Run anyway.
  • Mac: open the app once and close the warning, then go to System
    Settings → Privacy & Security
    and click Open Anyway next to the message
    about mef3io-studio. (On macOS 14: right-click the app → Open.) If
    macOS says the app "is damaged and can't be opened", the download was
    quarantined: move the app to Applications, run
    xattr -dr com.apple.quarantine /Applications/mef3io-studio.app in
    Terminal, then open it again.
  • Linux: make the AppImage executable (Properties → Allow executing),
    then double-click it.

What's new since 0.1.0.dev3

Kept note text is cleaned more reliably. When you keep the text of notes
and events, a patient's name is now also taken out when a note spells it
without its accents (for example "Muller" for "Müller"). In 0.1.0.dev3 such a
copy failed its check at the very end and was removed. Text the app still
cannot clean safely, such as the name of a channel you left out written
inside a longer word, is now found before anything is written, and the
app says so: go back and choose Remove the text, and tick the
descriptions to be cleared.

A recording that is in the middle of being renamed by another program
(for example after a computer stopped during a rename) is refused with a
plain explanation, instead of being copied half-renamed.

The History tab shows two new entries when another program did them: a
recording "renamed", or "copied with changes".

Under the hood, the app now runs on mef3io 1.5.1.

Good to know: as before, times are shown in UTC until you choose the
time zone of the place where the recordings were made (View → Time
zone…
), and anonymizing never changes your original recordings: it makes
a new copy and checks it.

What to try

Please use copies of recordings you are allowed to work with, or test
recordings without patient data.

  1. Anonymize a recording and keep the text of notes: does the copy go
    through, and is every name gone from the notes?
  2. Anything from the 0.1.0.dev2 list:
    exploring recordings, the combined timeline, anonymizing a batch.
  3. Tell us which words or steps were confusing. That is as useful to us
    as a bug.

The user guide
explains every step. Settings (File → Settings) and About (Help →
About mef3io-studio
) are in the mef3io-studio menu on a Mac.

Known limitations

  • Not code-signed (see above).
  • Not in this version yet: keeping only part of a recording, merging
    recordings, sorting and renaming recordings, viewing and editing their
    details, adding or removing password protection, and saving a choice of
    channels to reuse. A signal viewer comes later.
  • One choice for all note text: the text of notes is either removed from
    every copy or kept in every copy. Choosing per note is not possible yet.
  • Copies are made one after another, not several at once.
  • One archive for the whole batch cannot be opened in the app directly.
    Extract it first with any archive tool (7-Zip, the one built into Windows
    or macOS, or tar); you then get the recordings back as usual.
  • There is no saved report of an anonymization yet, apart from the list
    of original and new dates (saved only if you ask).
  • Left-out channel names inside longer words: if kept note text holds the
    name of a channel you left out glued into a longer word (for example "a3a3"
    when channel a3 is left out), the app refuses the copy before starting.
    Removing the note text avoids it.
  • Continuing a batch with very short names: when you kept note text or
    descriptions and the patient's name or ID, or the name of a channel you
    left out, has a part only one or two letters long (for example the O in
    O'Brien, or a channel called E), Make them
    again
    may treat another copy of the same recording, with the same name
    and dates but with that text removed, as its own and make it again. Your
    batch's own copies are never affected, and this matters only if such a
    copy appeared at the destination while the batch was stopped
    (#39).

Reporting a problem

Open an issue on GitHub.
Issues are public, so:

  • Never attach a recording, a screenshot that shows patient details, or
    real names, dates or folder names. Describe what you did and what you saw
    instead.
  • Say which version you use (Help → About mef3io-studio; on a Mac, in
    the mef3io-studio menu) and on which computer (Windows, Mac or Linux).
  • If the app itself does not seem to work, Help → Check this
    installation
    tests it with a small made-up recording; tell us what it
    says.
  • The app's log (Help → Open the log folder) leaves out patient details,
    names, folder paths and dates. Still, read it before you attach it.

If you find that an anonymized copy still contains patient details or a real
date, please do not open a public issue. Report it privately instead:
report a privacy problem.

mef3io-studio v0.1.0.dev3

Pre-release

Choose a tag to compare

@github-actions github-actions released this 17 Oct 20:27
0547581

This is a test version for students and researchers who work with MEF 3.0
recordings. It is not the finished app: some features are still missing, and
we would like to hear what is unclear or does not work. It is a small update
of 0.1.0.dev2,
which has the full list of what the app can do.

Installers for Windows, macOS (14 or later) and Linux are attached below.
Check your download against the SHA256SUMS file.

These builds are not code-signed yet. Your computer will ask you to
confirm the first start:

  • Windows: "Windows protected your PC" → More info → Run anyway.
  • Mac: open the app once and close the warning, then go to System
    Settings → Privacy & Security
    and click Open Anyway next to the message
    about mef3io-studio. (On macOS 14: right-click the app → Open.) If
    macOS says the app "is damaged and can't be opened", the download was
    quarantined: move the app to Applications, run
    xattr -dr com.apple.quarantine /Applications/mef3io-studio.app in
    Terminal, then open it again.
  • Linux: make the AppImage executable (Properties → Allow executing),
    then double-click it.

What's new since 0.1.0.dev2

Option buttons, tick boxes and every field you type in or choose from
are now clearly outlined
, in the light and in the dark look, also when they are not chosen or cannot be used at
the moment. In the dark look, unchosen option buttons were hard to see
before.

Continuing a batch is more careful about what it removes. When you
continue an interrupted batch and choose Make them again, the app
removes an existing result only if it can tell that this batch made it. It
now also checks that the patient details, descriptions and note text were
removed or kept the way this batch asked. Anything else with that name is
left alone, and the app says so.

Good to know: as before, times are shown in UTC until you choose the
time zone of the place where the recordings were made (View → Time
zone…
), and anonymizing never changes your original recordings: it makes
a new copy and checks it.

What to try

Please use copies of recordings you are allowed to work with, or test
recordings without patient data.

  1. Switch to the dark look (View → Appearance → Dark) and go through the
    Anonymize steps. Can you see every button, tick box and field clearly?
  2. Anything from the 0.1.0.dev2 list:
    exploring recordings, the combined timeline, anonymizing a batch.
  3. Tell us which words or steps were confusing. That is as useful to us
    as a bug.

The user guide
explains every step. Settings (File → Settings) and About (Help →
About mef3io-studio
) are in the mef3io-studio menu on a Mac.

Known limitations

  • Not code-signed (see above).
  • Not in this version yet: sorting and renaming recordings, viewing and
    editing their details, adding or removing passwords on a recording, and
    saving a choice of channels to reuse. A signal viewer comes later.
  • One choice for all note text: the text of notes is either removed from
    every copy or kept in every copy. Choosing per note is not possible yet.
  • Copies are made one after another, not several at once.
  • One archive for the whole batch cannot be opened in the app directly.
    Extract it first with any archive tool (7-Zip, the one built into Windows
    or macOS, or tar); you then get the recordings back as usual.
  • There is no saved report of an anonymization yet, apart from the list
    of original and new dates (saved only if you ask).
  • Kept note text and similar spellings of a name: when you keep the text
    of notes, a copy can fail with "The copy did not pass its check" if a note
    spells a patient's name without its accents (for example "Muller" for
    "Müller"), or repeats the name of a channel you left out inside one word
    (for example "a3a3" when channel a3 is left out). Nothing leaks: that copy is removed and the others go ahead.
    Removing the note text avoids it
    (mef3io#115).
  • Continuing a batch with very short names: when you kept note text or
    descriptions and the patient's name or ID, or the name of a channel you
    left out, has a part only one or two letters long (for example the O in
    O'Brien, or a channel called E), Make them
    again
    may treat another copy of the same recording, with the same name
    and dates but with that text removed, as its own and make it again. Your
    batch's own copies are never affected, and this matters only if such a
    copy appeared at the destination while the batch was stopped
    (#39).

Reporting a problem

Open an issue on GitHub.
Issues are public, so:

  • Never attach a recording, a screenshot that shows patient details, or
    real names, dates or folder names. Describe what you did and what you saw
    instead.
  • Say which version you use (Help → About mef3io-studio; on a Mac, in
    the mef3io-studio menu) and on which computer (Windows, Mac or Linux).
  • If the app itself does not seem to work, Help → Check this
    installation
    tests it with a small made-up recording; tell us what it
    says.
  • The app's log (Help → Open the log folder) leaves out patient details,
    names, folder paths and dates. Still, read it before you attach it.

If you find that an anonymized copy still contains patient details or a real
date, please do not open a public issue. Report it privately instead:
report a privacy problem.