Repository navigation
mef3io-studio v0.1.0.dev2
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.
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.dev1
A new Anonymize page. It makes anonymized copies of your recordings: the
patient details are removed and every date and time is moved by the same
amount. Your original recordings are never changed. The app makes a new
copy, checks it, and only then keeps it. A step-by-step guide takes you
through it, and nothing is saved until the last step.
- Choose the channels to keep. Even with 256 channels this is quick:
channels are grouped by electrode, and there is a filter, Shift+click for
a range, and Undo. - Move the dates. You choose a new date for one recording, and the
others follow it, so they keep their order and spacing. Or every copy can
start at the same moment. - Name the copies and give each one a pseudonym (a code for the
patient). The app checks that no name contains the patient's details. - Remove or keep the text of notes. It is removed by default. If you
keep it, read it yourself before sharing: dates and names written in free
text are not found automatically. - Add two new passwords to the copies, or none (the usual choice for
sharing). - Save the copies as folders, as one file per recording, or as one
archive for the whole batch to send to someone. - See the original and new dates of every recording at the end. Anyone
with this list can undo the anonymization, so the app saves it to a file
only if you ask.
Long batches can run on their own. Start a batch of many recordings and
walk away. One problem does not stop the batch, the computer is kept awake
(you can turn this off in File → Settings; on a Mac, Settings is in the
mef3io-studio menu), and a notification tells you when it is done. If the app
crashes or the computer loses power, the next start offers to continue the
batch. A batch into one archive can also be continued after you stop it or
close the app, once at least one recording is in it. In Settings you can also choose the work folder where
each copy is made and checked before it is packed.
A Privacy check in Explore. For any recording, original or copy, it shows
every kind of detail that could identify the patient, each marked as empty
or found, and whether the anonymizer made the recording.
Several recordings on one timeline. Choose Combined timeline in
Explore to see recordings side by side, one row each. Time that two
recordings share is marked, and the time with data is added up.
Save times as a table. Save the start and end of your recordings as a
CSV file that opens in Excel or LibreOffice. Every time is written in a form
people can read and in forms that scripts read exactly.
Real progress and a working Stop. Opening and packing large recordings
now show how much is really done, and Stop task stops the work straight
away, even in the middle of a large 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…).
What to try
Please use copies of recordings you are allowed to work with, or test
recordings without patient data.
- Open or scan a folder of recordings on the Explore page. Look at the
details of one recording, then select several and choose Combined
timeline. - Save their times as a table and open it in your spreadsheet program.
Does it look right? - Anonymize two or three recordings into a new, empty folder. Leave out a
few channels, move the dates, and look at the result page. - Choose Open the copy and read its Privacy check. Does it say
clearly that nothing was found? - Try a batch into one archive and stop it halfway with Stop. Then
either choose Finish the archive with what is done, or close the app,
start it again and continue the batch when it asks. - Tell us which words or steps were confusing. That is as useful to us
as a bug.
The user guide
explains every step.
Known limitations
- Not code-signed (see above).
- Dark theme: buttons you choose one option from (radio buttons) are
barely visible when they are not selected
(#35). The light
theme (View → Appearance → Light) shows them clearly. - 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). - Continuing an interrupted batch: if a copy already exists at the
destination and you choose Make them again, the app checks that it made
that copy itself (its name, dates, channels and passwords), but not yet
whether the patient details and note text were treated the same way
(#36). This matters
only if another copy of the same recording, with the same name and dates,
appeared there while the batch was stopped.
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.