Repository navigation
mef3io-studio v0.1.0.dev4
Pre-releaseThis 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.