Repository navigation
mef3io-studio v0.1.0.dev5
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 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.