MusicNote Haven MIDI Manager
Online User Manual

MIDI Manager User Manual.

A complete 1.1.0 workflow from first setup to indexing, deep analysis, review, safe organization, playback, floppy IMG work and maintenance.

Installation and safety rules: Install MIDI Manager with the platform-specific guide. After installation, start with a small copied test collection until you understand the workflow. Linux installation manual Windows installation manual

Installation and safety rules

Install MIDI Manager with the platform-specific guide. After installation, start with a small copied test collection until you understand the workflow.

MIDI source/library root

Your original or unsorted MIDI/KAR collection. Source Index inventories this folder and Deep MIDI Analysis reads the files.

Organized Library output root

A different folder where approved safe copies are created. Never point this to the source folder.

MIDI archive root

Optional archive location used by archive workflows. Preview archive actions before doing any cleanup.

Generated files folder

Destination for IMG files, reports, CSV/JSON exports and maintenance reports.

First start: configure folders, language, theme and playback

Open Settings → Settings. Configure the application paths first; Advanced settings stays collapsed unless you need specialist tuning.

  1. Theme and Language can be changed at any time. The current screenshots use the Dark theme and English UI labels.
  2. Startup page controls the page opened after startup; Dashboard is the recommended default.
  3. Choose separate source and Organized Library output folders. MIDI archive and Generated files folders are optional.
  4. Choose a SoundFont file if you want FluidSynth playback. MIDI Manager does not bundle a SoundFont.
  5. Click Apply Settings and wait for the status bar to confirm that settings were saved.
  6. Private local paths are intentionally hidden in public screenshots.

Organizer analysis batch size

Controls how many eligible source files are analyzed in one Library Organizer batch. It changes batch size, not file safety rules.

Genre artist batch size

Controls the number of artists processed by the genre/artist maintenance pilot in one run.

Database backup retention

Sets how many verified automatic database backups MIDI Manager retains. It does not delete MIDI/KAR files.

Trial / Free mode and licence activation

Open Settings → Licensing. This page shows the application version, licence status/tier, major-version compatibility, Organized Library limit and this computer’s Device ID.

Upgrade & online help

Licence actions

Remove local licence

Removes the locally stored signed licence from this computer only. It does not release the activation on the server; use device transfer/release for that.

Feature grants

Shows which licensed capabilities are enabled, blocked or limited for the current tier and why.

Release / transfer this computer

Releases the current device activation through the online licensing service so the licence can be moved according to the licence terms.

Feature access — what each grant means

The Licensing page lists these grants for the active tier. The descriptions below use the same feature labels and explanations as MIDI Manager 1.1.0.

Core application access

Allows the application to run outside a blocked or invalid-license state. This is normally enabled for all valid license tiers.

Search and browse MIDI/KAR files

Allows browsing, filtering and searching indexed MIDI/KAR files. This is part of the basic MIDI Manager experience.

MIDI/KAR playback

Allows MIDI/KAR playback from the application. Playback still depends on the configured SoundFont and playback setup.

Organized Library

Allows access to the Organized Library browser/player workflow.

Organized Library advanced playback queue

Allows advanced Organized Library playback queue controls, including adding selected files to the playback queue, playing the queue and clearing the queue.

Basic Library Organizer

Allows basic Library Organizer workflows such as reviewing files and building the Organized Library within the active tier limit.

Bulk Library Organizer

Allows larger/bulk Library Organizer workflows. This is intended for paid tiers because it can process much larger collections.

Copy Guard archive tools

Allows Copy Guard archive tools that move verified source files into the configured MIDI Archive. This is powerful and should normally be reserved for Professional licenses.

Full 3.5 inch disk image creation

Allows full 3.5 inch disk image creation workflows for DSDD/DSHD-style disk-image output. This is normally a Personal feature.

IMG Viewer

Allows opening and inspecting disk image contents from inside the application. Personal licenses get read-only IMG viewing; Professional licenses get the full IMG workflow.

IMG Viewer extract/play/rewrite

Allows extracting, playing files from, adding/removing files in, and saving rewritten IMG disk images. This is a Professional-only workflow because it modifies or exports disk-image contents.

Project Health and language validation

Allows Project Health and language validation checks in Maintenance. These are diagnostic checks, not archive-changing repair actions.

Advanced maintenance tools

Allows advanced maintenance and repair tools. These tools can affect larger parts of the local library/database and are normally Professional-only.

License transfer workflow

Allows the secure license-transfer workflow, including releasing the currently licensed computer before activating another one.

Dashboard — your MIDI collection at a glance

Dashboard is the read-only control room for your collection. It keeps the most useful Organized Library, source, analysis, archive, review, compatibility, lyrics and playback figures visible at the same time; it does not replace the task pages with shortcut buttons.

Where each task lives

The professional 1.1.0 shell uses the exact destinations below. Older names in historical screenshots or release notes are not navigation instructions.

Dashboard

Collection status and health.

Analyze

Source Index, Deep MIDI Analysis and Source inventory.

Review

Review Queue and Failed analysis.

Organize

Analyze, plan, review, copy and verify safely.

Library

Organized Library search and MIDI by Device.

MIDI Player

Playback Queue and MIDI playback.

Floppy Image Studio

Create and inspect floppy IMG files.

Settings

Settings, Licensing and Library Health.

The eight Dashboard panels

These are the eight panels visible in the 1.1.0 Dashboard. The ? button on a panel opens its matching explanation here.

Dashboard: Organized Library

Shows the managed output collection: total files, artists, favourites, file extensions, total size and missing managed files.

Dashboard: Lyrics & Karaoke

Splits the Organized Library into embedded lyrics, lyrics added/imported by MIDI Manager, confirmed no lyrics, unclassified lyrics state, synced lyrics and karaoke-ready files.

Dashboard: Unsorted / Source

Physically scans the configured source folder for .mid, .midi and .kar files and combines that with indexed and lyrics classifications without treating unknown records as no-lyrics.

Dashboard: Analysis

Summarizes completed, failed and remaining Deep MIDI Analysis plus useful analysis/quality coverage.

Dashboard: MIDI Archive

Counts the configured physical MIDI Archive by extension and size and reports whether the archive folder is available.

Dashboard: Review & Attention

Shows Review Queue, Failed analysis, missing Organized Library records and database health indicators that may need attention.

Dashboard: MIDI Compatibility

Summarizes GM, GS, XG and Yamaha, Roland and Korg evidence in a stable two-by-three layout.

Dashboard: Playback

Shows Playback Queue and lyrics/karaoke readiness useful before opening MIDI Player.

Detailed Dashboard metrics

Open this reference for the individual analysis and coverage metrics used by Dashboard diagnostics. A ? link to one of these metrics opens this section automatically.

Analyze → Analyze Library: Source Index and Deep MIDI Analysis

Analyze contains two tabs. Analyze Library contains Step 1 — Source Index and Step 2 — Deep MIDI Analysis; Source inventory is the advanced lookup for indexed source records. Existing-database refresh and re-evaluation are under Settings → Library Health.

Total MIDI/KAR Files

Total number of discovered MIDI and KAR files stored in the database.

Base Enrichment

Base enrichment stores core metadata such as track count, tempo, notes and basic MIDI structure.

Deep Analysis Done

Files with completed advanced MIDI intelligence: quality score, pattern analysis, hardware detection, velocity analysis and complexity metrics.

Deep Analysis Processed

This includes both successful deep analysis and files that were classified as deep-analysis failures.

Deep Analysis Pending

Files that are indexed but have not yet gone through the deep analysis worker.

Deep Analysis Failed

These files remain indexed. Only the advanced analysis failed, usually because the file is corrupt, malformed or not really a MIDI file.

Review Queue

Review Queue is a safe staging list. It does not delete, move or modify MIDI files.

Organized Library Files

Counts MIDI/KAR files currently found in the configured organized library output folder.

Organized Library Artists

Counts first-level artist folders that contain organized MIDI/KAR files.

Playback Queue

Playback Queue is a safe listening queue. It does not delete, move or modify MIDI files.

Quality Scores

Quality scores estimate MIDI usefulness based on structure, dynamics, complexity and musical richness.

Yamaha / XG

Yamaha detection is based on SysEx manufacturer IDs and XG mode signals.

Roland / GS

Roland detection is based on SysEx manufacturer IDs and GS mode signals.

Korg / GM

Korg detection is based on manufacturer IDs. GM shows General MIDI reset/mode usage.

Analyze → Analyze Library: Source Index and Deep MIDI Analysis

Analyze contains two tabs. Analyze Library contains Step 1 — Source Index and Step 2 — Deep MIDI Analysis; Source inventory is the advanced lookup for indexed source records. Existing-database refresh and re-evaluation are under Settings → Library Health.

Step 1 — Source Index

Source Index discovers supported MIDI and KAR files and creates or updates local database records. It records filenames, paths and basic source information; it is not the full MIDI analysis.

  1. Click Update Source Index after first setup, after adding files, or after correcting source paths.
  2. Discovery can show a progress bar while the database is being updated.
  3. Existing indexed files may be skipped when unchanged; new files are added.
  4. When indexing finishes, the report shows discovered, newly indexed and skipped files.
  5. Run Source Index before Deep MIDI Analysis. Step 2 remains unavailable when no indexed records exist.

Analyze: Source inventory

Advanced search of indexed source/unsorted records for diagnostics and pre-organization inspection. Normal collection search belongs to Library.

Step 2 — Deep MIDI Analysis

Step 2 — Deep MIDI Analysis opens the remaining indexed MIDI/KAR files and stores technical, quality, protocol, device and evidence data used by Review, Library and File Detail.

  1. Start / Resume Analysis processes every record that has not yet reached a final state.
  2. The confirmation warns that a large collection can run for hours. It is safe to leave the app running.
  3. Stop Safely finishes and saves the current file before stopping. Completed work is never discarded.
  4. Start / Resume Analysis after a safe stop continues with the remaining files, not from the beginning.
  5. During a run, the status bar shows files resolved in this run, remaining files, speed, estimated time and current file.
  6. Failures reach a terminal state and are not retried endlessly. Inspect them before deciding whether the source file or path needs repair.

Understanding all analysis counters

Indexed

All database records created by Source Index.

Deep complete

Files whose full deep analysis completed successfully.

Deep failed

Files that entered the deep-analysis stage but could not be completed.

Source/parser failed

Files that could not be opened or parsed before deep analysis, for example missing or malformed files.

Why the Step 2 buttons can be grey

Analysis trust, score explanations and arranger/backing-track compatibility

Review, Library and File Detail

Use Review → Review Queue or Review → Failed analysis for files that need attention. Use Library → Organized Library for normal browsing and searching. Analyze → Source inventory is the advanced diagnostic view for indexed source records.

Review Queue

Files intentionally queued for later review. Removing a queue row does not delete the MIDI/KAR file.

Failed analysis

Files whose analysis reached a failed final state. Loading runs in the background and a Please wait overlay appears when it takes noticeable time.

MIDI by Device

Browse analyzed MIDI files by detected manufacturer, mode and compatibility evidence such as Yamaha/XG, Roland/GS and Korg/GM.

Library Organizer: analyze, review, plan, execute and verify

Library Organizer uses filename parsing and MusicBrainz-assisted matching to build copy-only organization plans. The normal workflow keeps organization analysis, planning, review and execution separate from archive/cleanup actions.

  1. 1 Organization analysis: process the next eligible source batch and classify results as safe to copy, needs review or skipped.
  2. 2 Plan safe copies: create copy plans only for open safe-to-copy results. Planning does not copy files.
  3. 3 Review: inspect uncertain identities and approve or correct artist/title metadata.
  4. 4 Corrected copies: build plans from user-approved manual corrections.
  5. 5 Execute + verify: execute reviewed copy jobs, then verify the new Organized Library files. Source files remain in place.

Safe to copy

Artist and title evidence is strong enough for a safe-copy plan. Always review the plan before execution.

Needs review

The match is ambiguous or incomplete. A human decision is required before copying.

Skipped

The row is intentionally excluded from automatic copying, for example because the match is weak or unsuitable.

Archive + cleanup is deliberately separate

Library → Organized Library: browse and search the managed collection

Library is the managed-collection workspace. Browse and search the Organized Library, inspect details, favourites, lyrics and metadata, and open MIDI by Device without switching to a separate top-level Search page.

Move Selected to MIDI Archive

Moves selected files physically from the configured Organized Library to the configured MIDI Archive. Path confinement, collision handling and byte/hash verification complete before database/index reconciliation; a failure keeps or restores the original state.

MIDI Player and Playback Queue

MIDI Player is the dedicated playback workspace. It owns the Playback Queue and shared playback transport; queue actions do not delete MIDI/KAR files.

MIDI Player

Open the Playback Queue and use the shared MIDI playback controls. Queue operations never delete source or Organized Library files.

Disk Image Creator

Disk Image Creator packs selected Organized Library or Review Queue files into FAT12 3.5-inch floppy images.

  1. Add files to the Disk Image Basket from Organized Library or Review Queue.
  2. Choose 3.5" DS/DD 720 KB or 3.5" DS/HD 1.44 MB. Use the format required by the keyboard, emulator or Gotek workflow.
  3. Pack Basket assigns a disk number and position without writing IMG files yet.
  4. Review estimated and assigned disk counts, oversized files and order.
  5. Create IMG Files opens a Save dialog. Choose the output folder and a clear base name such as POP1-001.
  6. The app creates a numbered IMG series and a companion manifest.

FAT12 8.3 names and the sidecar manifest

IMG Viewer: Single IMG and Folder Catalog

IMG Viewer opens FAT12 IMG files, uses the manifest when available and provides two complementary views.

  1. Single IMG shows image metadata, capacity, official/display names, sizes, clusters, attributes and raw 8.3 names.
  2. Open IMG selects one image. Reload rereads the current image; Open Folder opens its filesystem folder.
  3. Folder Catalog scans all IMG files in a folder, optionally including subfolders.
  4. Disk overview shows status, disk number, filename, format and file counts.
  5. Master contents combines all scanned disks. Double-click a master row to open the corresponding disk in Single IMG.
  6. Warnings and errors are summarized per disk; inspect the Problem Report for detailed diagnostics.

Reports and exports

The Reports tab uses the current Folder Catalog scan. Reports use the full scanned catalog, not only the rows currently visible after filtering.

Per Disk PDF - Disk Order

Lists files in physical IMG order: disk, position, official song name and 8.3 name.

Per Disk PDF - Artist/Title

Keeps each disk separate but sorts songs by artist/title within that disk.

Master Catalog PDF

Creates one alphabetical finder across all scanned IMG files with disk and position references.

Problem Report PDF

Separates technical warnings and errors from the finder reports. A clean scan reports that no warnings or errors were found.

Gotek Slot Index PDF

Creates a slot-oriented index for Gotek/USB workflows when slot data is available.

Master Catalog CSV

Exports the master catalog as a spreadsheet-friendly table.

JSON Manifest

Exports structured catalog, disk, order and filename mapping data.

Genre recovery, online artist analysis and genre filters

Genre data is optional enrichment. It does not change MIDI/KAR content.

Settings → Library Health

Open Settings → Library Health. Routine maintenance starts in Library Health. Expanding Advanced maintenance shows Database, Organized Library check, Library intelligence & metadata, Organized Library planning and Archive & cleanup. Support diagnostics is hidden in normal installations and is only enabled for support diagnostics.

What you see in Library Health

Library Health

Check for stale records, fix only verified safe issues, or review items that need your decision.

Database

Schema repair and compaction tools for exceptional maintenance.

Organized Library check

Use Check library, Apply safe corrections and Show details to compare managed records with already-organized files.

Library intelligence & metadata

Refresh legacy analysis in place, re-evaluate Recognition identity, fill lyrics and maintain MusicBrainz-derived metadata.

Organized Library planning

Preview normalization, build apply plans, export plans and reconcile the physical Organized Library.

Archive & cleanup

Inspect the configured MIDI Archive and prepare safe archive-first cleanup.

Detailed Library Health actions

Open this reference when you need an individual maintenance action. Preview and diagnostic actions are read-only; actions that can change the database or files state their safeguards explicitly.

Library Health → Check Library

Scan database paths and classify issues without changing records or MIDI files.

Library Health → Fix Safe Issues

Remove only stale test/technical records that are re-verified as safe after a fresh backup.

Library Health → Review Issues

Review unresolved stale records and choose what should happen to each one.

Database → Repair Database Schema

Check and repair the local database schema safely. If the schema is already healthy, nothing is changed and no repair backup is created. If repair is needed, MIDI Manager creates a verified safety backup before adding missing local tables, columns or indexes. MIDI/KAR files are never changed.

Database → Optimize / Compact Database

Create a verified backup, clean verified database-only stale data, checkpoint WAL and rebuild SQLite through a verified compact copy. Exclusive maintenance creates a verified backup, checkpoints WAL, cleans verified stale derived data, builds a compact candidate with VACUUM INTO, checks integrity/foreign keys and replaces the active database only after verification. It never deletes MIDI/KAR files.

Library intelligence & metadata → Refresh analysis database

Re-run the current local analysis pipeline for every existing indexed MIDI/KAR row in this profile. A verified database backup is created first. Existing user state is preserved and MIDI files are not moved or renamed.

Library intelligence & metadata → Re-evaluate Library

Scan the current Library again with the latest structured embedded-identity rules and store a read-only reconciliation preview.

Library intelligence & metadata → Search/fill lyrics (bulk)

Fill lyrics for the current Library from adjacent .lrc/.txt files first, then embedded MIDI/KAR lyrics. Missing lyrics remain available for manual or future configured provider lookup.

Library intelligence & metadata → Rebuild Genre Caches

Rebuild local genre caches and add only strict, safe local backfill matches.

Analyze next artists

Runs the configured next-artist genre analysis pilot for the batch size set in Settings.

Organized Library planning → Preview

Dry-run scan of copied Organized Library files. Shows which target paths would be normalized. No files or database rows are changed.

Organized Library planning → Plan Apply

Build a read-only collision-safe apply plan. Shows direct rename operations and automatic suffix rename operations. No files or database rows are changed.

Organized Library planning → Export Plan

Export the complete read-only collision-safe apply plan as TXT, TSV, and JSON into the configured Generated files folder. No MIDI files or database rows are changed.

Organized Library planning → Build Reconciliation Plan

Build a deterministic read-only database reconciliation plan from the existing Organized Library index and copied-action history. No files or database rows are changed.

Archive & cleanup → Preview

Read-only preview of the configured MIDI Archive. Shows archive files, archived source actions, missing archive paths, indexed rows that still point to archived source files, and a cleanup-plan preview. This does not delete, move or change anything.

Support diagnostics

Support diagnostics are hidden unless support tools are enabled. They are not normal menu destinations.

Support diagnostics → Check Database Schema

Run a read-only check for missing local database tables, columns and indexes.

Support diagnostics → Run Project Health Check

Run the read-only project health diagnostic script and show its output.

Support diagnostics → Validate Language Files

Validate language JSON files and show the validator output.

Common problems

Beginner checklist before using a large collection

  1. Install the correct platform build and read the installation guide.
  2. Create or choose separate source, Organized Library, archive and generated-output folders.
  3. Choose a legal SoundFont and confirm playback with one file.
  4. Review Trial / Free limits or activate and save the required licence.
  5. Run Source Index and compare discovered/indexed counts with the source folder.
  6. Run Deep MIDI Analysis; use Stop Safely when needed and resume later.
  7. Review Deep complete, Deep failed, Source/parser failed and Remaining.
  8. Test Library → Organized Library, Review → Failed analysis and Review → Review Queue. Inspect File Detail provenance after analysis.
  9. Run one small Library Organizer Organization analysis and inspect safe-to-copy, needs-review and skipped decisions.
  10. Plan and execute only reviewed copy jobs; verify source files remain untouched.
  11. Verify Organized Library playback and queue behaviour.
  12. Create a small IMG set, keep its manifest, scan it in Folder Catalog and generate finder/problem reports.
  13. Use Maintenance preview/check actions before repair or cleanup.
  14. Keep independent backups and record the app version when requesting support.