Manual

Getting started

man start · Requirements, first launch, connecting your M8 and choosing the backup folder

Requirements

• A Mac with Apple Silicon and macOS 14 or later.
• Your Dirtywave M8, connected via USB and switched to USB drive mode.
• That's it. M8Thor ships its own rsync and its own players for chip tunes, so you don't need to install anything else.

First launch

The very first time you open M8Thor, a short setup walks you through four steps: WELCOME, FOLDER, NOTIFICATIONS, CONNECT.

• FOLDER: here you see your backup folder with its free space and an INTERNAL DISK or EXTERNAL DRIVE badge. Want a different one? Pick it with CHOOSE FOLDER…. If you never choose one, your backups go to ~/Backups. A tip from me: an external drive keeps your backups safe even if your Mac fails.
• NOTIFICATIONS: ALLOW NOTIFICATIONS asks macOS for permission. If you said no at some point before, OPEN NOTIFICATION SETTINGS takes you straight to System Settings.
• CONNECT: connect your M8 via USB in USB drive mode, or put its SD card in a card reader. As soon as the card is mounted, the step shows M8 DETECTED · <NAME>. With NAME THIS CARD you give it a name of up to 24 characters, and that name shows up wherever the card does: Backup, Browse, HISTORY, the menu bar. SAVE keeps it, SKIP leaves the card without one. Don't worry, the card itself is not changed. This is also where you can turn on "Back up when connected" (auto-backup, see man backup).
• NEXT → (or Return) moves on, ← BACK goes back, SKIP SETUP ends the setup, and FINISH on the last step saves your choice. You'll only see the setup this once.
• Already had a backup folder set, or backups in it? Then M8Thor skips the setup for you.

The main window

• The title bar holds five tabs: BACKUP, RESTORE, BROWSE, REMOTE, SETTINGS (⌘1 to ⌘5). While the sample editor is open, EDITOR · <FILE> sits beside them and brings it forward.
• Keep an eye on the little dots. A dot on RESTORE means edits are staged and waiting to be applied. A dot on BACKUP means a connected card has changes or no backup yet.
• Only one copy of M8Thor runs at a time. If you open it again, the running copy simply comes to the front.

How the card is detected

• You don't have to do anything: M8Thor scans mounted volumes automatically whenever a volume mounts or unmounts. If you want to scan again yourself, press ⌘R or SCAN NOW.
• A volume counts as an M8 card if it has System/STARTUP.m8s, or both a Songs and an Instruments folder at its root.
• Got other gear too? With SETTINGS › Advanced › "Recognize other SD cards" on, SD cards and USB drives from other devices can be backed up as well (badge OTHER CARD). See man backup.

Backing up your card

man backup · Preview what changed, confirm, and get a verified, space-saving snapshot

The card view

Once your M8 card is mounted, the BACKUP tab tells you everything about it at a glance:

• its name (click the pencil to name the card, up to 24 characters; the volume name then shows below it) and a status badge such as CONNECTED • READY, CONNECTED • NO BACKUP YET or CONNECTED • 12 CHANGES FOUND,
• UUID, MOUNT, SIZE, FOLDER, CONTENTS (counts of songs, instruments, samples…), the NOTE of your latest backup, if you wrote one (notes are added in man restore), and FIRMWARE once M8Thor knows your M8 (man firmware),
• a sidebar with NEXT BACKUP, STATUS, SINCE LAST, ESTIMATE (FULL) (a rough time estimate), DESTINATION, KEEP, and RECENT (a size bar chart and your last five backups).
• STATUS compares the card with your latest backup by file size and date. When it lists changes, SHOW CHANGES opens a window with exactly the files that differ.
• More than one card connected? Then a row of cards sits on top, each with its name, an M8 or OTHER CARD badge and a status dot. M8 cards come first; click one to show it.
• A card with no backup and no name yet greets you with NEW CARD FOUND — NAME IT: type a name and SAVE, or LATER. The name shows wherever the card does: Backup, Browse, HISTORY, the menu bar. The banner never holds anything up; the countdown, a backup and EJECT carry on while it shows.

Run a backup

1. Press START BACKUP (first backup) or RUN BACKUP.
2. The confirmation shows Backup to <folder>/<set>? and a preview: N new, N modified, N deleted (expand it for a per-folder list), or "No changes detected".
3. Optional, once a previous backup exists: expand FOLDERS to pick what to back up (ALL / NONE). System and Themes are always included. Turn Songs off to pick single songs; samples used by those songs are included automatically. Folders you leave out keep their state from the previous backup, so every version stays complete.
4. Optional: CHANGE DESTINATION… writes this one backup as a standalone full copy to another folder, e.g. an external drive (badge FULL · EXTERNAL). USE DEFAULT undoes it. It is not a permanent setting.
5. Press CONFIRM. CANCEL goes back.

While it runs, you see BACKING UP, the elapsed time, N FILES LEFT, a progress bar and a log. "READING CARD…" just means rsync is checking files it does not need to copy. CANCEL stops the backup, and an unfinished backup is never published, so nothing half-done ends up in your history. Need your screen back? The button next to CANCEL (⇧⌘M) shrinks the window to a small progress strip, and EXPAND brings it back.

When it's done, you get "Backup successful (…)" with CLOSE and EJECT, or an error with RETRY, REPORT PROBLEM and EJECT.

What you get

• Each backup is a full snapshot. Unchanged files are hardlinked to the previous backup, so they take no extra disk space. Every version is complete, and your disk stays happy.
• When a previous backup exists, files are compared by checksum during the copy.
• "Verify with checksums" (off by default) compares the copied files once more after the backup.
• "Rotate old backups" (on by default) keeps the newest N snapshots per card (1–30, default 5) and deletes older ones. If the new backup holds far fewer files than the previous one, older backups are kept and you get a warning to check the card.
• "Eject on completion" unmounts the card after a successful backup.

You'll find these toggles under the card when it is idle; they are the same settings as in man settings.

Other SD cards

Your M8 isn't the only box with an SD card? Turn on SETTINGS › Advanced › "Recognize other SD cards" and back up SD cards and USB drives from other devices the same way: versions, rotation, checksums, Browse, Restore. A few things stay M8-only:

• no FOLDERS or single-song selection: an OTHER CARD is always backed up whole,
• no auto-backup when it is connected and no automatic eject (it may take its whole device along),
• in Browse, no song details, no USED IN and no UNUSED filter, and no staging of edited samples to it.

Auto-backup

If "Back up when connected" is on, connecting an M8 card while M8Thor runs starts a countdown ("Auto-backup starting in 5s…") with a CANCEL button, then backs up the whole card without the confirmation step. Plug in, lean back.

After a backup

• A sound plays and a notification ("Backup Complete" / "Backup Failed") appears, if you've enabled them.
• HISTORY opens the card's backup folder in Finder. EJECT (or ⌘E, Eject All) unmounts the M8 cards.

M8 firmware

man firmware · New firmware for your M8: M8Thor finds it, fetches it from Dirtywave and copies it to the card

No more hunting for the right firmware file: M8Thor can bring new Dirtywave firmware straight to your M8's card. The firmware is Dirtywave's, of course. M8Thor downloads it from Dirtywave's GitHub only after you accept Dirtywave's EULA, and never changes it.

How M8Thor knows your M8

• To offer you the right file, M8Thor needs your M8's model and firmware version. It asks the M8 when it is connected by USB in its normal mode (not in USB drive mode), and never while its card is in use. SETTINGS › Advanced › "Identify M8 when connected" takes care of this (default on); REMOTE learns it too when it connects (man remote).
• Once an M8 is known, M8Thor asks Dirtywave's GitHub (github.com/Dirtywave/M8Firmware) once a day for a new release. Nothing about you or your M8 is sent. If you'd rather not, SETTINGS › Updates › "Check for M8 firmware" turns this off (default on).
• The BACKUP card then shows FIRMWARE: what your M8 reports and the LATEST release, or LAST CHECK FAILED. GET there fetches a release that no banner offers, e.g. a new letter of the same version (DISMISS hides that one) or one you put off with NOT NOW.

Update from the card

1. Switch the M8 to USB drive mode. On its own card, the BACKUP tab shows FIRMWARE <VERSION> FOR MODEL:0N with GET FIRMWARE. NOT NOW hides the offer for this release.
2. GET FIRMWARE shows Dirtywave's EULA (DIRTYWAVE M8 FIRMWARE · EULA) the first time and whenever its text changes. ACCEPT downloads the firmware, DECLINE stops.
3. COPY TO CARD puts the file for your model in the card's root. If the card has changes that are not backed up yet, BACK UP FIRST runs a backup before. While a backup or restore holds the card, the copy waits.
4. Then follow the steps shown: save your project, EJECT CARD and exit USB-DRIVE on the M8, PROJECT > SYSTEM SETTINGS > FIRMWARE UPDATE, select the file and confirm. Do not remove the card. If it fails, update over USB.

Good to know

• An M8 older than 6.6.0 cannot update from the card. You'll see FIRMWARE <VERSION> NEEDS 6.6 OR NEWER ON THE M8, and USB INSTRUCTIONS opens Dirtywave's page for the USB update.
• NEW FIRMWARE FOUND — MODEL NOT VERIFIED means M8Thor doesn't know yet which M8 this card belongs to. Leave USB drive mode once so it can ask the M8 (or turn on "Identify M8 when connected").
• Nothing on your card is replaced. If another file with that name is there: ANOTHER <FILE> IS ON THE CARD — NOTHING WAS CHANGED. If it's the same file: <FILE> IS ALREADY ON THE CARD.
• With auto-eject on, a backup of this card leaves it mounted once, so the firmware can still be copied: BACKUP DONE — COPY FIRMWARE? THE CARD WAS NOT EJECTED FOR IT.
• Once your M8 runs the new firmware, M8Thor offers to tidy up and take the file off the card: REMOVE or KEEP. Later, REMOVE FILE in the FIRMWARE row does the same. Only files M8Thor put there are removed.

Restoring a backup

man restore · Five-step wizard to write any backup version back to an SD card

Getting your stuff back is easy, whether it's a whole card or just a few songs. The RESTORE tab guides you through five steps: TARGET, SET, VERSION, SELECTION, CONFIRM. Use NEXT → and ← BACK in the footer, or click an earlier step in the stepper to jump back.

01 Target

First, pick the card to write to. M8 cards are listed first, then blank FAT32 or exFAT cards (badge NO M8 FILES). The volume your backups live on is never offered, so you can't accidentally restore onto your own backups. Each card shows SIZE, FREE and FS. No card? Connect your M8 in USB drive mode or insert an SD card, then REFRESH.

02 Set

Next, pick a backup set (one per source card). Badges help you find the right one: MATCH (the set belongs to the selected card), BACKUP IN PROGRESS, N PENDING (staged edits, with an APPLY N button). A set with "NO COMPLETED BACKUP YET" cannot be selected.

03 Version

Now pick a snapshot. The newest is marked LATEST, and each shows its date, size and note. For every version you have a few handy buttons:

• Note button ("Add note" / "Edit note"): add, edit or delete a BACKUP NOTE. Future you will be grateful for a line like "before the big remix".
• Browse button ("Browse backup contents"): opens BROWSE BACKUP. Click files for details (song tempo, instruments, samples; play audio), reveal them in Finder, drag them out, or copy a file or folder to the selected card. Esc closes it.
• "Export as ZIP" button: exports the version as a .zip file with progress.
• COMPARE (two or more versions): choose VERSION A (BASE) and VERSION B (COMPARED) to list added, modified and deleted files.
• Trash button (next to the note, browse and ZIP buttons): moves the version to the Trash, see Moving a version to the Trash below.

04 Selection

• Full Backup: restores all folders and files of the version.
• Folders: toggle root folders (ALL / NONE). Turn a folder off and open its caret to pick subfolders or files. For Songs choose Full Folder or Single Songs. If Samples is not selected, samples used by the selected songs are included automatically, so your songs won't come back silent.

05 Confirm

One last look before anything is written: review SOURCE BACKUP, TARGET DEVICE, MODE, VERSION, SELECTION, SONGS, AUTO SAMPLES and NOTE.

• Only files OLDER than the backup are overwritten. Files that are newer on the card are not changed, and files that are not in the backup stay on the card. Nothing is deleted.
• PREVIEW lists the files that differ before you commit.
• ▶ START RESTORE runs it. RESTORING… shows a log and CANCEL.
• Result: RESTORE COMPLETE or RESTORE FAILED with the reason, and the files that were kept because the card's copy is newer. CLOSE or EJECT.

Safety

• One operation per card at a time: a restore cannot start while a backup runs on that card.
• The card is checked before and after the restore; if it was unplugged, you are told the target may be partially restored.
• Pending sample edits are applied from this tab too, see man stage.

Moving a version to the Trash

Running low on space? The trash button in 03 VERSION (or, in BROWSE, right-click a version in the sidebar › MOVE TO TRASH…) opens a sheet that tells you how much space the version frees:

• "Frees about <size> when you empty the Trash." Unchanged files are shared between versions through hardlinks, so a version often frees far less than its size. On drives without hardlinks, e.g. exFAT, it frees its full size.
• "Frees almost nothing — its files are shared with other backups."

"You can put it back from the Trash." MOVE TO TRASH moves it. When a version can't be moved, the button tells you why:

• THE LAST BACKUP OF A CARD IS ALWAYS KEPT
• THIS BACKUP IS IN USE — a restore, a ZIP export, SAVE A COPY… or an open sample editor reads it.
• THIS BACKUP HAS PENDING EDITS
• A BACKUP OR RESTORE IS RUNNING — also while a backup waits for CONFIRM or counts down.
• THIS VOLUME HAS NO TRASH — e.g. some network drives; nothing is deleted.

Rotation still deletes the oldest versions permanently, as before (man settings).

Browsing backups

man browse · Look inside any backup version or Mac folder: move with the keys, audition, search, see where samples are used

Layout

• Top left, SETS: your own collections of samples from any card and any Mac folder, see man sets.
• Under them, BACKUP SETS: one per card, each under its name. Open one and you see its versions (date and time, the newest marked LATEST). A set with staged edits shows a dot with the count and a PENDING (N) row (see man stage). Time to tidy up? Right-click a version › MOVE TO TRASH… moves it to the Trash (man restore).
• Under it, MAC FOLDERS: the folders on your Mac you added to browse, see man mac.
• In the middle, the file list (NAME, SIZE, MODIFIED), with a glyph and a kind tag for every file. Above it sits the path of the folder you are in; it folds to what fits. .. takes you up.
• On the right, a preview of the selected file.
• The pane that doesn't have the keys dims its selection, so you always know where your keys go.

Keys and the cursor

The list has one mark, the cursor. It is the selection, and the preview always shows the row it is on. The list scrolls along, so you never lose it.

• In BACKUP SETS: ↑ ↓ pick a version, Return or → take you into its files.
• In the list: ↑ ↓ move the cursor. → enters a folder, an archive (man archives) or a module (man chips); on a sample it opens the sample editor, just as EDIT does. ← leaves the folder; at the top of a version it takes you back to the versions.
• Return opens the row, as a click does. Space plays or stops the sample or chip tune under the cursor. Esc stops it and turns AUDITION off.
• A double-click opens an archive or a module, like →.
• F adds the file under the cursor to the TARGET set (man sets).
• Clicking a row gives it the cursor and the keys.

AUDITION and LOOP

• AUDITION is made for digging: while it is on, ↑ ↓ play every sample and chip tune they land on; on other rows the sound stops. Starting a sample from the list (its ▶ or Space) turns it on, and turning it off stops the sound.
• LOOP, next to AUDITION: every sample and tune you hear in Browse repeats until you stop it, and so does the next one. Switch it while something plays and it applies at once.
• Both stay as you set them for the whole session, across folders and versions.
• Opening the sample editor stops whatever Browse is playing.

Search

• Lost a sample somewhere? ⌘F focuses the search field (SEARCH THIS BACKUP, or SEARCH THIS FOLDER inside a folder; switch between THIS FOLDER and WHOLE BACKUP).
• The filter menu: ALL, SONGS, INSTRUMENTS, SAMPLES, THEMES, SCALES, BUNDLES, RENDERS, UNUSED, OTHER, HISTORY (another card's version: ALL, SAMPLES, OTHER, HISTORY). A filter works without a search term too, so you can simply list all your SONGS, say.
• UNUSED lists the samples that no song or saved instrument in this version uses. It waits until every song has been read (INDEXING REFERENCES…), so it never guesses.
• HISTORY lists every sample with a saved edit, from any card or Mac folder, newest first. Each row tells you where it is from (the card's name and the backup's day), and it plays, opens and stages right there. SEARCH HISTORY narrows it by name.
• Audio results show USED IN … or UNUSED, and a row's tooltip names the card and the backup it is from. Return on a hit jumps straight to it.
• Search does not look inside archives or modules.

Previews

• SONG (.m8s): BPM, INSTRUMENTS, SAMPLES, SIZE, MODIFIED and the song's sample list (✓ found, ✗ missing in this version). Play samples from the list, or click one to preview it (← BACK TO <SONG>). ↓ RESTORE TO <CARD> copies only the song file to the connected M8, overwriting a file with the same name; its samples are not copied.
• SAMPLE (wav, aif, aiff, mp3, flac, ogg, m4a, caf): waveform, ▶ PLAY, EDIT, FORMAT, SAMPLE RATE, BIT DEPTH, CHANNELS, DURATION (from one minute on as minutes and seconds, e.g. 37:38.84), SIZE, MODIFIED, and USED IN: the songs and instruments that use it. Click the waveform or EDIT to open the sample editor (man editor). An EDITED badge means the editor keeps saved settings for this sample; the file itself is unchanged. BACKUP AFFECTED SONGS copies the songs that use this sample into a new folder on your Desktop.
• MODULE, SID TUNE, TFMX TUNE: see man chips. ZIP ARCHIVE, LHA ARCHIVE, AMIGA DISK: see man archives.
• Other files: KIND, SIZE, MODIFIED.
• SAVE A COPY… saves any file anywhere outside your backup folder.

Browsing never changes a backup or a Mac folder, so look around as much as you like.

Chip tunes

man chips · Tracker modules, C64 SID and Amiga TFMX tunes: play them live, open their samples, render a stretch into the editor

What plays

• Tracker modules: every format libopenmpt reads — MOD, XM, S3M, IT, Future Composer, SoundFX, Soundtracker, ICE, 669, DigiBooster, Symphonie, OctaMED, Oktalyzer and more — also when they are packed with PowerPacker, XPK, MMCMP or UMX. Named song.fc or the Amiga way, fc.song: M8Thor knows both (mod.name is a module).
• C64 SID tunes (.sid, PSID and RSID).
• Amiga TFMX (Chris Hülsbeck) and Jochen Hippel tunes: mdat.<name> with its smpl.<name>, or .mdat/.smpl, .tfx/.sam, smpl.set, .hip, .hipc, .hip7, .mcmd, .sog, .soc, .s7g. PowerPacked files are unpacked into the cache for you.

Play live

• PLAY in the preview, a row's ▶ or Space plays the whole song live, right away. Press it again to stop. LOOP (man browse) repeats it.
• With AUDITION on, ↑ ↓ play every tune they land on. A lovely way to dig through a big collection.
• A SID tune's TUNE n/N and a TFMX tune's SONG n/N, in the preview column, pick what PLAY plays; pick a new one and it switches at once.
• The previews show MODULE: TYPE, CHANNELS, LENGTH, SAMPLES, SIZE · SID TUNE: RELEASED, TUNES, CHIP, FORMAT, SIZE · TFMX TUNE: FORMAT, SONGS, VOICES, LENGTH, SAMPLES, SIZE.

A module's samples

Here's a treat: a module opens like a folder (→, Return, a double-click or OPEN SAMPLES) and shows you its instrument samples as WAV files. They play, audition and open in the editor like any other sample. STAGE FOR CARD stages one as FROM MODULE, and ADD TO CARD adds them to the card (man mac). ← takes you back.

Settings and OPEN IN EDITOR

A module's, SID's or TFMX tune's preview column holds its settings. You hear every change at once while it plays, and OPEN IN EDITOR renders exactly what is set into the sample editor:

• PLAY / STOP, LOOP and a timeline with the chosen range and the playhead: a click jumps there, the range's edges drag START and its end, and a drag inside moves the whole range.
• START and LENGTH knobs (LENGTH is 30 s until you set it, 5 minutes at most), WHOLE for the whole song; a module's CHANNELS, a SID or TFMX tune's VOICES, a SID tune's CHIP (AS TUNE, 6581, 8580). Channels and voices you switch off are silent. The wheel scrolls the column; ⌥ + wheel turns the knob under the pointer.
• Mutes, START and LENGTH are heard at once; a new SID chip or subtune and far jumps take a short SEEKING… first.
• What you hear is what gets rendered: OPEN IN EDITOR (RENDERING… while it works) writes it — modules and TFMX as 44.1 kHz stereo, SID as 44.1 kHz mono — and opens it in the editor. If another sample is open there, M8Thor asks first (man editor).
• The render is staged for the M8 as 44.1 kHz · 16-bit, with the badge FROM MODULE, FROM SID or FROM TFMX. From an old demo tune to a fresh sample, ready for your card, in a few clicks.

Archives and Amiga disks

man archives · ZIP and LHA/LZH archives and Amiga disk images (ADF, ADZ, DMS) open like a folder

Opening

• Found an old sample pack or an Amiga disk from back in the day? ZIP archives (.zip), LHA archives (.lha, .lzh) and Amiga disk images (.adf, gzip'ed .adz and DMS, .dms) open like a folder: →, Return, a double-click or OPEN in the preview. ← leaves. The preview calls them ZIP ARCHIVE, LHA ARCHIVE or AMIGA DISK.
• They are unpacked once into M8Thor's cache (~/Library/Caches/M8Thor/Archives, up to 2 GB, oldest removed first). The archive itself is only read; nothing is written next to it. LHA and DMS files are unpacked by a separate helper process, so a broken file can only fail that one unpack.
• Inside, modules, SID tunes and WAVs play, audition and open (a module's samples too), OPEN IN EDITOR works, and EDIT stages a sample as FROM ZIP, FROM LHA, FROM ADF (an ADZ counts as ADF) or FROM DMS.
• ADD TO CARD puts the files under a folder named like the archive: Packs/drums.zip → Packs/drums/…. The same goes for an opened module's samples.

Limits

• Amiga disks: AmigaDOS disks (OFS and FFS). A demo or game disk without files still shows the modules that lie unpacked on it, named after the module or RIPPED n.mod; with none it says NO FILES ON THIS DISK — A DEMO OR GAME KEEPS ITS MUSIC PACKED INSIDE. Long-filename disks (DOS\6, DOS\7) are not supported.
• DMS: M8Thor unpacks the disk inside and reads it like an ADF; password-protected DMS files are decoded too. A DMS that holds no Amiga disk (MS-DOS or FMS) shows THIS DMS HOLDS NO AMIGA DISK, and a broken one THIS DMS IS DAMAGED.
• ZIP: stored and deflated files. Encrypted files, other compression methods and links are skipped and counted (e.g. 2 FILES SKIPPED: ENCRYPTED). ZIP64 and split ZIPs are not supported.
• LHA/LZH: files with a method M8Thor can't unpack and links are skipped and counted, too (e.g. 1 FILE SKIPPED: UNSUPPORTED METHOD). LZX archives are not supported.
• At most 1 GB and 10 000 files per archive.
• Search does not look inside archives.

Mac folders

man mac · Browse folders on your Mac and add their samples to the card

Add a folder

• Your samples live all over the place? In BROWSE, ADD MAC FOLDER… under MAC FOLDERS picks a folder on your Mac. You browse it level by level, just like a backup version, with the same keys, previews, AUDITION and LOOP.
• M8Thor only reads these folders. A folder you rename or move is found again; one that is gone shows NOT FOUND. Right-click › REMOVE FOLDER takes it off the list, and the folder itself stays where it is.

To the card

• EDIT a sample, then STAGE FOR CARD: it becomes a new file on the card, with the badge FROM MAC FOLDER. The Mac file is not changed.
• ADD TO CARD… (right-click on files or folders): pick the FOLDER ON THE CARD; files keep their folders below it, and names the card can't take are cleaned up. The sheet shows FILES, SIZE, COPIED AS THEY ARE, CONVERTED, STAGED SIZE and FREE ON BACKUP DRIVE. ADD N FILES stages them, at most 200 files at a time.
• Everything staged is written for the M8 as 44.1 kHz · 16-bit WAV. A WAV that already is exactly that is copied byte for byte; other files are converted, cue markers included. No need to think about formats.
• Staged files never overwrite anything: they wait as pending edits of the set you browsed in, and you apply them from PENDING when the card is connected (man stage).

Sets

man sets · Collect samples from any card and any Mac folder, then stage a whole set for a card

While digging through your samples, you'll find sounds that belong together. A set collects them, from any backup and any Mac folder. It holds references, never copies: the files stay where they are. SETS sit at the top of BROWSE's sidebar, above BACKUP SETS.

Make and fill a set

• NEW SET… beside SETS names a new set. Right-click a set for NEW SUBSET… (up to three levels deep), RENAME… and DELETE SET…; deleting a set removes only its references, never your files.
• One set is the TARGET, marked with a dot. F adds the file under the cursor to it, even while AUDITION steps through a folder, so you can collect as fast as you can listen. Right-click another set › MAKE TARGET to change it. A new set becomes the target when there is none.
• Right-click a file or its preview › ADD TO SET adds it to any set; the menu also offers NEW SET…, which names a new set and adds the file to it. A note at the bottom says ADDED TO <SET> or ALREADY IN <SET>.
• In the sample editor, ADD TO SET beside STAGE FOR CARD adds the sample you are editing to a set, or to a NEW SET…. The set gets the whole file, with its slices inside as cue markers, so the M8 can play them as slices; its saved edit goes along when the set is staged.
• A file out of an archive or a module lives in M8Thor's cache: SAVE A COPY FIRST, then add the copy.

A set in the list

• Click a set to open it: its files, each with where it is from (the card's name and the backup's day, MAC · <FOLDER>) or EDITED for a sample with a saved edit, sorted by NAME or ADDED. INCLUDE SUBSETS shows the files of every set below it too.
• They play, audition, loop and open in the editor just as anywhere else in Browse (→ opens the editor). Return shows the file in its folder. ⌫ or right-click › REMOVE FROM SET takes the reference out, and UNDO brings it back; the file stays where it is.
• A file that is no longer where the set expects it is dimmed and cannot play.

STAGE SET FOR CARD

• Set ready? STAGE SET FOR CARD… (in the set's header or its right-click menu) stages every file of the set as a new file in one folder on a card: pick the CARD and the FOLDER ON THE CARD; INCLUDE SUBSETS takes the files of the sets below it too.
• Edited files are rendered with their saved edit (EDITED), the rest go as they are (AS IS). Everything is written as 44.1 kHz · 16-bit.
• Nothing on the card is replaced: a taken name goes in under the next free one (NAME TAKEN → <NAME>), or with SKIP TAKEN NAMES on it is left out. MISSING files are skipped. FILE CHANGED means the file changed since its edit was saved: it is skipped, or with AS IS on it goes without the edit.
• STAGE N stages them. They wait as pending edits of that card's set and are applied from RESTORE like any other (man stage).

Sample editor

man editor · Trim, fade, slice, loop and process a sample without touching the original

Here's where your samples get their makeover. Open the editor from BROWSE: select a sample, then click its waveform or EDIT, or just press →. Chip tunes come in through OPEN IN EDITOR (man chips). The editor has its own window: resize it as you like, or go full screen with ⌃⌘F. M8THOR at its top left brings the main window forward and leaves the editor open. To get back to the editor, use EDITOR · <FILE> in the main window's title bar, Window › Sample Editor or ⌥⌘0. If you open another sample while one is open, M8Thor asks first: SAMPLE EDITOR HAS <FILE> OPEN — OPEN <OTHER> INSTEAD? Your edit of the open one is saved; only its undo history is lost.

The golden rule

The editor never changes the sample file, the backup or a Mac folder. Your settings are saved automatically per sample and come back when you reopen it (badge SAVED EDIT; RESET ALL discards them). To get the result out, EXPORT… a WAV file, or STAGE FOR CARD (man stage). Nothing to lose, right?

The window

• Top: M8THOR, the file's name, SAVED EDIT and RESET ALL when there is a saved edit, the length, and CPU: how much of each audio block's time the processing takes (hover for the peak since play). It changes colour from 70 % and again from 90 %; at 100 % the sound drops out.
• The page bar: TRIM › SLICE › LOOP › FX › OUTPUT, in the order the sound goes through them (keys 1 to 5), then MIDI (the MIDI window), MIDI LEARN, undo, redo and the zoom.
• The waveform with the marker lane shows your edit itself: NORMALIZE and IN, slices and fades. COMP, TAPE, OUT and the limiter never change the picture; while it plays, COMP's gain reduction hangs from its top edge. On the left sits the GAIN scale with the IN thumb and NORM; on the right the LEVEL scale with the display zoom handle, the OUT fader, the master meter and LIMIT under the fader.
• Below: the page's panel. Every page keeps the same height, so the waveform never jumps around. Drag the edge between them to make the waveform taller or shorter; a double-click sets the default.
• Knobs: drag up or down (⌃ for fine steps), scroll, or use the arrow keys once one has the focus; double-click to type a value, ⌥-click to reset. LED switches light up when they're on. Menus (GRID, SIG, TARGET…) take ↑ ↓, Return and Esc, and typing selects.

Waveform and zoom

• Click or drag on the waveform or the lane to place the playhead; click a slice to hear it. ⇧-click on the lane moves the nearer trim flag there. The I and O buttons and lane flags (keys I and O) set the trim start or end at the playhead.
• Drag from a region's edge to pull a fade; drag its curve to bend it.
• Zoom with ⌘+ ⌘− ⌘0 or pinch. Go all the way in and you see single samples, each drawn as a point.
• Z zooms to the selected slice, or to the trim; Z again takes you back to the view before. While zoomed to a slice, ← → go to the next slice and the view follows.
• X zooms to 100 ms around the handle or marker you touched last (or the playhead); X again goes back. A click, Home, End, ← or → give X back to the playhead. Perfect for fine-tuning a cut.
• Display zoom: the handle on the LEVEL scale draws the waveform taller (up to 16×) or smaller (down to 1/16×), stepless, with 1× in the middle. ⌥-scroll over the waveform does the same; a double-click or ⌥-click is 1×. Only the picture changes, never the sound.
• From one minute on, the header shows lengths as minutes and seconds, e.g. 37:38.84 OF 37:38.84. Undo and redo: ⌘Z / ⇧⌘Z.

Signal flow and gain

Your sound takes this path: slices → NORMALIZE → IN → FX → COMP → TAPE → OUT → LIMITER → DITHER to 16-bit.

• NORM, under the IN thumb on every page: NORMALIZE (key N) brings the trim's loudest peak to 0 dBFS, first in the chain, before IN and the FX. ⌥-click resets it.
• IN, the thumb on the GAIN scale: the sample's gain into the FX (−24 to +24 dB), on top of NORMALIZE. With a slice selected it sets that slice's gain; its caption shows IN or SLICE n. Click the caption (or press Esc) to go back to IN. ⌃-drag for fine steps, ⌥-click resets.
• OUT, the fader beside the meter: the level of what goes to the card, after the FX, COMP and TAPE, before the limiter. Drag (⌃ fine), scroll or arrow keys: 0.1 dB, with ⇧ 1 dB; double-click the number to type one; ⌥-click resets. You can learn it for MIDI, too. OUT on the OUTPUT page is the same gain.
• LIMIT under the fader opens the limiter's panel: LIMIT on or off, CEILING (−12 to −0.1 dBFS, default −0.3), RELEASE (10 to 500 ms, default 80; all the way up is AUTO) and GR, what the limiter takes off, live. You set the limiter's STYLE (CLEAN, PUNCH or LOUD) there too. ⌥ resets CEILING and RELEASE. A click elsewhere or Esc closes it.
• The master meter: L and R (peak and 300 ms RMS) and LU, the loudness. COMP's and the limiter's gain reduction hang from the top in their own lanes, and with LIMIT on the ceiling is a line across it. Above it TP (true peak left and right, the highest since play; a click starts it again) and RMS; below it LUFS (integrated since play) and DR (the higher true peak minus the short-term loudness).

1 · TRIM

• Knobs: TRIM START and END (⌥-click resets them to the file's ends), FADE IN and FADE OUT, each with its CURVE.
• REVERSE plays the sample backwards.
• SNAP TO ZERO (key S): trim edges and slice markers land on the nearest zero crossing within 10 ms, so your cuts don't click. It's the same switch as on SLICE.
• GRID: bars and beats over the waveform, at M8 LOOP's tempo, the detected one (LOOP?), or the one BARS and SIG make of the trim. Click to switch it on or off; ⌥-click leaves it to the tempo again (auto). The menu next to it sets the density (AUTO follows the zoom; BAR, BEAT and note values down to 1/64), CONTRAST how strongly the lines show.

2 · SLICE

• Up to 128 markers, plenty for even the busiest break. Tools: Select (arrow), Add markers (pencil), Remove markers (eraser); CLEAR removes them all. M adds a marker at the playhead.
• MARKERS: EVEN + APPLY makes equal slices. THRESHOLD puts a marker on every hit that reaches the two lines in the waveform; lower it to find quieter hits. It replaces the markers.
• Per slice: GAIN (±24 dB), REVERSE, NORMALIZE, RESET, FADE IN, FADE OUT.
• From three slices on, the list button shows every slice's controls; with AUDITION on, ↑ ↓ play the slice they land on.
• Right-click a slice: PLAY SLICE, REVERSE, NORMALIZE SLICE, RESET GAIN, RESET FADES, ZOOM TO SLICE, EXPORT SLICE…, STAGE SLICE FOR CARD…, DELETE MARKER. Right-click anywhere else: ADD MARKER HERE.

3 · LOOP

• M8 LOOP writes loop points for the trimmed sample into the file, so your M8 loops it in the Sampler. Turning it on loops the preview too.
• A sample's own loop is kept: the M8 plays the start once, then repeats that part. CLEAR removes it; M8 LOOP replaces it with a loop over the whole sample.
• TEMPO: BARS (1–64) and BPM show the loop's tempo, the way the M8 counts it. Turn, type or TAP a tempo, then SET LENGTH trims the loop to it. SIG sets the time signature. The editor suggests a tempo from the file, the name or the length; LOOP? appears when the length fits whole bars.
• With M8 LOOP on: CLICK, a metronome in the preview from the loop start (never exported, don't worry), its VOL, and GRID.

4 · FX

• Bring in up to four Audio Unit plugins from your Mac, one row each, in the order the sound goes through them. ADD PLUGIN under the last row adds one: type to search, or pick it by maker. A row's plugin name opens the plugin's own window; the chevron beside it picks another or removes it. ON switches it (off bypasses it); drag a row's grip to change the order. TAIL, in the page bar, lets effects ring out past the end; the file gets longer.
• Each row has an IN and an OUT dot: green while it sounds, orange when the input goes over the row's TARGET, red when it reaches full scale. It stays lit for 1.5 s after the last over; a click clears it.
• Each row has its own gain staging too: IN (the level into the plugin), TARGET (the input peak the plugin works best at, remembered per plugin), TO TARGET (sets IN so the loudest peak lands on TARGET), OUT (the level out of the slot) and MATCH (sets OUT so the slot leaves the level as it found it). TO TARGET and MATCH measure over the trim, the plugins before included; click again to cancel. No more guessing levels.
• FX n: NO SIGNAL means there was nothing to measure in the trim. NOT ON THIS MAC: <PLUGIN> means the plugin isn't on this Mac; export and staging stop until you install it or remove the slot.
• While a plugin window is in front, MIDI from any connected source goes to that plugin, for its own MIDI learn. Space and Return play as in the editor.

5 · OUTPUT

• The finishing touch: a rack in the order the sound goes through it, COMP › TAPE › OUT › LIMITER › DITHER. A module's name is its on switch; its settings stay while it is off. ⌥-click resets a knob. Under the rack sits a meter from −48 to 0 dB with peak hold, COMP's and the limiter's GR, and CLIP: it lights once samples had to be clamped; a click puts it out.
• COMP has two styles, switched with CLEAN | BUS beside its name. CLEAN: THR, RATIO, ATK, REL, KNEE and MAKEUP, and under them HPF (a sidechain high-pass, 30 to 300 Hz, all the way down is OFF, so the bass doesn't pump it), MIX and HOLD. BUS, in the manner of a classic console bus compressor, the glue: the same knobs, but RATIO steps through 1.5, 2, 4 or 10, ATK through 0.1, 0.3, 1, 3, 10 or 30 ms, and REL through 100, 300, 600 ms or 1.2 s, AUTO and FAST (AUTO FAST). Its KNEE follows the ratio and reads BY RATIO.
• AUTO beside COMP's name lets MAKEUP follow what COMP takes off, level-matched, and MAKEUP shows the level it stands at; turning MAKEUP switches AUTO off, and nothing jumps. While it plays, COMP's gain reduction hangs from the waveform's top edge.
• TAPE, a tape-style saturator, has CLEAN | LO-FI beside its name. Its knobs: DRIVE (how hard the tape is driven; the level coming out is kept), BIAS (the tape's bias, −6 to +4 dB, default 0: under is grittier and saturates sooner, over is cleaner and darker), TONE (darker or brighter) and MIX, and under them SPEED (7.5, 15 or 30 ips, default 15; slower is warmer). LO-FI is under-biased tape with more grit (BIAS sets how much) and adds WOW (the pitch drifting, flutter included), HISS and DROP (short dips in level), each at 0 until you turn it up.
• In LO-FI, WOW and its flutter keep in step with your edit's loop (the sample's own loop, or the whole trim with M8 LOOP on; LOOP PREVIEW doesn't count), so the seam stays clean. If the loop is too short for them, TAPE says WOW OFF — LOOP TOO SHORT, or WOW + FLUTTER OFF — LOOP TOO SHORT when even the flutter doesn't fit.
• OUT is the same gain as the fader beside the waveform. LIMITER, a true-peak limiter (8× oversampled, 5 ms look-ahead, which the preview makes up for): CEIL and REL, where REL's top position is AUTO, a release that follows the material; under them STYLE: CLEAN (transparent), PUNCH (keeps the attacks) or LOUD (pushes hardest).
• DITHER is the same switch as SETTINGS › Advanced › "Dither 16-bit files", on by default: it applies to every 16-bit render and export.

Playback and output

• ▶ PLAY / ■ STOP, Space, Return (the whole result from the trim start). LOOP PREVIEW (or L) loops playback in the editor only.
• Samples whose audio fits in 128 MB (about 5.5 minutes of 48 kHz stereo, 11 of mono) play through the live engine: you hear every change at once. Longer ones play a rendered preview, which follows a change after a restart; GR then shows —.
• EXPORT… (⇧⌘E) writes a WAV (default name <sample>-edit.wav). It refuses to overwrite the original or to write into your backup folder. While a render or an export runs, the footer shows RENDERING and how far it is.
• Output is PCM WAV at the source's bit depth where possible (otherwise 16-bit). 16-bit files get a tiny dither noise, so quiet fades don't distort (SETTINGS › Advanced › "Dither 16-bit files"). Slice markers are written as cue points your M8 reads.
• STAGE FOR CARD (⌘Return) queues the result for the card. See man keys for all keys and man midi for controllers.
• ADD TO SET, beside STAGE FOR CARD, adds the sample to a set or to a NEW SET… (man sets). The set remembers the original file, and your saved edit is rendered when the set is staged (slices travel as cue markers). A render, a module's sample or a file inside an archive can't go into a set: EXPORT… it first.

MIDI controllers

man midi · Learn knobs, switches and actions of a MIDI controller for the sample editor

Learn

1. In the sample editor turn on MIDI LEARN (the button, or K).
2. Click a knob or a switch in the editor, or an action in the MIDI window.
3. Move a control or press a button on your controller. Done: the mapping is learned.

• Real knobs under your fingers feel so much better than a mouse, don't they? In learn mode a click selects and changes nothing; where the value usually sits, you see what the control is learned on. ⌫ forgets the selected mapping, Esc ends learn mode. Keys that edit do nothing meanwhile.
• A learned knob carries a small dot. With PICKUP, a tick outside its ring shows where the controller stands until it has picked the value up.
• Almost every knob and switch in the editor can be learned, the choosers too: COMP's CLEAN | BUS, TAPE's CLEAN | LO-FI, SPEED and the limiter's STYLE move one choice per step. Not learnable, among others: TARGET, TO TARGET, MATCH, APPLY, TAP, SET LENGTH, SIG, DITHER, COMP's AUTO and the on switches of COMP and TAPE.
• Actions (a button or a pad): play, play the result, restart, previous or next slice, select a slice, add a marker, trim start or end, zoom to the slice or the last touched point, zoom in, out or reset, the five pages, undo and redo.

The MIDI window

MIDI in the editor's page bar opens it: every mapping, the ACTIONS list and the LAST MESSAGE monitor, all in one place. Open a mapping for its options; LEARN AGAIN and FORGET sit on each row.

• Knobs: ENCODER (ABSOLUTE, RELATIVE · 2'S COMPLEMENT, RELATIVE · BINARY OFFSET, RELATIVE · SIGN MAGNITUDE), INVERT, TAKEOVER (PICKUP waits until the controller reaches the knob, JUMP moves it at once), RANGE (the part of the knob the controller's travel covers).
• Trim edges and fades also have SCALE: ZOOM moves by a 256th of what the waveform shows, finer the further in you go; FIXED moves 10 ms a tick (an absolute knob then covers the whole range). An absolute knob with ZOOM moves by how far you turn; at its end, turn back or zoom out.
• Switches on a CC: MODE (TOGGLE follows the button's on and off, MOMENTARY flips on each press) and INVERT. Actions have no options.

Settings › MIDI

• INPUT: the connected DEVICES and LAST MESSAGES. The monitor listens only while the page is open.
• YOUR KNOBS › Detect a knob: press DETECT KNOB, then turn a knob slowly to the right (TURN THE KNOB SLOWLY TO THE RIGHT…), then to the left (NOW TO THE LEFT…). M8Thor shows what it sends, e.g. CC 21 · CH 1 — ENDLESS ENCODER · RELATIVE · BINARY OFFSET, and asks before it changes anything: YES, USE FOR NEW KNOBS, or, for a knob already learned with other settings, YES, CHANGE <KNOB>. For an absolute knob it suggests switching it to relative in the controller's setup tool. No manual digging needed.
• Defaults for new knobs: the ENCODER, INVERT, SCALE and TAKEOVER a knob starts with when you learn it for the first time. Switches and notes keep their own; you can still change each mapping.
• MAPPINGS lists everything learned, with the same options as the MIDI window. CLEAR ALL forgets every mapping; the defaults stay.

Knobs and encoders: setting up your controller

Not sure what your controller sends? Turn a control and read the monitor:

• Values that rise and fall between 0 and 127: a knob, or an endless encoder sending absolute values. Keep ENCODER on ABSOLUTE; on trim and fades SCALE ZOOM moves by how far you turn.
• Values that only say which way: an encoder in relative mode. 1 / 127 is RELATIVE · 2'S COMPLEMENT, 65 / 63 is BINARY OFFSET, 1 / 65 is SIGN MAGNITUDE. DETECT KNOB finds this out for you.
• Relative works best: the knob has no end. Many controllers switch to it in their own setup tool, with a custom mode that sends one value for each direction.
• Example, ParksTool (config.parkstool.com): set the encoder's Content Type to MIDI CUSTOM with right 65 and left 63, then use BINARY OFFSET. ParksTool's own example, 65 left and 63 right, works too with INVERT on.
• A push switch on an encoder: let it send a note and learn it on an action. As a quick workaround, let it type a key (e.g. KEYBOARD "X").

Staging and applying edits

man stage · Queue edited and added samples for the card, then apply them from the Restore tab

Edited and added samples reach your card in two steps: you STAGE them (no card needed), then APPLY them to the card from the RESTORE tab. So you can prepare everything whenever you like, and your M8 only has to join in at the end.

Stage

In the editor, press STAGE FOR CARD (or right-click a slice: STAGE SLICE FOR CARD…).

• SAVE AS NEW: writes a new file. Set NEW FILENAME and FOLDER (it must start with /Samples/).
• REPLACE ORIGINAL: the new file takes the original's place. M8Thor checks which songs and instruments use the sample and warns you ("… MAY BREAK"), then asks "Really replace …?". For non-WAV sources, use Save as New.
• STAGE queues the edit. The original stays untouched in your backup.
• Samples from a Mac folder, an archive or a chip tune are always staged as new files, with their origin: FROM MAC FOLDER, FROM ZIP, FROM LHA, FROM ADF, FROM DMS, FROM MODULE, FROM SID, FROM TFMX. ADD TO CARD stages many at once (man mac), STAGE SET FOR CARD a whole set (man sets).

Review (no card needed)

Want another look before anything touches the card? In BROWSE, open a set's PENDING (N) row (↑ ↓ move between edits). For each edit you can play the staged file, see KIND, TARGET, SOURCE, ROTATION, STAGED, and use CHANGE TARGET…, OPEN IN EDITOR (reopens with the staged settings; staging again replaces the entry) or DISCARD.

Apply

• The RESTORE tab shows a PENDING EDITS block. For a connected card, press APPLY…; a card that is not connected shows "CONNECT THE M8 TO APPLY". The BACKUP tab points you there too (N PENDING EDITS → RESTORE). Sets and versions in the restore wizard offer APPLY N as well.
• The sheet lists every edit (+ NEW or REPLACE). Tick the ones you want, then APPLY SELECTED and confirm. CHECK CARD reads the songs on the card to see which use a sample you replace.
• Each copy is verified after writing. A new file never overwrites an existing one: you get COLLISION with RENAME instead. Other states: DONE, RETRY, SOURCE MISSING ON CARD, MORE / FEWER SONGS NOW USE THIS SAMPLE.
• DISCARD ALL removes every pending edit (it asks first).
• After a clean apply, BACKUP NOW offers a fresh backup of the changed card. Always a good idea.
• Applying is blocked while a backup or restore runs.

Remote

man remote · Your M8 on the Mac: its screen, its keys from the Mac's keyboard, its USB audio

The REMOTE tab (⌘4) brings your M8 onto your Mac: its screen in a monitor, its keys on the Mac's keyboard and its USB audio through your Mac. For that, your M8 is connected by USB in its normal mode. In USB drive mode its card belongs to backups, so REMOTE politely steps aside.

Connect

• Connect your M8 by USB and the glass says M8 READY. Start the picture with CONNECT on the monitor, ⌘K or Actions › Connect to M8; DISCONNECT stops it. Switch tabs as much as you like, the picture keeps running.
• The monitor follows the app's appearance: a CRT in Dark, an LCD in Light. Below the glass you see your M8's model, firmware and screen size (e.g. MODEL:02 · FW 6.6.3 · 480×320) and its state: READY, CONNECTING, LIVE, RECONNECTING, DISK MODE.
• If another program has the M8's port open, it blocks it: PORT IN USE BY ANOTHER APP. Quit that program, then press RETRY. More messages: man troubleshoot.

Keys

• Click the M8's screen. While it has the ring (KEYS → M8 below the glass), the Mac's keys play your M8. Click elsewhere, switch tabs or open a sheet, and the keys belong to the Mac again.
• The arrows are the M8's arrows; Z or left ⇧ is SHIFT, X or Space PLAY, A or left ⌥ OPTION, S or Return EDIT, and ⌫ presses OPTION and EDIT together. All keys: man keys.
• Feel like jamming? Esc turns keyjazz on or off, and the letter rows play notes, just like in m8c. KEYJAZZ below the glass shows it with its octave and velocity; − and = change the octave, [ and ] the velocity (with ⌥ in steps of 1).
• Keys go by their place on the keyboard, so they are the same on every layout. SETTINGS › Shortcuts lists them under Remote. They are fixed.

Audio

• AUDIO plays your M8's USB audio on this Mac. VOL is its level here, not the system volume. Beside AUDIO you see how late the sound plays on this Mac, in ms.
• macOS treats the M8's USB audio as a microphone and asks once for access. Don't worry: M8Thor only listens to the M8 and records nothing. Without access the screen and the keys still work (MIC ACCESS DENIED); you can allow it in System Settings › Privacy & Security › Microphone.

Disk mode

• When your M8 switches to USB drive mode, REMOTE lets go of it: M8 IN DISK MODE. EJECT CARD ejects the card safely, and your M8 comes back to REMOTE all by itself.
• While a backup, restore or auto-backup holds the card, the button says so and waits. The card is never ejected in the middle of one.
• Taken out of disk mode without ejecting? Then you'll see CARD REMOVED WITHOUT EJECT — EJECT THE CARD BEFORE THE M8 LEAVES DISK MODE.

Settings

man settings · Every setting, what it does and its default

Most of what you can tune in M8Thor lives in SETTINGS. Open it with ⌘5 (tab) or ⌘, (Settings window). The pages: General, Appearance, Backup, Verification, Notifications, Updates, Advanced, MIDI, Shortcuts, About. Where a setting has a default, it is listed below, so you always know where you started.

General

• Launch on login — M8Thor starts when you log in. Default off.
• Menu bar icon — M8Thor keeps running in the menu bar after you close the window. Default off. Click the icon to show or hide the window; right-click it for a menu with each card and its state, "Open Main Window" and "Quit M8Thor".
• Ask to eject on quit — when you quit with a card connected, M8Thor asks: "Eject and Quit", "Quit" or "Cancel", with "Don't ask again". Default on.

Appearance

• Appearance — System, Light, Dark. Default System.
• Accent — pink, lime, amber (default), cyan, violet. Pick the one that glows best for you.
• Typography — Mono (default) or Sans.
• Text size — XS, S, M (default), L, XL.

Backup

• Backup directory — where your backup sets are written; CHOOSE… (not while a backup or restore runs). Default ~/Backups.
• Back up when connected — starts a backup a few seconds after you connect an M8 card, with a countdown you can cancel. It applies from the next connect, and the first-launch setup offers it too. Default off.
• Rotate old backups — keeps only the newest backups per card. Default on.
• Rotations per device — how many backups to keep per card, 1–30, default 5. Disabled while rotation is off.
• Auto-eject on completion — unmounts the M8 card after a successful backup. Default off.

Verification

• Checksum pass — re-compares the copied files with checksums after each backup. It takes extra time and buys you extra peace of mind. Default off.
• On mismatch — Retry (try once more), Flag (default: keep an incomplete copy for diagnosis), Abort (discard it). A failed verification never replaces a good backup.

Notifications

• macOS permission — whether macOS lets M8Thor notify you, with a button to ask or to open System Settings.
• Completion — a notification when a backup finishes. Default on.
• Failure — a notification when a backup fails. Default on.
• Play sound — a short chime when a backup ends. Default on.

Updates

• Check for updates automatically — looks for new versions on m8thor.cc in the background. Default on (see man updates).
• App updates — CHECK NOW looks for a new version right away; the row shows the installed version.
• Check for M8 firmware — once an M8 has been connected, asks Dirtywave's GitHub once a day for new firmware (man firmware). Nothing about you or your M8 is sent. Default on.

Advanced

• Recognize other SD cards — also back up SD cards and USB drives from other devices (man backup). Default off.
• Identify M8 when connected — asks an M8 in normal USB mode for its model and firmware version when it appears, for firmware updates; never while its card is in use. Default on.
• Dither 16-bit files — a tiny noise when the sample editor writes 16-bit files (export and staging), so quiet fades don't turn into distortion. Unedited samples stay bit-exact. Default on.
• rsync — BUILT-IN (M8Thor's own rsync 3.4.4, with xxHash) or HOMEBREW, when Homebrew rsync is installed.
• rsync path, rsync version, Incremental (link-dest), Progress bar (--info=progress2) — read-only checks of the selected rsync.

MIDI

Devices and the monitor, Detect a knob, Defaults for new knobs and the mappings are all explained in man midi.

Shortcuts

• Preset — Standard, Logic or Custom. Coming from Logic Pro? Logic uses Logic Pro's keys wherever the editor does the same thing.
• Click a key to change it; that makes your own set, Custom (from Standard or Logic). Press the new key; Esc cancels, ⌫ removes the key. A key already in use asks to REPLACE it. RESET per row, RESET ALL for the whole set.
• Only the sample editor's keys can change; locked keys (menus, ⌘Z, Esc, lists, Browse, Remote) are the same in every preset.
• Letter and digit keys work by their place on the keyboard and show your layout's letters: on a German keyboard the key for Z shows Y.
• ⌘F searches the list. See man keys.

About

Publisher (Imprint), Version, Homepage, Open source (LICENSES & SOURCE, see man updates) and Trademarks.

Keyboard shortcuts

man keys · All keyboard shortcuts in the app, Browse, Remote and the sample editor (Standard preset)

Rather keep your hands on the keyboard? Here are the keys of the Standard preset. Letter keys go by their place on the keyboard (on a German keyboard, Z is the key printed Y). The editor's keys can be changed in SETTINGS › Shortcuts (man settings).

App

⌘1 ⌘2 ⌘3 ⌘4 ⌘5

BACKUP, RESTORE, BROWSE, REMOTE, SETTINGS

⌘B

back up the selected card

⌘E

eject all M8 cards

⌘R

refresh cards

⌘K

connect the M8 in REMOTE

⌥⌘0

to the open sample editor (Window › Sample Editor)

⌘,

Settings window

⇧⌘M

show only the progress, while a backup or restore runs

Return

NEXT → in the first-launch setup

Browse

⌘F

search the version

↑ ↓

move through the list; samples and tunes play while AUDITION is on

→

enter a folder, an archive or a module, or open the sample in the editor

←

leave the folder; at the top, back to the backup versions

Return

open the row

Space

play or stop; turns AUDITION on

Esc

stop and turn AUDITION off

↑ ↓

in the backup versions: previous or next version; Return or → go on in the files

↑ ↓

in the pending edits: previous or next edit

F

add the file under the cursor to the TARGET set

Double-click

open an archive or a module

In RESTORE's backup browser, Esc closes it.

Remote

Click

click the M8's screen: while it has the ring, these keys play the M8

↑ ↓ ← →

the M8's arrows

Z ⇧

SHIFT (left ⇧)

X Space

PLAY

A ⌥

OPTION (left ⌥)

S Return

EDIT

⌫ ⌦

OPTION and EDIT together

Esc

keyjazz on or off: the letter rows play notes

− =

keyjazz octave down, up (also ÷ × on the keypad)

[ ]

keyjazz velocity down, up; with ⌥ in steps of 1 (also − + on the keypad)

R

redraw the M8's screen (keyjazz off)

These keys go by their place on the keyboard, so they work the same on every layout, and they cannot be changed.

Sample editor

1–5

pages TRIM, SLICE, LOOP, FX, OUTPUT

Space

play from the playhead, or the selected slice; again to stop and jump back

Return

play the whole result from the trim start

Esc

stop; when idle, clear the selection; closes the editor when nothing is left

← →

previous or next slice, played at once

↑

restart the selected slice (in the slice list: ↑ ↓ previous / next slice)

⇥ ⇧⇥

select the next or previous slice

⌫

delete the selected slice marker

M

add a marker at the playhead

I O

trim start or end at the playhead

R ⇧R

reverse the slice, reverse the whole sample

N

toggle normalize

L

loop the preview

S

snap to zero on or off

K

MIDI learn on or off (in learn mode ⌫ forgets, Esc ends)

Z

zoom to the slice or the trim; again to go back

X

zoom to 100 ms around the last handle or marker you moved (or the playhead); again to go back

Home End

jump to the start or the end

⌘+ ⌘− ⌘0

zoom in, out, reset; pinch zooms around the pointer

⌘Z ⇧⌘Z

undo, redo

⌃⌘F

editor full screen

⇧⌘E

export the result

⌘Return

stage for the card

⌥⌘0

back to the main window; the editor stays open

⌥-click

reset a control; on a fade curve, make it linear

⌃-drag

fine resolution while dragging a handle or a knob

⌥-scroll

display zoom over the waveform

⇧-click (lane)

move the nearer trim flag to the click

Right-click

slice menu

• The metronome (CLICK) has no key in Standard; Logic uses K for it and ⌘L for MIDI learn.
• Logic preset differences: ⇧Space restarts the slice, ⌘→ ⌘← zoom in and out, C loops the preview, ⌘T adds a marker.
• In a plugin's window, Space and Return play just as they do in the editor.

Where your data lives

man storage · Backup folder layout, disk space, staged edits, caches, editor settings, sets and firmware

Backup folder

Curious where everything ends up? By default in ~/Backups, or in the folder you chose. Inside it you'll find:

• one folder per card: <VOLUME NAME>_<last 8 characters of the card UUID>
• one folder per backup inside it: backup-YYYY-MM-DD-HHMMSS, plus a latest link to the newest one
• .edits/, which holds staged sample edits until they are applied

No secret format here: the backup folders are plain files, and you can open them in Finder any time (HISTORY on the BACKUP card).

Disk space

• Unchanged files are hardlinked between versions and take no extra space.
• Before copying, M8Thor estimates the transfer and stops with "Not enough disk space for this backup." if the destination has less than the estimate plus 100 MB free. Better to stop early than to fail halfway.
• CHANGE DESTINATION… makes a standalone full copy, without links to your default store.
• Moving a version to the Trash frees only the files no other version shares, often far less than its size (on drives without hardlinks, e.g. exFAT, its full size). Rotation deletes the oldest versions permanently. See man restore.

What is skipped

macOS housekeeping files (.DS_Store, ._*, .Spotlight-V100, .Trashes, .fseventsd) are not backed up or restored. Your M8 doesn't need them, and neither do your backups.

Unfinished backups

A backup is written to a hidden staging folder first and only appears as a version once it is complete. A failed run may be kept for diagnosis; it is never offered for restore and is removed on the next backup of that card.

Other locations

• Sample editor settings: ~/Library/Application Support/M8Thor/edits/
• Renders of chip tunes and a module's samples you staged: ~/Library/Application Support/M8Thor/Generated/ (kept while a pending edit refers to them)
• Waveform overviews: ~/Library/Application Support/M8Thor/waveforms/ (a cache, up to 256 MB, oldest removed first; safe to delete)
• Unpacked archives: ~/Library/Caches/M8Thor/Archives/ (up to 2 GB); opened modules' samples and unpacked tunes: ~/Library/Caches/M8Thor/ (up to 256 MB). Caches, oldest removed first; safe to delete.
• Mac folders you added: remembered by the app; the folders themselves are only read.
• Card names: remembered by the app; they never change the card, its volume name or its backup folder.
• Sets: ~/Library/Application Support/M8Thor/sets.json, references only (man sets).
• Firmware: ~/Library/Application Support/M8Thor/firmware.json (what each M8 reported, which firmware M8Thor put on which card, the EULA you accepted) and the downloaded releases in Firmware/ beside it (man firmware).
• Diagnostic rsync logs: ~/Library/Logs/M8Thor/, deleted after 30 days
• Exports (SAVE A COPY…, EXPORT…) can go anywhere you like, except inside your backup folder.

Updates, beta and licenses

man updates · Automatic updates, the beta period, reporting problems, open source notices

Updates

• M8Thor checks for updates automatically once a day (Sparkle), so you stay up to date without lifting a finger. You can switch this off in SETTINGS › Updates.
• Want to check yourself? M8Thor menu › "Check for Updates…", or SETTINGS › Updates › App updates › CHECK NOW.
• Updates keep working after the beta ends, so a follow-up version can always be installed.

Beta

• During the beta you get every feature. A notice reads "BETA ACCESS ENDS NOVEMBER 30, 2026". You can dismiss it; it comes back 14 days and 3 days before the end.
• Beta access ends for every installation after 30 November 2026 (the last day is complete in every time zone). The app then shows "M8THOR BETA HAS ENDED" with a link to m8thor.cc, and its features are locked. Your backups stay right where they are: plain folders you can open in Finder (man storage).

Report a problem

Something not working the way it should? Reporting it only takes a minute. Use Help › "Report a Problem…", or REPORT PROBLEM on a failed backup. Describe what happened, check the REPORT PREVIEW (app, macOS and rsync version, card details, recent log), then COPY REPORT, SEND BY EMAIL (support@m8thor.cc) or OPEN ON GITHUB. The report is copied to the clipboard; your home folder path, UUIDs and card IDs are masked. Nothing is sent automatically.

Open source

M8Thor stands on the shoulders of open source. SETTINGS › About › Open source › LICENSES & SOURCE opens OPEN SOURCE & LICENSES: every open source part inside the app, its license readable in place and its files one click away in Finder — also after the beta has ended. The license texts and sources sit in the app at Contents/Resources/ThirdParty:

• rsync 3.4.4 (GNU GPL v3, full source) with popt, zlib and xxHash 0.8.3 compiled in.
• Sparkle (MIT), for app updates.
• libopenmpt 0.8.9 (BSD-3-Clause), which reads the tracker modules.
• m8thor-sid (GNU GPL v2 or later, source in the app) with libsidplayfp 3.1.1 (and its hashlib, MIT) and libresidfp 1.2.2, for SID tunes.
• m8thor-tfmx (GNU GPL v2 or later, source in the app) with libtfmxaudiodecoder 1.0.14, for TFMX tunes.
• ancient 2.3.0 (BSD-2-Clause, with tables from bzip2, bzip2 License) for DMS disk images and lhasa 0.6.0 (ISC) for LHA and LZH archives, both compiled into m8thor-unpack.
• The M8 display fonts (CC BY-SA 3.0) REMOTE draws the M8's screen with: Trash80's stealth57 and the large font after sm0hm's m8xl-ess, taken from m8c by Jonne Kokkonen (MIT).

Dirtywave and M8 are trademarks of Dirtywave. M8Thor is independent and not affiliated with Dirtywave. See also m8thor.cc/licenses.html.

Troubleshooting

man troubleshoot · What the messages mean and what to do

Card not found

• NO M8 DETECTED — connect your M8 via USB and switch it to USB drive mode.
• NO M8 CARD FOUND (N VOLUMES SCANNED) — volumes are mounted, but none has the M8 files (System/STARTUP.m8s, or Songs and Instruments). Check the card, then SCAN NOW. For a card from another device, turn on "Recognize other SD cards".
• SCAN ERROR — the volume scan failed; press RETRY.
• Restore shows NO CARD DETECTED — connect your M8 in USB drive mode or insert a FAT32/exFAT SD card, then REFRESH.
• macOS refused access to the card or the backup folder — OPEN SETTINGS opens System Settings › Privacy & Security › Files & Folders; allow M8Thor there, then RETRY.

Backup messages

• "Not enough disk space for this backup." — free space or pick another destination.
• "Unsupported rsync version. Select a supported rsync in Settings." — SETTINGS › Advanced, choose BUILT-IN.
• "Volume identity or mount path changed. Reconnect the card and select it again."
• "Source files disappeared during backup. The backup is incomplete and was not published." — something changed the card during the backup; run it again.
• "Backup transfer failed (rsync exit N). The backup was not published."
• "Backup verification failed: …" — the copy did not match the card. Don't panic: your previous backups are untouched. See "On mismatch" in man settings.
• "Nothing selected to back up." — select at least one folder or song.
• "Cannot start backup — … in progress on this card." — wait for the other operation.
• "Backup saved, but it holds far fewer files than the previous one (…). Older backups were kept — check the card." — the card may be empty or damaged; your older backups were kept.
• "Backup saved, but the "latest" link could not be updated: …"
• "Backup was cancelled." — no incomplete version was published.

Eject

• "Cannot eject while another operation is running." — wait until it has finished.
• "Failed to eject: …" — close apps that use the card and try again.
• Quitting during a backup asks "Operation in Progress": "Close Anyway" cancels it; an unfinished backup is discarded, a finished one is kept.

Restore messages

• "Partial restore: some files could not be transferred (rsync code 23). Check the log for details."
• "Restore incomplete: source files disappeared during transfer. …"
• "Another operation is already running for this card."
• "Backup source no longer exists on disk."
• "Restore was cancelled — the target may be partially restored"
• "M8 card disconnected during restore — the target may be partially restored"
• "rsync output parse failed — raw log saved to <path>" (during PREVIEW)

A partial restore is no drama: run the restore again to complete it.

Browse and editor

• CHOOSE A FOLDER OUTSIDE YOUR BACKUPS — exports can't go into the backup folder.
• "Refusing to overwrite the original sample. Choose a different name."
• NOT ON THIS MAC: <PLUGIN> (the slot reads MISSING · <PLUGIN>) — a plugin used in an FX slot is missing. Export and staging stop until you install it or remove the slot.
• FX n: NO SIGNAL — TO TARGET or MATCH found nothing to measure in the trim; the gains stay as they were.
• "Reference check failed: …" — M8Thor could not read the songs of this version, so USED IN and UNUSED are not available.
• NOT FOUND under MAC FOLDERS — the folder is gone or on a drive that isn't connected.
• NOT ENOUGH SPACE ON THE BACKUP DRIVE (ADD TO CARD) — staged files live on the backup drive until they are applied.
• NO TARGET SET (F) — right-click a set › MAKE TARGET first. SAVE A COPY FIRST (ADD TO SET) — the file lives in M8Thor's cache (an archive's or a module's); save a copy, then add that (man sets).

Remote

• NO M8 CONNECTED — connect the M8 by USB. M8 IN DISK MODE — your M8 is in USB drive mode; EJECT CARD, and it comes back.
• PORT IN USE BY ANOTHER APP — another program has the M8's port open; quit it, then RETRY.
• CONNECTION LOST — the M8 went away, did not answer or could not be read; CONNECT again.
• MIC ACCESS DENIED — allow M8Thor in System Settings › Privacy & Security › Microphone; the screen and the keys work without it. M8 AUDIO NOT FOUND — the M8's USB audio does not show up; M8Thor looks again when audio devices change. OUTPUT IS THE M8 — this Mac plays through the M8 itself, which would feed its sound back in; pick another output.
• EJECT FAILED — the card could not be ejected; the reason follows.

Firmware

• LAST CHECK FAILED (FIRMWARE row) — Dirtywave's GitHub could not be reached; M8Thor tries again later.
• DOWNLOAD FAILED — TRY LATER, or THE DOWNLOADED FIRMWARE IS DAMAGED — GET IT AGAIN.
• CARD IS BUSY — TRY AGAIN WHEN IT IS FREE — a backup, restore or apply is using the card.
• NOT ENOUGH SPACE ON THE CARD.
• THE CARD WENT AWAY OR CHANGED — NOTHING WAS LEFT ON IT, or THE CARD DID NOT READ BACK THE SAME — NOTHING WAS LEFT ON IT — copy again. THE CARD WENT AWAY DURING THE COPY — a temporary file may be left on it; M8Thor removes it the next time.

Archives and chip tunes

• NOT A ZIP ARCHIVE, THIS ZIP IS DAMAGED, ZIP64 IS NOT SUPPORTED, SPLIT ZIPS ARE NOT SUPPORTED, THIS ZIP IS TOO LARGE TO OPEN — see the limits in man archives.
• NOT AN LHA ARCHIVE, THIS LHA IS DAMAGED, THIS LHA IS TOO LARGE TO OPEN — the same for LHA/LZH archives; limits in man archives.
• NOT A DMS DISK IMAGE, THIS DMS IS DAMAGED, THIS DMS IS TOO LARGE TO OPEN, THIS DMS HOLDS NO AMIGA DISK (an MS-DOS or FMS disk packed as DMS).
• N FILES SKIPPED: ENCRYPTED / UNSUPPORTED METHOD / LINK — those files were left out; the rest opens.
• NOT AN AMIGA DISK IMAGE, NO FILES ON THIS DISK — A DEMO OR GAME KEEPS ITS MUSIC PACKED INSIDE (a demo or game disk with no module lying unpacked on it), THIS DISK IS DAMAGED, LONG FILENAME DISKS ARE NOT SUPPORTED.
• A module, SID or TFMX tune that doesn't play shows why under PLAY. A TFMX tune needs its sample file (smpl.<name>) in the same folder.

Moving a version to the Trash

• THE LAST BACKUP OF A CARD IS ALWAYS KEPT — a card keeps at least one version.
• THIS BACKUP IS IN USE — a restore, a ZIP export, SAVE A COPY… or an open sample editor reads it; finish or close that first.
• THIS BACKUP HAS PENDING EDITS — apply or discard them first (man stage).
• A BACKUP OR RESTORE IS RUNNING — wait until it has finished (also while a backup waits for CONFIRM or counts down).
• THIS VOLUME HAS NO TRASH — e.g. some network drives; nothing is deleted.

Still stuck

Still stuck? Use Help › "Report a Problem…" (man updates) and describe what happened in your own words.

Erste Schritte

man start · Voraussetzungen, erster Start, dein M8 verbinden und den Backup-Ordner wählen

Voraussetzungen

• Ein Mac mit Apple Silicon und macOS 14 oder neuer.
• Dein Dirtywave M8, per USB verbunden und im USB-Laufwerksmodus.
• Das war's schon. M8Thor bringt sein eigenes rsync und eigene Player für Chiptunes mit, du musst also nichts weiter installieren.

Erster Start

Beim allerersten Öffnen führt dich eine kurze Einrichtung durch vier Schritte: WELCOME, FOLDER, NOTIFICATIONS, CONNECT.

• FOLDER: Hier siehst du deinen Backup-Ordner mit freiem Speicher und einem Badge INTERNAL DISK oder EXTERNAL DRIVE. Lieber ein anderer? Mit CHOOSE FOLDER… wählst du ihn. Wählst du keinen, landen deine Backups in ~/Backups. Ein Tipp von mir: Auf einem externen Laufwerk sind deine Backups auch dann sicher, wenn dein Mac ausfällt.
• NOTIFICATIONS: ALLOW NOTIFICATIONS fragt macOS um Erlaubnis. Hast du früher schon mal Nein gesagt, bringt dich OPEN NOTIFICATION SETTINGS direkt zu den Systemeinstellungen.
• CONNECT: Verbinde dein M8 per USB im USB-Laufwerksmodus oder steck seine SD-Karte in einen Kartenleser. Sobald die Karte eingebunden ist, zeigt der Schritt M8 DETECTED · <NAME>. Unter NAME THIS CARD gibst du ihr einen Namen mit bis zu 24 Zeichen, und der steht dann überall, wo die Karte auftaucht: in Backup, Browse, HISTORY und der Menüleiste. SAVE behält ihn, SKIP lässt die Karte ohne Namen. Keine Sorge, die Karte selbst bleibt unverändert. Hier kannst du auch „Back up when connected“ einschalten (Auto-Backup, siehe man backup).
• NEXT → (oder Return) geht weiter, ← BACK zurück, SKIP SETUP beendet die Einrichtung, und FINISH im letzten Schritt speichert deine Wahl. Die Einrichtung siehst du nur dieses eine Mal.
• War schon ein Backup-Ordner gesetzt oder liegen Backups darin? Dann lässt M8Thor die Einrichtung einfach weg.

Das Hauptfenster

• Die Titelleiste hat fünf Tabs: BACKUP, RESTORE, BROWSE, REMOTE, SETTINGS (⌘1 bis ⌘5). Ist der Sample-Editor offen, steht EDITOR · <DATEI> daneben und holt ihn nach vorn.
• Achte auf die kleinen Punkte. Ein Punkt auf RESTORE heißt: Bearbeitungen sind vorgemerkt und warten aufs Übertragen. Ein Punkt auf BACKUP heißt: Eine verbundene Karte hat Änderungen oder noch kein Backup.
• M8Thor läuft immer nur einmal. Öffnest du es erneut, kommt die laufende Kopie einfach nach vorn.

Wie die Karte erkannt wird

• Du musst nichts tun: M8Thor durchsucht eingebundene Volumes automatisch, sobald eines ein- oder ausgehängt wird. Willst du selbst noch mal suchen lassen, drück ⌘R oder SCAN NOW.
• Ein Volume gilt als M8-Karte, wenn es System/STARTUP.m8s hat oder im Stamm die Ordner Songs und Instruments.
• Du hast noch anderes Gear? Mit SETTINGS › Advanced › „Recognize other SD cards“ kannst du auch SD-Karten und USB-Laufwerke anderer Geräte sichern (Badge OTHER CARD). Siehe man backup.

Deine Karte sichern

man backup · Sehen, was sich geändert hat, bestätigen und einen geprüften, platzsparenden Schnappschuss bekommen

Die Kartenansicht

Sobald deine M8-Karte eingebunden ist, zeigt dir der Tab BACKUP alles Wichtige auf einen Blick:

• ihren Namen (über den Stift benennst du die Karte, bis zu 24 Zeichen; der Volume-Name steht dann darunter) und ein Status-Badge wie CONNECTED • READY, CONNECTED • NO BACKUP YET oder CONNECTED • 12 CHANGES FOUND,
• UUID, MOUNT, SIZE, FOLDER, CONTENTS (Anzahl Songs, Instrumente, Samples…), die NOTE deines letzten Backups, falls du eine geschrieben hast (Notizen: man restore), und FIRMWARE, sobald M8Thor dein M8 kennt (man firmware),
• eine Seitenleiste mit NEXT BACKUP, STATUS, SINCE LAST, ESTIMATE (FULL) (grobe Zeitschätzung), DESTINATION, KEEP und RECENT (Größen-Balken und deine letzten fünf Backups).
• STATUS vergleicht die Karte mit deinem letzten Backup nach Dateigröße und Datum. Listet er Änderungen, öffnet SHOW CHANGES ein Fenster mit genau den Dateien, die abweichen.
• Mehrere Karten verbunden? Dann steht oben eine Reihe davon, jede mit Namen, einem Badge M8 oder OTHER CARD und einem Statuspunkt. M8-Karten kommen zuerst; ein Klick zeigt die Karte.
• Eine Karte ohne Backup und ohne Namen begrüßt dich mit NEW CARD FOUND — NAME IT: Namen eintippen und SAVE, oder LATER. Der Name steht überall, wo die Karte auftaucht: in Backup, Browse, HISTORY und der Menüleiste. Der Hinweis hält nichts auf; Countdown, Backup und EJECT laufen weiter, während er da ist.

Ein Backup starten

1. Drück START BACKUP (erstes Backup) oder RUN BACKUP.
2. Die Bestätigung zeigt Backup to <folder>/<set>? und eine Vorschau: N new, N modified, N deleted (aufgeklappt pro Ordner) oder „No changes detected“.
3. Optional, sobald ein früheres Backup existiert: Klapp FOLDERS auf und wähl, was gesichert wird (ALL / NONE). System und Themes sind immer dabei. Schalte Songs aus, um einzelne Songs zu wählen; deren Samples kommen automatisch mit. Ausgelassene Ordner behalten den Stand des vorigen Backups, jede Version bleibt also vollständig.
4. Optional: CHANGE DESTINATION… schreibt nur dieses Backup als eigenständige Vollkopie in einen anderen Ordner, z. B. auf ein externes Laufwerk (Badge FULL · EXTERNAL). USE DEFAULT macht das rückgängig. Es ist keine dauerhafte Einstellung.
5. Drück CONFIRM. CANCEL geht zurück.

Während es läuft, siehst du BACKING UP, die verstrichene Zeit, N FILES LEFT, einen Fortschrittsbalken und ein Log. „READING CARD…“ heißt nur, dass rsync Dateien prüft, die es nicht kopieren muss. CANCEL bricht ab, und ein unfertiges Backup wird nie veröffentlicht, in deiner Historie landet also nichts Halbes. Brauchst du deinen Bildschirm zurück? Der Knopf neben CANCEL (⇧⌘M) verkleinert das Fenster zu einem schmalen Fortschrittsstreifen, EXPAND holt es wieder zurück.

Ist es fertig, bekommst du „Backup successful (…)“ mit CLOSE und EJECT, oder einen Fehler mit RETRY, REPORT PROBLEM und EJECT.

Was du bekommst

• Jedes Backup ist ein vollständiger Schnappschuss. Unveränderte Dateien sind per Hardlink mit dem vorigen Backup verbunden und belegen keinen zusätzlichen Platz. Jede Version ist komplett, und deine Platte bleibt entspannt.
• Gibt es ein früheres Backup, werden die Dateien beim Kopieren per Prüfsumme verglichen.
• „Verify with checksums“ (standardmäßig aus) vergleicht die kopierten Dateien nach dem Backup noch einmal.
• „Rotate old backups“ (standardmäßig an) behält die neuesten N Schnappschüsse pro Karte (1–30, Standard 5) und löscht ältere. Hat das neue Backup viel weniger Dateien als das vorige, bleiben ältere erhalten und du bekommst eine Warnung, die Karte zu prüfen.
• „Eject on completion“ wirft die Karte nach einem erfolgreichen Backup aus.

Diese Schalter findest du unter der Karte, solange nichts läuft; es sind dieselben Einstellungen wie in man settings.

Andere SD-Karten

Dein M8 ist nicht die einzige Kiste mit SD-Karte? Schalte SETTINGS › Advanced › „Recognize other SD cards“ ein und sichere SD-Karten und USB-Laufwerke anderer Geräte genauso: Versionen, Rotation, Prüfsummen, Browse, Restore. Ein paar Dinge gibt es aber nur beim M8:

• FOLDERS und einzelne Songs: Eine OTHER CARD wird immer ganz gesichert,
• Auto-Backup beim Verbinden und automatisches Auswerfen (es könnte das ganze Gerät mitnehmen),
• in Browse Song-Details, USED IN und den Filter UNUSED sowie das Vormerken bearbeiteter Samples für die Karte.

Auto-Backup

Ist „Back up when connected“ an, startet das Verbinden einer M8-Karte bei laufendem M8Thor einen Countdown („Auto-backup starting in 5s…“) mit CANCEL-Knopf und sichert dann die ganze Karte ohne Bestätigung. Einstecken, zurücklehnen.

Nach dem Backup

• Ein Ton spielt und eine Mitteilung („Backup Complete“ / „Backup Failed“) erscheint, falls du sie eingeschaltet hast.
• HISTORY öffnet den Backup-Ordner der Karte im Finder. EJECT (oder ⌘E, Eject All) wirft die M8-Karten aus.

M8-Firmware

man firmware · Neue Firmware für dein M8: M8Thor findet sie, lädt sie bei Dirtywave und kopiert sie auf die Karte

Schluss mit der Suche nach der richtigen Firmware-Datei: M8Thor bringt neue Firmware von Dirtywave direkt auf die Karte deines M8. Die Firmware gehört natürlich Dirtywave. M8Thor lädt sie erst von Dirtywaves GitHub, wenn du Dirtywaves EULA akzeptiert hast, und verändert sie nie.

Woher M8Thor dein M8 kennt

• Damit du die richtige Datei bekommst, braucht M8Thor Modell und Firmware-Version deines M8. Es fragt das M8, wenn es per USB im normalen Modus verbunden ist (nicht im USB-Laufwerksmodus), und nie, während seine Karte in Gebrauch ist. Darum kümmert sich SETTINGS › Advanced › „Identify M8 when connected“ (standardmäßig an); auch REMOTE erfährt es beim Verbinden (man remote).
• Kennt M8Thor ein M8, fragt es einmal täglich bei Dirtywaves GitHub (github.com/Dirtywave/M8Firmware) nach einer neuen Version. Nichts über dich oder dein M8 wird gesendet. Willst du das nicht, schaltet SETTINGS › Updates › „Check for M8 firmware“ es aus (standardmäßig an).
• Die BACKUP-Karte zeigt dann FIRMWARE: was dein M8 meldet und die neueste Version (LATEST), oder LAST CHECK FAILED. GET dort holt eine Version, die kein Hinweis anbietet, z. B. einen neuen Buchstaben derselben Version (DISMISS blendet ihn aus) oder eine, die du mit NOT NOW verschoben hast.

Update über die Karte

1. Schalte das M8 in den USB-Laufwerksmodus. Auf seiner eigenen Karte zeigt der Tab BACKUP FIRMWARE <VERSION> FOR MODEL:0N mit GET FIRMWARE. NOT NOW blendet das Angebot für diese Version aus.
2. GET FIRMWARE zeigt beim ersten Mal und immer, wenn sich ihr Text ändert, Dirtywaves EULA (DIRTYWAVE M8 FIRMWARE · EULA). ACCEPT lädt die Firmware, DECLINE bricht ab.
3. COPY TO CARD legt die Datei für dein Modell ins Stammverzeichnis der Karte. Hat die Karte Änderungen, die noch nicht gesichert sind, macht BACK UP FIRST vorher ein Backup. Solange ein Backup oder Restore die Karte belegt, wartet das Kopieren.
4. Dann folgst du den angezeigten Schritten: Projekt speichern, EJECT CARD und am M8 USB-DRIVE verlassen, PROJECT > SYSTEM SETTINGS > FIRMWARE UPDATE, die Datei wählen und bestätigen. Die Karte nicht herausnehmen. Schlägt es fehl, mach das Update per USB.

Gut zu wissen

• Ein M8 mit einer Firmware vor 6.6.0 kann nicht über die Karte updaten. Du siehst dann FIRMWARE <VERSION> NEEDS 6.6 OR NEWER ON THE M8, und USB INSTRUCTIONS öffnet Dirtywaves Seite zum Update per USB.
• NEW FIRMWARE FOUND — MODEL NOT VERIFIED heißt: M8Thor weiß noch nicht, zu welchem M8 diese Karte gehört. Verlass den USB-Laufwerksmodus einmal, damit es das M8 fragen kann (oder schalte „Identify M8 when connected“ ein).
• Auf deiner Karte wird nichts ersetzt. Liegt dort eine andere Datei mit diesem Namen: ANOTHER <FILE> IS ON THE CARD — NOTHING WAS CHANGED. Ist es dieselbe Datei: <FILE> IS ALREADY ON THE CARD.
• Mit Auto-Eject lässt ein Backup dieser Karte sie einmal eingebunden, damit die Firmware noch kopiert werden kann: BACKUP DONE — COPY FIRMWARE? THE CARD WAS NOT EJECTED FOR IT.
• Läuft auf deinem M8 die neue Firmware, bietet M8Thor an aufzuräumen und die Datei wieder von der Karte zu nehmen: REMOVE oder KEEP. Später tut REMOVE FILE in der Zeile FIRMWARE dasselbe. Entfernt werden nur Dateien, die M8Thor dort abgelegt hat.

Ein Backup wiederherstellen

man restore · Assistent in fünf Schritten, der jede Backup-Version zurück auf eine SD-Karte schreibt

Deine Sachen zurückzuholen ist leicht, egal ob die ganze Karte oder nur ein paar Songs. Der Tab RESTORE führt dich in fünf Schritten hin: TARGET, SET, VERSION, SELECTION, CONFIRM. Nutz NEXT → und ← BACK unten, oder klick oben einen früheren Schritt an, um zurückzuspringen.

01 Target

Zuerst wählst du die Karte, auf die geschrieben wird. M8-Karten stehen oben, dann leere FAT32- oder exFAT-Karten (Badge NO M8 FILES). Das Volume, auf dem deine Backups liegen, wird nie angeboten, du kannst also nicht aus Versehen auf deine eigenen Backups schreiben. Jede Karte zeigt SIZE, FREE und FS. Keine Karte da? Verbinde dein M8 im USB-Laufwerksmodus oder steck eine SD-Karte ein, dann REFRESH.

02 Set

Als Nächstes wählst du ein Backup-Set (eines pro Quellkarte). Badges helfen dir, das richtige zu finden: MATCH (das Set gehört zur gewählten Karte), BACKUP IN PROGRESS, N PENDING (vorgemerkte Bearbeitungen, mit einem Knopf APPLY N). Ein Set mit „NO COMPLETED BACKUP YET“ lässt sich nicht wählen.

03 Version

Jetzt wählst du einen Schnappschuss. Der neueste heißt LATEST, und jeder zeigt Datum, Größe und Notiz. Für jede Version hast du ein paar praktische Knöpfe:

• Notiz-Knopf („Add note“ / „Edit note“): eine BACKUP NOTE schreiben, ändern oder löschen. Dein zukünftiges Ich freut sich über eine Zeile wie „vor dem großen Remix“.
• Browse-Knopf („Browse backup contents“): öffnet BROWSE BACKUP. Klick Dateien für Details an (Song-Tempo, Instrumente, Samples; Audio abspielen), zeig sie im Finder, zieh sie heraus oder kopier eine Datei oder einen Ordner auf die gewählte Karte. Esc schließt.
• Knopf „Export as ZIP“: exportiert die Version als .zip mit Fortschritt.
• COMPARE (ab zwei Versionen): VERSION A (BASE) und VERSION B (COMPARED) wählen und hinzugefügte, geänderte und gelöschte Dateien sehen.
• Papierkorb-Knopf (neben Notiz, Browse und ZIP): legt die Version in den Papierkorb, siehe „Eine Version in den Papierkorb legen“ unten.

04 Selection

• Full Backup: stellt alle Ordner und Dateien der Version wieder her.
• Folders: Stammordner an- oder abwählen (ALL / NONE). Schalte einen Ordner aus und öffne sein Dreieck, um Unterordner oder Dateien zu wählen. Für Songs: Full Folder oder Single Songs. Ist Samples nicht gewählt, kommen die Samples der gewählten Songs automatisch mit, damit deine Songs nicht stumm zurückkommen.

05 Confirm

Ein letzter Blick, bevor etwas geschrieben wird: Prüf SOURCE BACKUP, TARGET DEVICE, MODE, VERSION, SELECTION, SONGS, AUTO SAMPLES und NOTE.

• Nur Dateien, die ÄLTER als im Backup sind, werden überschrieben. Neuere Dateien auf der Karte bleiben, und Dateien, die nicht im Backup sind, bleiben auf der Karte. Nichts wird gelöscht.
• PREVIEW listet vorher die abweichenden Dateien.
• ▶ START RESTORE startet. RESTORING… zeigt ein Log und CANCEL.
• Ergebnis: RESTORE COMPLETE oder RESTORE FAILED mit Grund, und die Dateien, die blieben, weil die Kopie auf der Karte neuer ist. CLOSE oder EJECT.

Sicherheit

• Ein Vorgang pro Karte: Ein Restore startet nicht, während auf der Karte ein Backup läuft.
• Die Karte wird vor und nach dem Restore geprüft; wurde sie abgezogen, erfährst du, dass sie teilweise wiederhergestellt sein kann.
• Vorgemerkte Sample-Bearbeitungen werden ebenfalls hier übertragen, siehe man stage.

Eine Version in den Papierkorb legen

Wird der Platz knapp? Der Papierkorb-Knopf in 03 VERSION (oder in BROWSE: Rechtsklick auf eine Version in der Seitenleiste › MOVE TO TRASH…) öffnet ein Fenster, das dir sagt, wie viel Platz frei wird:

• „Frees about <size> when you empty the Trash.“ Unveränderte Dateien teilen sich die Versionen per Hardlink; eine Version gibt daher oft viel weniger frei, als sie groß ist. Auf Laufwerken ohne Hardlinks, z. B. exFAT, gibt sie ihre volle Größe frei.
• „Frees almost nothing — its files are shared with other backups.“

„You can put it back from the Trash.“ MOVE TO TRASH legt sie hinein. Geht das nicht, sagt dir der Knopf, warum:

• THE LAST BACKUP OF A CARD IS ALWAYS KEPT
• THIS BACKUP IS IN USE — ein Restore, ein ZIP-Export, SAVE A COPY… oder ein offener Sample-Editor liest es.
• THIS BACKUP HAS PENDING EDITS
• A BACKUP OR RESTORE IS RUNNING — auch während ein Backup auf CONFIRM wartet oder herunterzählt.
• THIS VOLUME HAS NO TRASH — z. B. manche Netzlaufwerke; nichts wird gelöscht.

Die Rotation löscht die ältesten Versionen weiterhin endgültig, wie bisher (man settings).

Backups durchsehen

man browse · In jede Backup-Version oder jeden Mac-Ordner schauen: mit den Tasten bewegen, vorhören, suchen, sehen, wo Samples verwendet werden

Aufbau

• Oben links SETS: deine eigenen Sammlungen von Samples aus jeder Karte und jedem Mac-Ordner, siehe man sets.
• Darunter BACKUP SETS: eines pro Karte, jedes unter ihrem Namen. Klappst du eines auf, siehst du seine Versionen (Datum und Uhrzeit, die neueste heißt LATEST). Ein Set mit vorgemerkten Bearbeitungen zeigt einen Punkt mit der Anzahl und eine Zeile PENDING (N) (siehe man stage). Zeit zum Aufräumen? Rechtsklick auf eine Version › MOVE TO TRASH… legt sie in den Papierkorb (man restore).
• Darunter MAC FOLDERS: die Ordner auf deinem Mac, die du zum Durchsehen hinzugefügt hast, siehe man mac.
• In der Mitte die Dateiliste (NAME, SIZE, MODIFIED), mit Symbol und Typ für jede Datei. Darüber steht der Pfad des Ordners, in dem du gerade bist; er kürzt sich auf das, was passt. .. bringt dich eine Ebene nach oben.
• Rechts eine Vorschau der gewählten Datei.
• Der Bereich ohne die Tasten dimmt seine Auswahl, so weißt du immer, wohin deine Tasten gehen.

Tasten und Cursor

Die Liste hat eine Markierung, den Cursor. Er ist die Auswahl, und die Vorschau zeigt immer die Zeile, auf der er steht. Die Liste scrollt mit, du verlierst ihn also nie aus den Augen.

• In BACKUP SETS: ↑ ↓ wählen eine Version, Return oder → bringen dich in ihre Dateien.
• In der Liste: ↑ ↓ bewegen den Cursor. → öffnet einen Ordner, ein Archiv (man archives) oder ein Modul (man chips); auf einem Sample öffnet es den Sample-Editor, genau wie EDIT. ← verlässt den Ordner; ganz oben in einer Version geht es zurück zu den Versionen.
• Return öffnet die Zeile wie ein Klick. Die Leertaste spielt oder stoppt das Sample oder den Chip-Tune unter dem Cursor. Esc stoppt und schaltet AUDITION aus.
• Ein Doppelklick öffnet ein Archiv oder ein Modul, wie →.
• F legt die Datei unter dem Cursor ins TARGET-Set (man sets).
• Ein Klick auf eine Zeile gibt ihr den Cursor und die Tasten.

AUDITION und LOOP

• AUDITION ist wie gemacht zum Stöbern: solange es an ist, spielen ↑ ↓ jedes Sample und jeden Chip-Tune, auf dem sie landen; auf anderen Zeilen verstummt der Ton. Startest du ein Sample aus der Liste (sein ▶ oder die Leertaste), schaltet es sich ein, und ausschalten stoppt den Ton.
• LOOP neben AUDITION: jedes Sample und jeder Tune, den du in Browse hörst, wiederholt sich, bis du stoppst, und der nächste auch. Schaltest du um, während etwas spielt, wirkt es sofort.
• Beides bleibt für die ganze Sitzung so, wie du es eingestellt hast, über Ordner und Versionen hinweg.
• Öffnest du den Sample-Editor, verstummt, was Browse gerade spielt.

Suche

• Irgendwo ein Sample verloren? ⌘F setzt den Fokus ins Suchfeld (SEARCH THIS BACKUP, in einem Ordner SEARCH THIS FOLDER; umschalten zwischen THIS FOLDER und WHOLE BACKUP).
• Das Filtermenü: ALL, SONGS, INSTRUMENTS, SAMPLES, THEMES, SCALES, BUNDLES, RENDERS, UNUSED, OTHER, HISTORY (Version einer anderen Karte: ALL, SAMPLES, OTHER, HISTORY). Ein Filter wirkt auch ohne Suchbegriff, du kannst dir also zum Beispiel einfach alle SONGS anzeigen lassen.
• UNUSED listet die Samples, die kein Song und kein gespeichertes Instrument dieser Version verwendet. Es wartet, bis jeder Song gelesen ist (INDEXING REFERENCES…), und rät deshalb nie.
• HISTORY listet jedes Sample mit gespeicherter Bearbeitung, von jeder Karte und aus jedem Mac-Ordner, das neueste zuerst. Jede Zeile sagt dir, woher sie kommt (Name der Karte und Tag des Backups), und spielt, öffnet und merkt direkt dort vor. SEARCH HISTORY grenzt nach Namen ein.
• Audio-Treffer zeigen USED IN … oder UNUSED, und der Tooltip einer Zeile nennt Karte und Backup, aus denen sie stammt. Return auf einem Treffer springt direkt hin.
• Die Suche schaut nicht in Archive oder Module.

Vorschauen

• SONG (.m8s): BPM, INSTRUMENTS, SAMPLES, SIZE, MODIFIED und die Sample-Liste des Songs (✓ vorhanden, ✗ fehlt in dieser Version). Spiel Samples aus der Liste ab oder klick eines an, um seine Vorschau zu sehen (← BACK TO <SONG>). ↓ RESTORE TO <CARD> kopiert nur die Song-Datei auf dein verbundenes M8 und überschreibt eine gleichnamige; die Samples werden nicht kopiert.
• SAMPLE (wav, aif, aiff, mp3, flac, ogg, m4a, caf): Wellenform, ▶ PLAY, EDIT, FORMAT, SAMPLE RATE, BIT DEPTH, CHANNELS, DURATION (ab einer Minute in Minuten und Sekunden, z. B. 37:38.84), SIZE, MODIFIED und USED IN: die Songs und Instrumente, die es verwenden. Ein Klick auf die Wellenform oder EDIT öffnet den Sample-Editor (man editor). Ein Badge EDITED heißt, der Editor hat gespeicherte Einstellungen für dieses Sample; die Datei selbst bleibt unverändert. BACKUP AFFECTED SONGS kopiert die Songs, die dieses Sample verwenden, in einen neuen Ordner auf deinem Schreibtisch.
• MODULE, SID TUNE, TFMX TUNE: siehe man chips. ZIP ARCHIVE, LHA ARCHIVE, AMIGA DISK: siehe man archives.
• Andere Dateien: KIND, SIZE, MODIFIED.
• SAVE A COPY… speichert jede Datei an einen beliebigen Ort außerhalb deines Backup-Ordners.

Durchsehen ändert nie ein Backup oder einen Mac-Ordner, schau dich also ruhig um, so viel du willst.

Chip-Tunes

man chips · Tracker-Module, C64-SID- und Amiga-TFMX-Tunes: live abspielen, ihre Samples öffnen, einen Ausschnitt in den Editor rendern

Was spielt

• Tracker-Module: jedes Format, das libopenmpt liest — MOD, XM, S3M, IT, Future Composer, SoundFX, Soundtracker, ICE, 669, DigiBooster, Symphonie, OctaMED, Oktalyzer und mehr — auch wenn sie mit PowerPacker, XPK, MMCMP oder UMX gepackt sind. Ob song.fc oder auf Amiga-Art fc.song: M8Thor kennt beides (mod.name ist ein Modul).
• C64-SID-Tunes (.sid, PSID und RSID).
• Amiga-TFMX (Chris Hülsbeck) und Jochen-Hippel-Tunes: mdat.<name> mit seinem smpl.<name>, oder .mdat/.smpl, .tfx/.sam, smpl.set, .hip, .hipc, .hip7, .mcmd, .sog, .soc, .s7g. Mit PowerPacker gepackte Dateien entpackt M8Thor für dich in den Cache.

Live abspielen

• PLAY in der Vorschau, das ▶ einer Zeile oder die Leertaste spielen den ganzen Song live, sofort. Noch einmal drücken stoppt ihn. LOOP (man browse) wiederholt ihn.
• Mit AUDITION an spielen ↑ ↓ jeden Tune, auf dem sie landen. Eine schöne Art, durch eine große Sammlung zu stöbern.
• TUNE n/N eines SID-Tunes und SONG n/N eines TFMX-Tunes, in der Vorschau-Spalte, wählen, was PLAY spielt; wählst du einen neuen, wechselt er sofort.
• Die Vorschauen zeigen MODULE: TYPE, CHANNELS, LENGTH, SAMPLES, SIZE · SID TUNE: RELEASED, TUNES, CHIP, FORMAT, SIZE · TFMX TUNE: FORMAT, SONGS, VOICES, LENGTH, SAMPLES, SIZE.

Die Samples eines Moduls

Jetzt wird's schön: ein Modul öffnet sich wie ein Ordner (→, Return, Doppelklick oder OPEN SAMPLES) und zeigt dir seine Instrument-Samples als WAV-Dateien. Sie spielen, lassen sich vorhören und im Editor öffnen wie jedes andere Sample. STAGE FOR CARD merkt eines als FROM MODULE vor, und ADD TO CARD bringt sie auf die Karte (man mac). ← bringt dich zurück.

Einstellungen und OPEN IN EDITOR

Die Vorschau-Spalte eines Moduls, SID- oder TFMX-Tunes hält seine Einstellungen. Jede Änderung hörst du beim Abspielen sofort, und OPEN IN EDITOR rendert genau das Eingestellte in den Sample-Editor:

• PLAY / STOP, LOOP und eine Zeitleiste mit dem gewählten Bereich und dem Abspielkopf: ein Klick springt dorthin, die Ränder des Bereichs ziehen START und sein Ende, und Ziehen im Bereich verschiebt ihn als Ganzes.
• Regler START und LENGTH (LENGTH ist 30 s, bis du ihn stellst, höchstens 5 Minuten), WHOLE für den ganzen Song; bei einem Modul die CHANNELS, bei SID und TFMX die VOICES, bei SID der CHIP (AS TUNE, 6581, 8580). Kanäle und Stimmen, die du ausschaltest, sind stumm. Das Mausrad scrollt die Spalte; ⌥ + Mausrad dreht den Regler unter dem Zeiger.
• Stummschaltungen, START und LENGTH hörst du sofort; ein neuer SID-Chip oder Subtune und weite Sprünge brauchen erst ein kurzes SEEKING….
• Was du hörst, wird gerendert: OPEN IN EDITOR (RENDERING…, solange es arbeitet) schreibt es — Module und TFMX als 44,1 kHz Stereo, SID als 44,1 kHz Mono — und öffnet es im Editor. Ist dort schon ein anderes Sample offen, fragt M8Thor vorher (man editor).
• Das Ergebnis wird für das M8 als 44,1 kHz · 16 Bit vorgemerkt, mit dem Badge FROM MODULE, FROM SID oder FROM TFMX. Vom alten Demo-Tune zum frischen Sample, bereit für deine Karte, in ein paar Klicks.

Archive und Amiga-Disks

man archives · ZIP- und LHA/LZH-Archive und Amiga-Diskimages (ADF, ADZ, DMS) öffnen sich wie ein Ordner

Öffnen

• Ein altes Sample-Pack oder eine Amiga-Disk von damals gefunden? ZIP-Archive (.zip), LHA-Archive (.lha, .lzh) und Amiga-Diskimages (.adf, gzip-gepackte .adz und DMS, .dms) öffnen sich wie ein Ordner: →, Return, Doppelklick oder OPEN in der Vorschau. ← verlässt sie. Die Vorschau nennt sie ZIP ARCHIVE, LHA ARCHIVE oder AMIGA DISK.
• Sie werden einmal in den Cache von M8Thor entpackt (~/Library/Caches/M8Thor/Archives, bis 2 GB, die ältesten gehen zuerst). Das Archiv selbst wird nur gelesen; daneben wird nichts geschrieben. LHA- und DMS-Dateien entpackt ein eigener Hilfsprozess, eine kaputte Datei kann also nur dieses eine Entpacken scheitern lassen.
• Darin spielen Module, SID-Tunes und WAVs, lassen sich vorhören und öffnen (auch die Samples eines Moduls), OPEN IN EDITOR funktioniert, und EDIT merkt ein Sample als FROM ZIP, FROM LHA, FROM ADF (ein ADZ zählt als ADF) oder FROM DMS vor.
• ADD TO CARD legt die Dateien in einen Ordner mit dem Namen des Archivs: Packs/drums.zip → Packs/drums/…. Genauso bei den Samples eines geöffneten Moduls.

Grenzen

• Amiga-Disks: AmigaDOS-Disks (OFS und FFS). Eine Demo- oder Spiele-Disk ohne Dateien zeigt trotzdem die Module, die ungepackt darauf liegen, benannt nach dem Modul oder RIPPED n.mod; ohne solche sagt sie NO FILES ON THIS DISK — A DEMO OR GAME KEEPS ITS MUSIC PACKED INSIDE. Disks mit langen Dateinamen (DOS\6, DOS\7) werden nicht unterstützt.
• DMS: M8Thor entpackt die Disk darin und liest sie wie ein ADF; auch passwortgeschützte DMS-Dateien werden entschlüsselt. Ein DMS ohne Amiga-Disk (MS-DOS oder FMS) zeigt THIS DMS HOLDS NO AMIGA DISK, ein kaputtes THIS DMS IS DAMAGED.
• ZIP: ungepackte und mit Deflate gepackte Dateien. Verschlüsselte Dateien, andere Packverfahren und Links werden übersprungen und gezählt (z. B. 2 FILES SKIPPED: ENCRYPTED). ZIP64 und geteilte ZIPs werden nicht unterstützt.
• LHA/LZH: auch hier werden Dateien mit einem Packverfahren, das M8Thor nicht entpacken kann, und Links übersprungen und gezählt (z. B. 1 FILE SKIPPED: UNSUPPORTED METHOD). LZX-Archive werden nicht unterstützt.
• Höchstens 1 GB und 10 000 Dateien pro Archiv.
• Die Suche schaut nicht in Archive.

Mac-Ordner

man mac · Ordner auf deinem Mac durchsehen und ihre Samples auf die Karte bringen

Einen Ordner hinzufügen

• Deine Samples liegen überall verstreut? In BROWSE wählt ADD MAC FOLDER… unter MAC FOLDERS einen Ordner auf deinem Mac. Du siehst ihn Ebene für Ebene durch, genau wie eine Backup-Version, mit denselben Tasten, Vorschauen, AUDITION und LOOP.
• M8Thor liest diese Ordner nur. Ein umbenannter oder verschobener Ordner wird wiedergefunden; einer, den es nicht mehr gibt, zeigt NOT FOUND. Rechtsklick › REMOVE FOLDER nimmt ihn von der Liste, und der Ordner selbst bleibt, wo er ist.

Auf die Karte

• EDIT auf einem Sample, dann STAGE FOR CARD: daraus wird eine neue Datei auf der Karte, mit dem Badge FROM MAC FOLDER. Die Mac-Datei bleibt unverändert.
• ADD TO CARD… (Rechtsklick auf Dateien oder Ordner): wähl den FOLDER ON THE CARD; Dateien behalten ihre Ordner darunter, und Namen, die die Karte nicht mag, werden bereinigt. Das Fenster zeigt FILES, SIZE, COPIED AS THEY ARE, CONVERTED, STAGED SIZE und FREE ON BACKUP DRIVE. ADD N FILES merkt sie vor, höchstens 200 Dateien auf einmal.
• Alles Vorgemerkte wird für das M8 als WAV mit 44,1 kHz · 16 Bit geschrieben. Ein WAV, das genau das schon ist, wird Byte für Byte kopiert; andere Dateien werden umgewandelt, samt ihren Cue-Markern. Um Formate musst du dir keine Gedanken machen.
• Vorgemerkte Dateien überschreiben nie etwas: sie warten beim Set, in dem du geblättert hast, und du überträgst sie über PENDING, wenn die Karte verbunden ist (man stage).

Sets

man sets · Samples von jeder Karte und aus jedem Mac-Ordner sammeln und ein ganzes Set für eine Karte vormerken

Beim Stöbern durch deine Samples findest du Sounds, die zusammengehören. Ein Set sammelt sie, aus jedem Backup und jedem Mac-Ordner. Es hält Verweise, nie Kopien: die Dateien bleiben, wo sie sind. SETS stehen oben in der Seitenleiste von BROWSE, über BACKUP SETS.

Ein Set anlegen und füllen

• NEW SET… neben SETS legt ein neues Set mit Namen an. Rechtsklick auf ein Set bietet NEW SUBSET… (bis zu drei Ebenen tief), RENAME… und DELETE SET…; Löschen entfernt nur die Verweise des Sets, nie deine Dateien.
• Ein Set ist das TARGET, markiert mit einem Punkt. F legt die Datei unter dem Cursor hinein, auch während AUDITION durch einen Ordner läuft, so sammelst du so schnell, wie du hörst. Rechtsklick auf ein anderes Set › MAKE TARGET wechselt es. Gibt es noch keins, wird ein neues Set das TARGET.
• Rechtsklick auf eine Datei oder ihre Vorschau › ADD TO SET legt sie in ein beliebiges Set; das Menü bietet auch NEW SET…, das ein neues Set anlegt und die Datei hineinlegt. Unten bestätigt ein Hinweis ADDED TO <SET> oder ALREADY IN <SET>.
• Im Sample-Editor legt ADD TO SET neben STAGE FOR CARD das Sample, das du gerade bearbeitest, in ein Set oder in ein NEW SET…. Das Set bekommt die ganze Datei, ihre Slices darin als Cue-Marker, damit das M8 sie als Slices spielen kann; die gespeicherte Bearbeitung kommt mit, wenn das Set vorgemerkt wird.
• Eine Datei aus einem Archiv oder Modul liegt im Cache von M8Thor: erst SAVE A COPY FIRST, dann die Kopie hinzufügen.

Ein Set in der Liste

• Ein Klick öffnet das Set: seine Dateien, jede mit ihrer Herkunft (Name der Karte und Tag des Backups, MAC · <ORDNER>) oder EDITED für ein Sample mit gespeicherter Bearbeitung, sortiert nach NAME oder ADDED. INCLUDE SUBSETS zeigt auch die Dateien aller Sets darunter.
• Sie spielen, lassen sich vorhören, loopen und im Editor öffnen wie überall sonst in Browse (→ öffnet den Editor). Return zeigt die Datei in ihrem Ordner. ⌫ oder Rechtsklick › REMOVE FROM SET nimmt den Verweis heraus, und UNDO holt ihn zurück; die Datei bleibt, wo sie ist.
• Eine Datei, die nicht mehr dort liegt, wo das Set sie erwartet, ist abgeblendet und spielt nicht.

STAGE SET FOR CARD

• Set fertig? STAGE SET FOR CARD… (im Kopf des Sets oder in seinem Rechtsklick-Menü) merkt jede Datei des Sets als neue Datei in einem Ordner auf einer Karte vor: wähl CARD und FOLDER ON THE CARD; INCLUDE SUBSETS nimmt die Dateien der Sets darunter mit.
• Bearbeitete Dateien werden mit ihrer gespeicherten Bearbeitung gerendert (EDITED), der Rest geht, wie er ist (AS IS). Alles wird als 44,1 kHz · 16 Bit geschrieben.
• Auf der Karte wird nichts ersetzt: ein belegter Name kommt unter den nächsten freien (NAME TAKEN → <NAME>), mit SKIP TAKEN NAMES bleibt die Datei weg. MISSING-Dateien werden übersprungen. FILE CHANGED heißt, die Datei hat sich geändert, seit ihre Bearbeitung gespeichert wurde: sie wird übersprungen, oder mit AS IS geht sie ohne die Bearbeitung.
• STAGE N merkt sie vor. Sie warten als vorgemerkte Bearbeitungen beim Set dieser Karte und werden wie alle anderen in RESTORE übertragen (man stage).

Sample-Editor

man editor · Ein Sample zuschneiden, faden, slicen, loopen und bearbeiten, ohne das Original anzufassen

Hier bekommen deine Samples ihren Feinschliff. Du öffnest den Editor in BROWSE: ein Sample wählen, dann auf die Wellenform oder EDIT klicken oder einfach → drücken. Chip-Tunes kommen über OPEN IN EDITOR herein (man chips). Der Editor hat sein eigenes Fenster: zieh es so groß, wie du magst, oder geh mit ⌃⌘F in den Vollbildmodus. M8THOR oben links holt das Hauptfenster nach vorn und lässt den Editor offen. Zurück zum Editor kommst du über EDITOR · <DATEI> in der Titelleiste des Hauptfensters, Window › Sample Editor oder ⌥⌘0. Öffnest du ein anderes Sample, während eines offen ist, fragt M8Thor vorher: SAMPLE EDITOR HAS <FILE> OPEN — OPEN <OTHER> INSTEAD? Deine Bearbeitung des offenen ist gespeichert; nur sein Rückgängig-Verlauf geht verloren.

Die goldene Regel

Der Editor ändert nie die Sample-Datei, das Backup oder einen Mac-Ordner. Deine Einstellungen werden pro Sample automatisch gespeichert und kommen beim erneuten Öffnen zurück (Badge SAVED EDIT; RESET ALL verwirft sie). Das Ergebnis bekommst du mit EXPORT… als WAV-Datei oder mit STAGE FOR CARD (man stage). Du kannst also nichts kaputt machen, oder?

Das Fenster

• Oben: M8THOR, der Name der Datei, SAVED EDIT und RESET ALL, wenn es eine gespeicherte Bearbeitung gibt, die Länge und CPU: wie viel von der Zeit jedes Audio-Blocks die Bearbeitung braucht (fahr mit der Maus darüber für die Spitze seit dem Abspielen). Ab 70 % und noch einmal ab 90 % wechselt die Farbe; bei 100 % setzt der Ton aus.
• Die Leiste mit den Seiten: TRIM › SLICE › LOOP › FX › OUTPUT, in der Reihenfolge, in der der Klang sie durchläuft (Tasten 1 bis 5), dann MIDI (das MIDI-Fenster), MIDI LEARN, Rückgängig, Wiederholen und der Zoom.
• Die Wellenform mit der Marker-Spur zeigt deine Bearbeitung selbst: NORMALIZE und IN, Slices und Fades. COMP, TAPE, OUT und der Limiter ändern das Bild nie; beim Abspielen hängt die Pegelreduktion von COMP von ihrer Oberkante. Links sitzt die Skala GAIN mit dem IN-Regler und NORM; rechts die Skala LEVEL mit dem Griff für den Anzeige-Zoom, dem OUT-Fader, der Pegelanzeige und LIMIT unter dem Fader.
• Unten: das Feld der Seite. Jede Seite ist gleich hoch, die Wellenform springt also nie herum. Zieh die Kante dazwischen, um die Wellenform höher oder flacher zu machen; ein Doppelklick setzt den Standard.
• Regler: nach oben oder unten ziehen (⌃ für feine Schritte), scrollen, oder mit den Pfeiltasten, wenn einer den Fokus hat; Doppelklick zum Eintippen eines Werts, ⌥-Klick setzt zurück. LED-Schalter leuchten, wenn sie an sind. Menüs (GRID, SIG, TARGET…) nehmen ↑ ↓, Return und Esc, und Tippen wählt aus.

Wellenform und Zoom

• Klick oder zieh auf der Wellenform oder der Spur, um den Abspielkopf zu setzen; ein Klick auf einen Slice spielt ihn dir vor. ⇧-Klick auf der Spur setzt die nähere Trim-Fahne dorthin. Die Knöpfe I und O und die Fahnen auf der Spur (Tasten I und O) setzen Trim-Anfang oder -Ende am Abspielkopf.
• Zieh vom Rand einer Region, um einen Fade aufzuziehen; zieh seine Kurve, um sie zu biegen.
• Zoom mit ⌘+ ⌘− ⌘0 oder Pinch. Ganz nah siehst du einzelne Samples als Punkte.
• Z zoomt auf den gewählten Slice oder auf den Trim; Z noch einmal bringt dich zur Ansicht davor zurück. Auf einen Slice gezoomt, gehen ← → zum nächsten Slice, und die Ansicht folgt.
• X zoomt auf 100 ms um den Griff oder Marker, den du zuletzt bewegt hast (oder den Abspielkopf); X noch einmal geht zurück. Ein Klick, Home, End, ← oder → geben X wieder den Abspielkopf. Ideal, um einen Schnitt genau zu setzen.
• Anzeige-Zoom: der Griff auf der Skala LEVEL zeichnet die Wellenform höher (bis 16×) oder flacher (bis 1/16×), stufenlos, 1× in der Mitte. ⌥-Scrollen über der Wellenform tut dasselbe; Doppelklick oder ⌥-Klick ist 1×. Nur das Bild ändert sich, nie der Klang.
• Ab einer Minute zeigt der Kopf Längen in Minuten und Sekunden, z. B. 37:38.84 OF 37:38.84. Rückgängig und Wiederholen: ⌘Z / ⇧⌘Z.

Signalweg und Pegel

Diesen Weg nimmt dein Klang: Slices → NORMALIZE → IN → FX → COMP → TAPE → OUT → LIMITER → DITHER auf 16 Bit.

• NORM, unter dem IN-Regler auf jeder Seite: NORMALIZE (Taste N) bringt die lauteste Spitze des Trims auf 0 dBFS, als Erstes in der Kette, vor IN und den FX. ⌥-Klick setzt es zurück.
• IN, der Regler auf der Skala GAIN: der Pegel des Samples in die FX (−24 bis +24 dB), zusätzlich zu NORMALIZE. Mit einem gewählten Slice stellt er dessen Gain; die Beschriftung zeigt IN oder SLICE n. Klick die Beschriftung (oder drück Esc), um zu IN zurückzugehen. ⌃-Ziehen für feine Schritte, ⌥-Klick setzt zurück.
• OUT, der Fader neben der Anzeige: der Pegel dessen, was auf die Karte geht, nach den FX, COMP und TAPE, vor dem Limiter. Ziehen (⌃ fein), Scrollen oder Pfeiltasten: 0,1 dB, mit ⇧ 1 dB; Doppelklick auf die Zahl zum Eintippen; ⌥-Klick setzt zurück. Du kannst ihn auch für MIDI lernen. OUT auf der Seite OUTPUT ist derselbe Pegel.
• LIMIT unter dem Fader öffnet das Feld des Limiters: LIMIT an oder aus, CEILING (−12 bis −0,1 dBFS, Standard −0,3), RELEASE (10 bis 500 ms, Standard 80; ganz oben ist AUTO) und GR, was der Limiter live wegnimmt. Auch den STYLE des Limiters (CLEAN, PUNCH oder LOUD) stellst du dort. ⌥ setzt CEILING und RELEASE zurück. Ein Klick daneben oder Esc schließt es.
• Die Pegelanzeige: L und R (Spitze und RMS über 300 ms) und LU, die Lautheit. Die Pegelreduktion von COMP und Limiter hängt in eigenen Spuren von oben, und mit LIMIT an liegt das Ceiling als Linie darüber. Darüber TP (True Peak links und rechts, das Höchste seit dem Abspielen; ein Klick beginnt neu) und RMS; darunter LUFS (integriert seit dem Abspielen) und DR (der höhere True Peak minus die Kurzzeit-Lautheit).

1 · TRIM

• Regler: TRIM START und END (⌥-Klick setzt sie auf die Enden der Datei zurück), FADE IN und FADE OUT, jeweils mit CURVE.
• REVERSE spielt das Sample rückwärts.
• SNAP TO ZERO (Taste S): Trim-Kanten und Slice-Marker landen auf dem nächsten Nulldurchgang innerhalb von 10 ms, damit deine Schnitte nicht knacken. Es ist derselbe Schalter wie auf SLICE.
• GRID: Takte und Schläge über der Wellenform, im Tempo von M8 LOOP, im erkannten (LOOP?) oder in dem, das BARS und SIG aus dem Trim machen. Ein Klick schaltet es ein oder aus; ⌥-Klick überlässt es wieder dem Tempo (auto). Das Menü daneben stellt die Dichte (AUTO folgt dem Zoom; BAR, BEAT und Notenwerte bis 1/64), CONTRAST, wie deutlich die Linien sind.

2 · SLICE

• Bis zu 128 Marker, genug auch für den wildesten Break. Werkzeuge: Select (Pfeil), Add markers (Stift), Remove markers (Radierer); CLEAR entfernt alle. M setzt einen Marker am Abspielkopf.
• MARKERS: EVEN + APPLY macht gleich lange Slices. THRESHOLD setzt einen Marker auf jeden Schlag, der die beiden Linien in der Wellenform erreicht; stell es tiefer, um leisere Schläge zu finden. Es ersetzt die Marker.
• Pro Slice: GAIN (±24 dB), REVERSE, NORMALIZE, RESET, FADE IN, FADE OUT.
• Ab drei Slices zeigt der Listen-Knopf die Regler aller Slices; mit AUDITION an spielen ↑ ↓ den Slice, auf dem sie landen.
• Rechtsklick auf einen Slice: PLAY SLICE, REVERSE, NORMALIZE SLICE, RESET GAIN, RESET FADES, ZOOM TO SLICE, EXPORT SLICE…, STAGE SLICE FOR CARD…, DELETE MARKER. Rechtsklick anderswo: ADD MARKER HERE.

3 · LOOP

• M8 LOOP schreibt Loop-Punkte für das zugeschnittene Sample in die Datei, damit dein M8 es im Sampler loopt. Einschalten loopt auch die Vorschau.
• Ein eigener Loop des Samples bleibt erhalten: das M8 spielt den Anfang einmal und wiederholt dann diesen Teil. CLEAR entfernt ihn; M8 LOOP ersetzt ihn durch einen Loop über das ganze Sample.
• TEMPO: BARS (1–64) und BPM zeigen das Tempo des Loops, so wie das M8 zählt. Dreh, tipp oder TAP ein Tempo, dann schneidet SET LENGTH den Loop darauf zu. SIG stellt die Taktart. Der Editor schlägt ein Tempo aus der Datei, dem Namen oder der Länge vor; LOOP? erscheint, wenn die Länge in ganze Takte passt.
• Mit M8 LOOP an: CLICK, ein Metronom in der Vorschau ab dem Loop-Anfang (keine Sorge, es wird nie exportiert), seine Lautstärke VOL und GRID.

4 · FX

• Hol dir bis zu vier Audio-Unit-Plugins von deinem Mac dazu, jedes in einer Zeile, in der Reihenfolge, in der der Klang sie durchläuft. ADD PLUGIN unter der letzten Zeile fügt eines hinzu: tippen zum Suchen oder nach Hersteller wählen. Der Plugin-Name einer Zeile öffnet das eigene Fenster des Plugins; der Pfeil daneben wählt ein anderes oder entfernt es. ON schaltet es (aus wird es umgangen); zieh den Griff einer Zeile, um die Reihenfolge zu ändern. TAIL in der Leiste mit den Seiten lässt Effekte über das Ende hinaus ausklingen; die Datei wird länger.
• Jede Zeile hat einen IN- und einen OUT-Punkt: grün, solange sie klingt, orange, wenn der Eingang über das TARGET der Zeile geht, rot bei Vollaussteuerung. Er bleibt bis 1,5 s nach dem letzten Übersteuern an; ein Klick löscht ihn.
• Jede Zeile hat auch ihre eigenen Pegel: IN (Pegel ins Plugin), TARGET (der Eingangspegel, bei dem das Plugin am besten arbeitet, pro Plugin gemerkt), TO TARGET (stellt IN so, dass die lauteste Spitze auf TARGET landet), OUT (Pegel aus dem Slot) und MATCH (stellt OUT so, dass der Slot den Pegel lässt, wie er ihn vorfand). TO TARGET und MATCH messen über den Trim, die Plugins davor eingeschlossen; noch ein Klick bricht ab. Schluss mit dem Pegel-Raten.
• FX n: NO SIGNAL heißt, im Trim war nichts zu messen. NOT ON THIS MAC: <PLUGIN> heißt, das Plugin ist nicht auf diesem Mac; Export und Vormerken stoppen, bis du es installierst oder den Slot entfernst.
• Solange ein Plugin-Fenster vorn ist, geht MIDI von jeder verbundenen Quelle an dieses Plugin, für dessen eigenes MIDI-Learn. Leertaste und Return spielen wie im Editor.

5 · OUTPUT

• Der letzte Schliff: ein Rack in der Reihenfolge, in der der Klang es durchläuft, COMP › TAPE › OUT › LIMITER › DITHER. Der Name eines Moduls ist sein Schalter; seine Einstellungen bleiben, solange es aus ist. ⌥-Klick setzt einen Regler zurück. Unter dem Rack liegt eine Anzeige von −48 bis 0 dB mit Spitzenhaltung, der GR von COMP und Limiter und CLIP: leuchtet, sobald Samples begrenzt werden mussten; ein Klick löscht es.
• COMP hat zwei Arten, umgeschaltet mit CLEAN | BUS neben seinem Namen. CLEAN: THR, RATIO, ATK, REL, KNEE und MAKEUP, darunter HPF (ein Hochpass im Sidechain, 30 bis 300 Hz, ganz unten ist OFF, damit der Bass ihn nicht pumpen lässt), MIX und HOLD. BUS, nach Art eines klassischen Konsolen-Bus-Kompressors, der Kleber für deinen Mix: dieselben Regler, aber RATIO geht in Stufen durch 1,5, 2, 4 oder 10, ATK durch 0,1, 0,3, 1, 3, 10 oder 30 ms und REL durch 100, 300, 600 ms oder 1,2 s, AUTO und FAST (AUTO FAST). Sein KNEE folgt der Ratio und zeigt BY RATIO.
• AUTO neben dem Namen von COMP lässt MAKEUP dem folgen, was COMP wegnimmt, pegelgleich, und MAKEUP zeigt, wo es gerade steht; Drehen an MAKEUP schaltet AUTO aus, ohne dass etwas springt. Beim Abspielen hängt die Pegelreduktion von COMP von der Oberkante der Wellenform.
• TAPE, eine Bandsättigung, hat CLEAN | LO-FI neben seinem Namen. Seine Regler: DRIVE (wie stark das Band angefahren wird; der Pegel am Ausgang bleibt), BIAS (die Vormagnetisierung des Bands, −6 bis +4 dB, Standard 0: darunter rauer und früher gesättigt, darüber sauberer und dunkler), TONE (dunkler oder heller) und MIX, darunter SPEED (7,5, 15 oder 30 ips, Standard 15; langsamer klingt wärmer). LO-FI ist zu schwach vormagnetisiertes Band mit mehr Dreck (BIAS stellt, wie viel) und bringt dazu WOW (das Leiern der Tonhöhe, Flutter inklusive), HISS und DROP (kurze Pegeleinbrüche), jedes auf 0, bis du es aufdrehst.
• In LO-FI laufen WOW und sein Flutter im Takt mit dem Loop deiner Bearbeitung (dem eigenen Loop des Samples oder, mit M8 LOOP an, dem ganzen Trim; LOOP PREVIEW zählt nicht), damit die Naht sauber bleibt. Ist der Loop dafür zu kurz, sagt TAPE WOW OFF — LOOP TOO SHORT, oder WOW + FLUTTER OFF — LOOP TOO SHORT, wenn selbst der Flutter nicht passt.
• OUT ist derselbe Pegel wie der Fader neben der Wellenform. LIMITER, ein True-Peak-Limiter (8-fach überabgetastet, 5 ms Vorausschau, die die Vorschau ausgleicht): CEIL und REL, dessen oberste Stellung AUTO ist, ein Release, das dem Material folgt; darunter STYLE: CLEAN (transparent), PUNCH (erhält die Attacks) oder LOUD (drückt am stärksten).
• DITHER ist derselbe Schalter wie SETTINGS › Advanced › „Dither 16-bit files“, standardmäßig an: es gilt für jedes Rendern und jeden Export in 16 Bit.

Abspielen und Ausgabe

• ▶ PLAY / ■ STOP, Leertaste, Return (das ganze Ergebnis ab Trim-Anfang). LOOP PREVIEW (oder L) loopt die Wiedergabe nur im Editor.
• Samples, deren Audio in 128 MB passt (etwa 5,5 Minuten 48 kHz Stereo, 11 in Mono), spielen über die Live-Engine: du hörst jede Änderung sofort. Längere spielen eine gerenderte Vorschau, die einer Änderung nach einem Neustart folgt; GR zeigt dann —.
• EXPORT… (⇧⌘E) schreibt ein WAV (Standardname <sample>-edit.wav). Es überschreibt nie das Original und schreibt nicht in deinen Backup-Ordner. Während ein Rendern oder Export läuft, zeigt die Fußleiste RENDERING und wie weit es ist.
• Die Ausgabe ist PCM-WAV in der Bittiefe der Quelle, wo möglich (sonst 16 Bit). 16-Bit-Dateien bekommen ein winziges Dither-Rauschen, damit leise Fades nicht verzerren (SETTINGS › Advanced › „Dither 16-bit files“). Slice-Marker werden als Cue-Punkte geschrieben, die dein M8 liest.
• STAGE FOR CARD (⌘Return) merkt das Ergebnis für die Karte vor. Alle Tasten: man keys, Controller: man midi.
• ADD TO SET neben STAGE FOR CARD legt das Sample in ein Set oder in ein NEW SET… (man sets). Das Set merkt sich die Originaldatei, und deine gespeicherte Bearbeitung wird gerendert, wenn das Set vorgemerkt wird (Slices reisen als Cue-Marker mit). Ein Render, ein Sample aus einem Modul oder eine Datei in einem Archiv kann nicht in ein Set: erst mit EXPORT… exportieren.

MIDI-Controller

man midi · Regler, Schalter und Aktionen eines MIDI-Controllers für den Sample-Editor lernen

Lernen

1. Schalte im Sample-Editor MIDI LEARN ein (der Knopf oder K).
2. Klick einen Regler oder Schalter im Editor an, oder eine Aktion im MIDI-Fenster.
3. Bewege ein Bedienelement oder drück einen Knopf an deinem Controller. Fertig: die Zuordnung ist gelernt.

• Echte Regler unter den Fingern fühlen sich einfach besser an als eine Maus, oder? Im Lernmodus wählt ein Klick nur aus und ändert nichts; wo sonst der Wert steht, siehst du, worauf das Element gelernt ist. ⌫ vergisst die gewählte Zuordnung, Esc beendet den Lernmodus. Tasten, die bearbeiten, tun solange nichts.
• Ein gelernter Regler trägt einen kleinen Punkt. Mit PICKUP zeigt eine Marke außerhalb seines Rings, wo der Controller steht, bis er den Wert aufgenommen hat.
• Fast jeder Regler und Schalter im Editor lässt sich lernen, die Umschalter auch: CLEAN | BUS von COMP, CLEAN | LO-FI von TAPE, SPEED und der STYLE des Limiters gehen pro Schritt eine Wahl weiter. Nicht lernbar sind unter anderem: TARGET, TO TARGET, MATCH, APPLY, TAP, SET LENGTH, SIG, DITHER, AUTO von COMP und die Einschalter von COMP und TAPE.
• Aktionen (ein Knopf oder Pad): Abspielen, Ergebnis abspielen, Neustart, voriger oder nächster Slice, Slice wählen, Marker setzen, Trim-Anfang oder -Ende, Zoom auf den Slice oder den zuletzt berührten Punkt, hinein-, herauszoomen oder zurücksetzen, die fünf Seiten, Rückgängig und Wiederholen.

Das MIDI-Fenster

MIDI in der Seitenleiste des Editors öffnet es: jede Zuordnung, die Liste ACTIONS und die Anzeige LAST MESSAGE, alles an einem Ort. Öffne eine Zuordnung für ihre Optionen; LEARN AGAIN und FORGET stehen in jeder Zeile.

• Regler: ENCODER (ABSOLUTE, RELATIVE · 2'S COMPLEMENT, RELATIVE · BINARY OFFSET, RELATIVE · SIGN MAGNITUDE), INVERT, TAKEOVER (PICKUP wartet, bis der Controller den Regler erreicht, JUMP bewegt ihn sofort), RANGE (welchen Teil des Reglers der Weg des Controllers abdeckt).
• Trim-Kanten und Fades haben dazu SCALE: ZOOM bewegt um ein 256stel dessen, was die Wellenform zeigt, feiner, je näher du zoomst; FIXED bewegt 10 ms pro Schritt (ein absoluter Regler deckt dann den ganzen Bereich ab). Ein absoluter Regler mit ZOOM bewegt um so viel, wie du drehst; am Anschlag dreh zurück oder zoom heraus.
• Schalter auf einem CC: MODE (TOGGLE folgt dem An und Aus des Knopfs, MOMENTARY schaltet bei jedem Druck um) und INVERT. Aktionen haben keine Optionen.

Settings › MIDI

• INPUT: die verbundenen DEVICES und LAST MESSAGES. Die Anzeige hört nur zu, solange die Seite offen ist.
• YOUR KNOBS › Detect a knob: drück DETECT KNOB, dann dreh einen Regler langsam nach rechts (TURN THE KNOB SLOWLY TO THE RIGHT…), dann nach links (NOW TO THE LEFT…). M8Thor zeigt, was er sendet, z. B. CC 21 · CH 1 — ENDLESS ENCODER · RELATIVE · BINARY OFFSET, und fragt, bevor es etwas ändert: YES, USE FOR NEW KNOBS oder, für einen Regler, der schon mit anderen Einstellungen gelernt ist, YES, CHANGE <REGLER>. Bei einem absoluten Regler schlägt es vor, ihn im Setup-Tool des Controllers auf relativ umzustellen. Kein Wühlen im Handbuch nötig.
• Defaults for new knobs: ENCODER, INVERT, SCALE und TAKEOVER, mit denen ein Regler beim ersten Lernen startet. Schalter und Noten behalten ihre eigenen; du kannst jede Zuordnung weiter ändern.
• MAPPINGS listet alles Gelernte, mit denselben Optionen wie das MIDI-Fenster. CLEAR ALL vergisst alle Zuordnungen; die Standards bleiben.

Regler und Encoder: deinen Controller einrichten

Du weißt nicht, was dein Controller sendet? Dreh an einem Bedienelement und lies die Anzeige:

• Werte, die zwischen 0 und 127 steigen und fallen: ein Regler oder ein Endlos-Encoder, der absolute Werte sendet. Lass ENCODER auf ABSOLUTE; auf Trim und Fades bewegt SCALE ZOOM um so viel, wie du drehst.
• Werte, die nur die Richtung sagen: ein Encoder im relativen Modus. 1 / 127 ist RELATIVE · 2'S COMPLEMENT, 65 / 63 ist BINARY OFFSET, 1 / 65 ist SIGN MAGNITUDE. DETECT KNOB findet das für dich heraus.
• Relativ funktioniert am besten: der Regler hat keinen Anschlag. Viele Controller stellen das in ihrem eigenen Setup-Tool um, mit einem eigenen Modus, der pro Richtung einen Wert sendet.
• Beispiel ParksTool (config.parkstool.com): stell den Content Type des Encoders auf MIDI CUSTOM mit rechts 65 und links 63, dann nimm BINARY OFFSET. Das eigene Beispiel von ParksTool, 65 links und 63 rechts, geht auch, mit INVERT an.
• Ein Druckschalter am Encoder: lass ihn eine Note senden und lern sie auf eine Aktion. Als schnelle Lösung lass ihn eine Taste tippen (z. B. KEYBOARD „X“).

Vormerken und übertragen

man stage · Bearbeitete und hinzugefügte Samples für die Karte vormerken und im Tab Restore übertragen

Bearbeitete und hinzugefügte Samples kommen in zwei Schritten auf deine Karte: du merkst sie vor (STAGE, ohne Karte), dann überträgst du sie im Tab RESTORE (APPLY). So bereitest du alles vor, wann immer du willst, und dein M8 muss erst ganz am Ende dazukommen.

Vormerken

Drück im Editor STAGE FOR CARD (oder Rechtsklick auf einen Slice: STAGE SLICE FOR CARD…).

• SAVE AS NEW: schreibt eine neue Datei. Setz NEW FILENAME und FOLDER (beginnt mit /Samples/).
• REPLACE ORIGINAL: die neue Datei tritt an die Stelle des Originals. M8Thor prüft, welche Songs und Instrumente das Sample verwenden, warnt dich („… MAY BREAK“) und fragt dann „Really replace …?“. Bei Quellen, die kein WAV sind: nimm Save as New.
• STAGE merkt die Bearbeitung vor. Das Original in deinem Backup bleibt unberührt.
• Samples aus einem Mac-Ordner, einem Archiv oder einem Chip-Tune werden immer als neue Dateien vorgemerkt, mit ihrer Herkunft: FROM MAC FOLDER, FROM ZIP, FROM LHA, FROM ADF, FROM DMS, FROM MODULE, FROM SID, FROM TFMX. ADD TO CARD merkt viele auf einmal vor (man mac), STAGE SET FOR CARD ein ganzes Set (man sets).

Prüfen (ohne Karte)

Willst du noch mal draufschauen, bevor irgendetwas die Karte berührt? Öffne in BROWSE die Zeile PENDING (N) eines Sets (↑ ↓ wechseln zwischen den Bearbeitungen). Für jede kannst du die vorgemerkte Datei abspielen, KIND, TARGET, SOURCE, ROTATION, STAGED sehen und CHANGE TARGET…, OPEN IN EDITOR (öffnet mit den vorgemerkten Einstellungen; erneutes Vormerken ersetzt den Eintrag) oder DISCARD nutzen.

Übertragen

• Der Tab RESTORE zeigt einen Block PENDING EDITS. Für eine verbundene Karte drück APPLY…; eine nicht verbundene zeigt „CONNECT THE M8 TO APPLY“. Auch der Tab BACKUP weist dich darauf hin (N PENDING EDITS → RESTORE). Sets und Versionen im Restore-Assistenten bieten ebenfalls APPLY N.
• Das Fenster listet jede Bearbeitung (+ NEW oder REPLACE). Hak die gewünschten an, dann APPLY SELECTED und bestätigen. CHECK CARD liest die Songs auf der Karte, um zu sehen, welche ein ersetztes Sample verwenden.
• Jede Kopie wird nach dem Schreiben geprüft. Eine neue Datei überschreibt nie eine vorhandene: stattdessen bekommst du COLLISION mit RENAME. Weitere Zustände: DONE, RETRY, SOURCE MISSING ON CARD, MORE / FEWER SONGS NOW USE THIS SAMPLE.
• DISCARD ALL entfernt alle vorgemerkten Bearbeitungen (fragt vorher).
• Nach sauberem Übertragen bietet BACKUP NOW ein frisches Backup der geänderten Karte an. Eine gute Idee, immer.
• Übertragen ist gesperrt, solange ein Backup oder Restore läuft.

Remote

man remote · Dein M8 am Mac: sein Bildschirm, seine Tasten über die Mac-Tastatur, sein USB-Audio

Der Tab REMOTE (⌘4) holt dein M8 auf den Mac: seinen Bildschirm in einen Monitor, seine Tasten auf die Mac-Tastatur und sein USB-Audio auf deinen Mac. Dafür hängt dein M8 per USB im normalen Modus am Mac. Im USB-Laufwerksmodus gehört seine Karte den Backups, und REMOTE tritt höflich zur Seite.

Verbinden

• Verbinde dein M8 per USB, und das Glas sagt M8 READY. Das Bild startest du mit CONNECT am Monitor, ⌘K oder Actions › Connect to M8; DISCONNECT beendet es. Wechsel ruhig die Tabs, das Bild läuft weiter.
• Der Monitor folgt dem Erscheinungsbild der App: ein CRT bei Dark, ein LCD bei Light. Unter dem Glas siehst du Modell, Firmware und Bildschirmgröße deines M8 (z. B. MODEL:02 · FW 6.6.3 · 480×320) und den Zustand: READY, CONNECTING, LIVE, RECONNECTING, DISK MODE.
• Hat ein anderes Programm den Port des M8 offen, ist er blockiert: PORT IN USE BY ANOTHER APP. Beende das Programm und drück dann RETRY. Weitere Meldungen: man troubleshoot.

Tasten

• Klick auf den Bildschirm des M8. Solange er den Ring hat (KEYS → M8 unter dem Glas), spielen die Tasten des Mac dein M8. Klickst du woanders hin, wechselst den Tab oder öffnest ein Fenster, gehören die Tasten wieder dem Mac.
• Die Pfeiltasten sind die Pfeile des M8; Z oder linkes ⇧ ist SHIFT, X oder Leertaste PLAY, A oder linkes ⌥ OPTION, S oder Return EDIT, und ⌫ drückt OPTION und EDIT zusammen. Alle Tasten: man keys.
• Lust zu jammen? Esc schaltet Keyjazz ein oder aus, und die Buchstabenreihen spielen Noten, genau wie in m8c. KEYJAZZ unter dem Glas zeigt es mit Oktave und Velocity; − und = ändern die Oktave, [ und ] die Velocity (mit ⌥ in Einerschritten).
• Die Tasten gelten nach ihrem Platz auf der Tastatur, also auf jedem Layout gleich. SETTINGS › Shortcuts listet sie unter Remote. Sie sind fest.

Audio

• AUDIO spielt das USB-Audio deines M8 auf diesem Mac. VOL ist seine Lautstärke hier, nicht die des Systems. Neben AUDIO siehst du, wie spät der Ton auf diesem Mac erklingt, in ms.
• macOS behandelt das USB-Audio des M8 als Mikrofon und fragt einmal nach dem Zugriff. Keine Sorge: M8Thor hört nur dem M8 zu und nimmt nichts auf. Ohne Zugriff funktionieren Bildschirm und Tasten trotzdem (MIC ACCESS DENIED); erlauben kannst du ihn in Systemeinstellungen › Datenschutz & Sicherheit › Mikrofon.

Disk-Modus

• Wechselt dein M8 in den USB-Laufwerksmodus, lässt REMOTE es los: M8 IN DISK MODE. EJECT CARD wirft die Karte sicher aus, und dein M8 kommt ganz von selbst zu REMOTE zurück.
• Solange ein Backup, Restore oder Auto-Backup die Karte belegt, sagt der Knopf das und wartet. Mitten in einem davon wird die Karte nie ausgeworfen.
• Aus dem Disk-Modus genommen, ohne auszuwerfen? Dann siehst du CARD REMOVED WITHOUT EJECT — EJECT THE CARD BEFORE THE M8 LEAVES DISK MODE.

Einstellungen

man settings · Jede Einstellung, was sie tut und ihr Standard

Das meiste, was du an M8Thor einstellen kannst, findest du in SETTINGS. Du öffnest es mit ⌘5 (Tab) oder ⌘, (Einstellungsfenster). Die Seiten: General, Appearance, Backup, Verification, Notifications, Updates, Advanced, MIDI, Shortcuts, About. Wo eine Einstellung einen Standard hat, steht er unten dabei, so weißt du immer, wo du angefangen hast.

General

• Launch on login — M8Thor startet, wenn du dich anmeldest. Standard aus.
• Menu bar icon — M8Thor läuft nach dem Schließen des Fensters in der Menüleiste weiter. Standard aus. Ein Klick aufs Symbol zeigt oder versteckt das Fenster; ein Rechtsklick öffnet ein Menü mit jeder Karte und ihrem Zustand, „Open Main Window“ und „Quit M8Thor“.
• Ask to eject on quit — beendest du M8Thor mit verbundener Karte, fragt es: „Eject and Quit“, „Quit“ oder „Cancel“, mit „Don't ask again“. Standard an.

Appearance

• Appearance — System, Light, Dark. Standard System.
• Accent — pink, lime, amber (Standard), cyan, violet. Nimm die Farbe, die für dich am schönsten leuchtet.
• Typography — Mono (Standard) oder Sans.
• Text size — XS, S, M (Standard), L, XL.

Backup

• Backup directory — wohin deine Backup-Sets geschrieben werden; CHOOSE… (nicht während ein Backup oder Restore läuft). Standard ~/Backups.
• Back up when connected — startet ein Backup ein paar Sekunden, nachdem du eine M8-Karte verbindest, mit einem Countdown zum Abbrechen. Es gilt ab dem nächsten Verbinden, und die Einrichtung beim ersten Start bietet es auch an. Standard aus.
• Rotate old backups — behält nur die neuesten Backups pro Karte. Standard an.
• Rotations per device — wie viele Backups pro Karte bleiben, 1–30, Standard 5. Aus, solange die Rotation aus ist.
• Auto-eject on completion — wirft die M8-Karte nach einem erfolgreichen Backup aus. Standard aus.

Verification

• Checksum pass — vergleicht die kopierten Dateien nach jedem Backup noch einmal per Prüfsumme. Das kostet Zeit und bringt dir ein extra Stück Ruhe. Standard aus.
• On mismatch — Retry (noch ein Versuch), Flag (Standard: eine unvollständige Kopie zur Diagnose behalten), Abort (verwerfen). Eine fehlgeschlagene Prüfung ersetzt nie ein gutes Backup.

Notifications

• macOS permission — ob macOS M8Thor Mitteilungen erlaubt, mit einem Knopf zum Fragen oder zu den Systemeinstellungen.
• Completion — eine Mitteilung, wenn ein Backup fertig ist. Standard an.
• Failure — eine Mitteilung, wenn ein Backup fehlschlägt. Standard an.
• Play sound — ein kurzer Ton am Ende eines Backups. Standard an.

Updates

• Check for updates automatically — sucht im Hintergrund auf m8thor.cc nach neuen Versionen. Standard an (siehe man updates).
• App updates — CHECK NOW sucht sofort nach einer neuen Version; die Zeile zeigt die installierte Version.
• Check for M8 firmware — fragt, sobald ein M8 verbunden war, einmal täglich bei Dirtywaves GitHub nach neuer Firmware (man firmware). Nichts über dich oder dein M8 wird gesendet. Standard an.

Advanced

• Recognize other SD cards — sichert auch SD-Karten und USB-Laufwerke anderer Geräte (man backup). Standard aus.
• Identify M8 when connected — fragt ein M8 im normalen USB-Modus, sobald es auftaucht, nach Modell und Firmware-Version, für Firmware-Updates; nie, während seine Karte in Gebrauch ist. Standard an.
• Dither 16-bit files — ein winziges Rauschen, wenn der Sample-Editor 16-Bit-Dateien schreibt (Export und Vormerken), damit leise Fades nicht verzerren. Unbearbeitete Samples bleiben bitgenau. Standard an.
• rsync — BUILT-IN (das eigene rsync 3.4.4 von M8Thor, mit xxHash) oder HOMEBREW, wenn Homebrew-rsync installiert ist.
• rsync path, rsync version, Incremental (link-dest), Progress bar (--info=progress2) — reine Anzeigen zum gewählten rsync.

MIDI

Geräte und Anzeige, Detect a knob, Defaults for new knobs und die Zuordnungen erklärt dir man midi.

Shortcuts

• Preset — Standard, Logic oder Custom. Du kommst von Logic Pro? Logic nimmt die Tasten von Logic Pro, wo der Editor dasselbe tut.
• Klick eine Taste an, um sie zu ändern; das macht deinen eigenen Satz, Custom (auf Basis von Standard oder Logic). Drück die neue Taste; Esc bricht ab, ⌫ entfernt die Taste. Ist die Taste schon belegt, fragt REPLACE. RESET pro Zeile, RESET ALL für den ganzen Satz.
• Nur die Tasten des Sample-Editors lassen sich ändern; gesperrte Tasten (Menüs, ⌘Z, Esc, Listen, Browse, Remote) sind in jedem Preset gleich.
• Buchstaben- und Zifferntasten gelten nach ihrem Platz auf der Tastatur und zeigen die Buchstaben deines Layouts: auf einer deutschen Tastatur zeigt die Taste für Z ein Y.
• ⌘F durchsucht die Liste. Siehe man keys.

About

Publisher (Imprint), Version, Homepage, Open source (LICENSES & SOURCE, siehe man updates) und Trademarks.

Tastenkürzel

man keys · Alle Tastenkürzel in der App, in Browse, in Remote und im Sample-Editor (Preset Standard)

Du lässt die Hände lieber auf der Tastatur? Hier sind die Tasten des Presets Standard. Buchstabentasten gelten nach ihrem Platz auf der Tastatur (auf einer deutschen Tastatur ist Z die Taste mit dem Y). Die Tasten des Editors kannst du in SETTINGS › Shortcuts ändern (man settings).

App

⌘1 ⌘2 ⌘3 ⌘4 ⌘5

BACKUP, RESTORE, BROWSE, REMOTE, SETTINGS

⌘B

die gewählte Karte sichern

⌘E

alle M8-Karten auswerfen

⌘R

Karten neu suchen

⌘K

das M8 in REMOTE verbinden

⌥⌘0

zum offenen Sample-Editor (Window › Sample Editor)

⌘,

Einstellungsfenster

⇧⌘M

nur den Fortschritt zeigen, während ein Backup oder Restore läuft

Return

NEXT → in der Einrichtung beim ersten Start

Browse

⌘F

die Version durchsuchen

↑ ↓

durch die Liste; Samples und Tunes spielen, solange AUDITION an ist

→

Ordner, Archiv oder Modul öffnen, oder das Sample im Editor öffnen

←

den Ordner verlassen; ganz oben zurück zu den Backup-Versionen

Return

die Zeile öffnen

Space

abspielen oder stoppen; schaltet AUDITION ein

Esc

stoppen und AUDITION ausschalten

↑ ↓

in den Backup-Versionen: vorige oder nächste Version; Return oder → gehen in die Dateien

↑ ↓

in den vorgemerkten Bearbeitungen: vorige oder nächste

F

die Datei unter dem Cursor ins TARGET-Set legen

Double-click

ein Archiv oder Modul öffnen

Im Backup-Browser von RESTORE schließt Esc ihn.

Remote

Click

Klick auf den Bildschirm des M8: solange er den Ring hat, spielen diese Tasten das M8

↑ ↓ ← →

die Pfeile des M8

Z ⇧

SHIFT (linkes ⇧)

X Space

PLAY

A ⌥

OPTION (linkes ⌥)

S Return

EDIT

⌫ ⌦

OPTION und EDIT zusammen

Esc

Keyjazz an oder aus: die Buchstabenreihen spielen Noten

− =

Keyjazz-Oktave tiefer, höher (auch ÷ × am Ziffernblock)

[ ]

Keyjazz-Velocity tiefer, höher; mit ⌥ in Einerschritten (auch − + am Ziffernblock)

R

den Bildschirm des M8 neu zeichnen (Keyjazz aus)

Diese Tasten gelten nach ihrem Platz auf der Tastatur, also auf jedem Layout gleich, und lassen sich nicht ändern.

Sample-Editor

1–5

Seiten TRIM, SLICE, LOOP, FX, OUTPUT

Space

ab Abspielkopf oder den gewählten Slice spielen; noch einmal stoppt und springt zurück

Return

das ganze Ergebnis ab Trim-Anfang spielen

Esc

stoppen; ohne Wiedergabe die Auswahl aufheben; schließt den Editor, wenn nichts mehr übrig ist

← →

voriger oder nächster Slice, sofort gespielt

↑

den gewählten Slice neu starten (in der Slice-Liste: ↑ ↓ voriger / nächster Slice)

⇥ ⇧⇥

den nächsten oder vorigen Slice wählen

⌫

den Marker des gewählten Slices löschen

M

Marker am Abspielkopf setzen

I O

Trim-Anfang oder -Ende am Abspielkopf

R ⇧R

Slice umkehren, ganzes Sample umkehren

N

Normalize an oder aus

L

die Vorschau loopen

S

Snap to zero an oder aus

K

MIDI Learn an oder aus (im Lernmodus: ⌫ vergisst, Esc beendet)

Z

auf den Slice oder den Trim zoomen; noch einmal zurück

X

auf 100 ms um den zuletzt bewegten Griff oder Marker (oder den Abspielkopf) zoomen; noch einmal zurück

Home End

zum Anfang oder Ende springen

⌘+ ⌘− ⌘0

hinein-, herauszoomen, zurücksetzen; Pinch zoomt um den Zeiger

⌘Z ⇧⌘Z

Rückgängig, Wiederholen

⌃⌘F

Editor im Vollbild

⇧⌘E

das Ergebnis exportieren

⌘Return

für die Karte vormerken

⌥⌘0

zurück zum Hauptfenster; der Editor bleibt offen

⌥-click

ein Element zurücksetzen; auf einer Fade-Kurve: linear machen

⌃-drag

feine Auflösung beim Ziehen eines Griffs oder Reglers

⌥-scroll

Anzeige-Zoom über der Wellenform

⇧-click (lane)

die nähere Trim-Fahne zum Klick setzen

Right-click

Slice-Menü

• Das Metronom (CLICK) hat in Standard keine Taste; Logic nimmt K dafür und ⌘L für MIDI Learn.
• Unterschiede im Preset Logic: ⇧Leertaste startet den Slice neu, ⌘→ ⌘← zoomen hinein und heraus, C loopt die Vorschau, ⌘T setzt einen Marker.
• Im Fenster eines Plugins spielen Leertaste und Return genau wie im Editor.

Wo deine Daten liegen

man storage · Aufbau des Backup-Ordners, Speicherplatz, vorgemerkte Bearbeitungen, Caches, Editor-Einstellungen, Sets und Firmware

Backup-Ordner

Neugierig, wo alles landet? Standardmäßig in ~/Backups oder in dem Ordner, den du gewählt hast. Darin findest du:

• einen Ordner pro Karte: <VOLUME NAME>_<letzte 8 Zeichen der Karten-UUID>
• darin einen Ordner pro Backup: backup-YYYY-MM-DD-HHMMSS, dazu einen Link latest auf das neueste
• .edits/ mit den vorgemerkten Sample-Bearbeitungen, bis sie übertragen sind

Kein Geheimformat: Die Backup-Ordner sind ganz normale Dateien, und du kannst sie jederzeit im Finder öffnen (HISTORY auf der BACKUP-Karte).

Speicherplatz

• Unveränderte Dateien sind zwischen Versionen per Hardlink verbunden und belegen keinen zusätzlichen Platz.
• Vor dem Kopieren schätzt M8Thor die Übertragung und stoppt mit „Not enough disk space for this backup.“, wenn am Ziel weniger als die Schätzung plus 100 MB frei ist. Lieber früh stoppen als auf halber Strecke scheitern.
• CHANGE DESTINATION… macht eine eigenständige Vollkopie, ohne Links zu deinem Standardspeicher.
• Eine Version in den Papierkorb zu legen gibt nur die Dateien frei, die keine andere Version teilt, oft viel weniger als ihre Größe (auf Laufwerken ohne Hardlinks, z. B. exFAT, ihre volle Größe). Die Rotation löscht die ältesten Versionen endgültig. Siehe man restore.

Was ausgelassen wird

macOS-Verwaltungsdateien (.DS_Store, ._*, .Spotlight-V100, .Trashes, .fseventsd) werden weder gesichert noch wiederhergestellt. Dein M8 braucht sie nicht, und deine Backups auch nicht.

Unfertige Backups

Ein Backup wird zuerst in einen versteckten Arbeitsordner geschrieben und erscheint erst als Version, wenn es vollständig ist. Ein fehlgeschlagener Lauf kann zur Diagnose bleiben; er wird nie zum Wiederherstellen angeboten und beim nächsten Backup dieser Karte entfernt.

Weitere Orte

• Einstellungen des Sample-Editors: ~/Library/Application Support/M8Thor/edits/
• Renderings von Chiptunes und vorgemerkte Samples eines Moduls: ~/Library/Application Support/M8Thor/Generated/ (bleiben, solange eine vorgemerkte Bearbeitung darauf verweist)
• Wellenform-Übersichten: ~/Library/Application Support/M8Thor/waveforms/ (ein Cache, bis 256 MB, die ältesten gehen zuerst; darf gelöscht werden)
• Entpackte Archive: ~/Library/Caches/M8Thor/Archives/ (bis 2 GB); Samples geöffneter Module und entpackte Tunes: ~/Library/Caches/M8Thor/ (bis 256 MB). Caches, die ältesten gehen zuerst; dürfen gelöscht werden.
• Hinzugefügte Mac-Ordner: merkt sich die App; die Ordner selbst werden nur gelesen.
• Namen der Karten: merkt sich die App; sie ändern nie die Karte, ihren Volume-Namen oder ihren Backup-Ordner.
• Sets: ~/Library/Application Support/M8Thor/sets.json, nur Verweise (man sets).
• Firmware: ~/Library/Application Support/M8Thor/firmware.json (was jedes M8 gemeldet hat, welche Firmware M8Thor auf welche Karte gelegt hat, die akzeptierte EULA) und die geladenen Versionen in Firmware/ daneben (man firmware).
• Diagnose-Logs von rsync: ~/Library/Logs/M8Thor/, nach 30 Tagen gelöscht
• Exporte (SAVE A COPY…, EXPORT…) dürfen hin, wo du willst, nur nicht in deinen Backup-Ordner.

Updates, Beta und Lizenzen

man updates · Automatische Updates, der Beta-Zeitraum, Probleme melden, Open-Source-Hinweise

Updates

• M8Thor sucht einmal täglich automatisch nach Updates (Sparkle), so bleibst du auf dem neuesten Stand, ohne einen Finger zu rühren. Ausschalten kannst du das in SETTINGS › Updates.
• Du willst selbst nachsehen? Menü M8Thor › „Check for Updates…“ oder SETTINGS › Updates › App updates › CHECK NOW.
• Updates funktionieren auch nach dem Ende der Beta, eine Folgeversion lässt sich also immer installieren.

Beta

• Während der Beta bekommst du alle Funktionen. Ein Hinweis lautet „BETA ACCESS ENDS NOVEMBER 30, 2026“. Du kannst ihn schließen; er kommt 14 und 3 Tage vor dem Ende wieder.
• Der Beta-Zugang endet für jede Installation nach dem 30. November 2026 (der letzte Tag ist in jeder Zeitzone vollständig). Die App zeigt dann „M8THOR BETA HAS ENDED“ mit einem Link zu m8thor.cc, und ihre Funktionen sind gesperrt. Deine Backups bleiben genau da, wo sie sind: normale Ordner, die du im Finder öffnen kannst (man storage).

Ein Problem melden

Läuft etwas nicht so, wie es soll? Ein Bericht ist in einer Minute gemacht. Nimm Help › „Report a Problem…“ oder REPORT PROBLEM bei einem fehlgeschlagenen Backup. Beschreib, was passiert ist, prüf die REPORT PREVIEW (Version von App, macOS und rsync, Kartendaten, aktuelles Log), dann COPY REPORT, SEND BY EMAIL (support@m8thor.cc) oder OPEN ON GITHUB. Der Bericht landet in der Zwischenablage; der Pfad deines Benutzerordners, UUIDs und Karten-IDs sind maskiert. Nichts wird automatisch gesendet.

Open Source

M8Thor steht auf den Schultern von Open Source. SETTINGS › About › Open source › LICENSES & SOURCE öffnet OPEN SOURCE & LICENSES: jeder Open-Source-Teil der App, seine Lizenz direkt lesbar und seine Dateien einen Klick entfernt im Finder — auch nach dem Ende der Beta. Lizenztexte und Quellen liegen in der App unter Contents/Resources/ThirdParty:

• rsync 3.4.4 (GNU GPL v3, vollständiger Quellcode), mit popt, zlib und xxHash 0.8.3 einkompiliert.
• Sparkle (MIT), für App-Updates.
• libopenmpt 0.8.9 (BSD-3-Clause), das die Tracker-Module liest.
• m8thor-sid (GNU GPL v2 oder später, Quellcode in der App) mit libsidplayfp 3.1.1 (und dessen hashlib, MIT) und libresidfp 1.2.2, für SID-Tunes.
• m8thor-tfmx (GNU GPL v2 oder später, Quellcode in der App) mit libtfmxaudiodecoder 1.0.14, für TFMX-Tunes.
• ancient 2.3.0 (BSD-2-Clause, mit Tabellen aus bzip2, bzip2-Lizenz) für DMS-Disk-Images und lhasa 0.6.0 (ISC) für LHA- und LZH-Archive, beide in m8thor-unpack einkompiliert.
• Die M8-Displayschriften (CC BY-SA 3.0), mit denen REMOTE den Bildschirm des M8 zeichnet: stealth57 von Trash80 und die große Schrift nach m8xl-ess von sm0hm, übernommen aus m8c von Jonne Kokkonen (MIT).

Dirtywave und M8 sind Marken von Dirtywave. M8Thor ist unabhängig und nicht mit Dirtywave verbunden. Siehe auch m8thor.cc/licenses.html.

Fehlerhilfe

man troubleshoot · Was die Meldungen bedeuten und was zu tun ist

Karte nicht gefunden

• NO M8 DETECTED — verbinde dein M8 per USB und schalte es in den USB-Laufwerksmodus.
• NO M8 CARD FOUND (N VOLUMES SCANNED) — Volumes sind eingebunden, aber keines hat die M8-Dateien (System/STARTUP.m8s oder Songs und Instruments). Prüf die Karte, dann SCAN NOW. Für eine Karte eines anderen Geräts schalte „Recognize other SD cards“ ein.
• SCAN ERROR — die Suche ist fehlgeschlagen; drück RETRY.
• Restore zeigt NO CARD DETECTED — verbinde dein M8 im USB-Laufwerksmodus oder steck eine FAT32/exFAT-SD-Karte ein, dann REFRESH.
• macOS hat den Zugriff auf die Karte oder den Backup-Ordner verweigert — OPEN SETTINGS öffnet Systemeinstellungen › Datenschutz & Sicherheit › Dateien & Ordner; erlaube M8Thor dort den Zugriff, dann RETRY.

Meldungen beim Backup

• „Not enough disk space for this backup.“ — mach Platz frei oder wähl ein anderes Ziel.
• „Unsupported rsync version. Select a supported rsync in Settings.“ — SETTINGS › Advanced, BUILT-IN wählen.
• „Volume identity or mount path changed. Reconnect the card and select it again.“
• „Source files disappeared during backup. The backup is incomplete and was not published.“ — etwas hat die Karte während des Backups verändert; starte es noch einmal.
• „Backup transfer failed (rsync exit N). The backup was not published.“
• „Backup verification failed: …“ — die Kopie stimmte nicht mit der Karte überein. Keine Panik: Deine früheren Backups sind unberührt. Siehe „On mismatch“ in man settings.
• „Nothing selected to back up.“ — wähl mindestens einen Ordner oder Song.
• „Cannot start backup — … in progress on this card.“ — warte auf den anderen Vorgang.
• „Backup saved, but it holds far fewer files than the previous one (…). Older backups were kept — check the card.“ — die Karte ist vielleicht leer oder beschädigt; deine älteren Backups blieben erhalten.
• „Backup saved, but the "latest" link could not be updated: …“
• „Backup was cancelled.“ — es wurde keine unvollständige Version veröffentlicht.

Auswerfen

• „Cannot eject while another operation is running.“ — warte, bis er fertig ist.
• „Failed to eject: …“ — schließ Apps, die die Karte nutzen, und versuch es erneut.
• Beenden während eines Backups fragt „Operation in Progress“: „Close Anyway“ bricht ab; ein unfertiges Backup wird verworfen, ein fertiges bleibt.

Meldungen beim Restore

• „Partial restore: some files could not be transferred (rsync code 23). Check the log for details.“
• „Restore incomplete: source files disappeared during transfer. …“
• „Another operation is already running for this card.“
• „Backup source no longer exists on disk.“
• „Restore was cancelled — the target may be partially restored“
• „M8 card disconnected during restore — the target may be partially restored“
• „rsync output parse failed — raw log saved to <path>“ (bei PREVIEW)

Ein teilweiser Restore ist kein Drama: Starte ihn einfach noch einmal, dann wird er vollständig.

Browse und Editor

• CHOOSE A FOLDER OUTSIDE YOUR BACKUPS — Exporte dürfen nicht in den Backup-Ordner.
• „Refusing to overwrite the original sample. Choose a different name.“
• NOT ON THIS MAC: <PLUGIN> (der Slot zeigt MISSING · <PLUGIN>) — ein Plugin aus einem FX-Slot fehlt. Export und Vormerken stoppen, bis du es installierst oder den Slot entfernst.
• FX n: NO SIGNAL — TO TARGET oder MATCH fand im Trim nichts zu messen; die Pegel bleiben, wie sie waren.
• „Reference check failed: …“ — M8Thor konnte die Songs dieser Version nicht lesen; USED IN und UNUSED sind nicht verfügbar.
• NOT FOUND unter MAC FOLDERS — der Ordner ist weg oder auf einem Laufwerk, das nicht verbunden ist.
• NOT ENOUGH SPACE ON THE BACKUP DRIVE (ADD TO CARD) — vorgemerkte Dateien liegen auf dem Backup-Laufwerk, bis sie übertragen sind.
• NO TARGET SET (F) — erst Rechtsklick auf ein Set › MAKE TARGET. SAVE A COPY FIRST (ADD TO SET) — die Datei liegt im Cache von M8Thor (aus einem Archiv oder Modul); sichere eine Kopie und füge die hinzu (man sets).

Remote

• NO M8 CONNECTED — verbinde das M8 per USB. M8 IN DISK MODE — dein M8 ist im USB-Laufwerksmodus; EJECT CARD, und es kommt zurück.
• PORT IN USE BY ANOTHER APP — ein anderes Programm hat den Port des M8 offen; beende es, dann RETRY.
• CONNECTION LOST — das M8 ist weg, hat nicht geantwortet oder ließ sich nicht lesen; wieder CONNECT.
• MIC ACCESS DENIED — erlaube M8Thor den Zugriff in Systemeinstellungen › Datenschutz & Sicherheit › Mikrofon; Bildschirm und Tasten gehen auch ohne. M8 AUDIO NOT FOUND — das USB-Audio des M8 taucht nicht auf; M8Thor sucht erneut, wenn sich die Audiogeräte ändern. OUTPUT IS THE M8 — dieser Mac spielt über das M8 selbst, das würde seinen Ton zurückspeisen; wähl eine andere Ausgabe.
• EJECT FAILED — die Karte ließ sich nicht auswerfen; der Grund steht dahinter.

Firmware

• LAST CHECK FAILED (Zeile FIRMWARE) — Dirtywaves GitHub war nicht erreichbar; M8Thor versucht es später wieder.
• DOWNLOAD FAILED — TRY LATER, oder THE DOWNLOADED FIRMWARE IS DAMAGED — GET IT AGAIN.
• CARD IS BUSY — TRY AGAIN WHEN IT IS FREE — ein Backup, Restore oder Übertragen nutzt die Karte.
• NOT ENOUGH SPACE ON THE CARD.
• THE CARD WENT AWAY OR CHANGED — NOTHING WAS LEFT ON IT oder THE CARD DID NOT READ BACK THE SAME — NOTHING WAS LEFT ON IT — noch einmal kopieren. THE CARD WENT AWAY DURING THE COPY — eine temporäre Datei kann darauf liegen; M8Thor entfernt sie beim nächsten Mal.

Archive und Chip-Tunes

• NOT A ZIP ARCHIVE, THIS ZIP IS DAMAGED, ZIP64 IS NOT SUPPORTED, SPLIT ZIPS ARE NOT SUPPORTED, THIS ZIP IS TOO LARGE TO OPEN — siehe die Grenzen in man archives.
• NOT AN LHA ARCHIVE, THIS LHA IS DAMAGED, THIS LHA IS TOO LARGE TO OPEN — dasselbe für LHA/LZH-Archive; Grenzen in man archives.
• NOT A DMS DISK IMAGE, THIS DMS IS DAMAGED, THIS DMS IS TOO LARGE TO OPEN, THIS DMS HOLDS NO AMIGA DISK (eine MS-DOS- oder FMS-Disk, als DMS gepackt).
• N FILES SKIPPED: ENCRYPTED / UNSUPPORTED METHOD / LINK — diese Dateien wurden ausgelassen; der Rest öffnet sich.
• NOT AN AMIGA DISK IMAGE, NO FILES ON THIS DISK — A DEMO OR GAME KEEPS ITS MUSIC PACKED INSIDE (eine Demo- oder Spiele-Disk ohne ungepacktes Modul darauf), THIS DISK IS DAMAGED, LONG FILENAME DISKS ARE NOT SUPPORTED.
• Ein Modul, SID- oder TFMX-Tune, der nicht spielt, zeigt unter PLAY warum. Ein TFMX-Tune braucht seine Sample-Datei (smpl.<name>) im selben Ordner.

Eine Version in den Papierkorb legen

• THE LAST BACKUP OF A CARD IS ALWAYS KEPT — eine Karte behält mindestens eine Version.
• THIS BACKUP IS IN USE — ein Restore, ein ZIP-Export, SAVE A COPY… oder ein offener Sample-Editor liest es; beende oder schließ das zuerst.
• THIS BACKUP HAS PENDING EDITS — übertrag oder verwirf sie zuerst (man stage).
• A BACKUP OR RESTORE IS RUNNING — warte, bis er fertig ist (auch während ein Backup auf CONFIRM wartet oder herunterzählt).
• THIS VOLUME HAS NO TRASH — z. B. manche Netzlaufwerke; nichts wird gelöscht.

Immer noch nicht weiter

Kommst du immer noch nicht weiter? Nimm Help › „Report a Problem…“ (man updates) und beschreib in deinen eigenen Worten, was passiert ist.