Repository navigation
Releases
mef3io-studio v0.1.5
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.appin
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
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.appin
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
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.appin
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
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.appin
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
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.appin
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
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.appin
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
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.appin
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
Sand
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 keys1to9for the quick types (Note,
Seizure onset, Seizure end, Spike, Artifact, Sleep). Key1(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.
- 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? - 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? - Try the three montages and move the filter cutoffs. Does Show
response… match what you see in the traces? - 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? - 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, ortar); 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/...
mef3io-studio v0.1.0.dev5
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.appin
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.
- Trim a recording: keep its last 10 minutes, then open the new
recording in Explore. Does it hold what you expected? - 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? - Try three recordings, trimming the first at its start and the last at its
end, and try starting from a selection in Explore. - 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, ortar); 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
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.appin
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.
- Anonymize a recording and keep the text of notes: does the copy go
through, and is every name gone from the notes? - Anything from the 0.1.0.dev2 list:
exploring recordings, the combined timeline, anonymizing a batch. - 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, ortar); 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
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.appin
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.
- Switch to the dark look (View → Appearance → Dark) and go through the
Anonymize steps. Can you see every button, tick box and field clearly? - Anything from the 0.1.0.dev2 list:
exploring recordings, the combined timeline, anonymizing a batch. - 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, ortar); 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.