MIDI source/library root
Your original or unsorted MIDI/KAR collection. Source Index inventories this folder and Technical MIDI Scan reads the files.
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.
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.
- Keep the source folder and Organized Library folder separate.
- Normal Source Index, Technical MIDI Scan, Search and preview actions do not rename or delete source files.
- Library Organizer safe-copy execution creates new files in the Organized Library and leaves the source files in place.
- Removing rows from Review Queue or Playback Queue does not delete MIDI/KAR files.
- Keep an independent backup before deleting, moving or renaming files outside MIDI Manager.
- Reconnect external drives and network shares before opening the app. Missing paths can produce source/parser failures.
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.
- Theme and Language can be changed at any time. The current screenshots use the Light theme and English UI labels.
- Startup page controls the page opened after startup; Dashboard is the recommended default.
- Choose separate source and Organized Library output folders. MIDI archive and Generated files folders are optional.
- Choose a SoundFont file if you want FluidSynth playback. MIDI Manager does not bundle a SoundFont.
- Click Apply Settings and wait for the status bar to confirm that settings were saved.
- 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.
- Trial / Free uses the same Recognition quality as paid tiers and has no 25-analysis cap. Analysis, preview, review and planning do not use an output slot.
- The limit is 100 lifetime unique successfully verified Organized Library outputs. A failed copy uses no slot, content counted earlier is not counted again, output 100 is allowed, and a new unique 101st output is blocked before copying.
- At 100/100 you can still analyze, preview, review and plan; only a new uncounted copy is blocked.
- A validated licence is stored locally and can continue working offline according to the signed licence token.
- Treat licence keys, customer email addresses, device bindings and Device IDs as private. They are hidden in the public screenshot.
- Version 1.x licences remain valid for compatible 1.x releases according to the licence information shown in the app.
Upgrade & online help
- Compare licenses opens the live tier comparison page.
- Reserve MIDI Manager First 50 opens the early-adopter reservation page when that option is available for the current tier.
- Open MusicNote Haven opens the main website. External links use the desktop default browser.
- The Licensing page states current Organized Library usage and remaining capacity so Trial / Free users can see when output growth will be blocked.
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.2.2.
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.2.2 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, Technical MIDI Scan 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.
- All eight information panels stay visible; there is no hidden Technical details section.
- Organized Library statistics describe the managed output collection, including MIDI/KAR types, artists, favourites, missing files and lyrics state.
- Unsorted / Source is a physical inventory of the configured source folder. Not indexed and not classified are kept separate from confirmed no-lyrics files.
- MIDI Archive is counted from the configured physical archive folder, not from the total database row count.
- Refresh Dashboard rereads the database and physical folder state after another workflow changes the collection.
- The manual link at the bottom opens this online manual; every question-mark button opens the exact topic for its panel.
The eight Dashboard panels
These are the eight panels visible in the 1.2.2 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 Technical MIDI Scan 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 Technical MIDI Scan
Analyze contains two tabs. Analyze Library contains Step 1, Source Index and Step 2, Technical MIDI Scan; 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 Technical MIDI Scan
Analyze contains two tabs. Analyze Library contains Step 1, Source Index and Step 2, Technical MIDI Scan; 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.
- Run Update Source Index after first setup and after adding, replacing, moving or removing source files.
- Source Index records content fingerprints and physical source truth. Pure path moves are reconciled without forcing unchanged MIDI bytes through Technical MIDI Scan again.
- Large collections use bounded quick checks when Analyze opens. A previously completed Source Index remains valid across app restarts; opening Analyze does not recursively rescan the whole source tree.
- When Source Index itself runs, its completion report shows the exact physical discovery count plus new, moved/renamed, changed, removed, preserved and failed items.
- Run Source Index before Technical MIDI Scan. A later isolated source change does not invalidate the entire indexed collection.
Analyze: Source inventory
Advanced search of indexed source/unsorted records for diagnostics and pre-organization inspection. Normal collection search belongs to Library.
Step 2, Technical MIDI Scan
Step 2, Technical MIDI Scan opens only indexed MIDI/KAR files whose current technical analysis is missing or no longer current. It stores technical, quality, protocol, device and evidence data used by Review, Organize, Library and File Detail.
- Start / Resume Analysis processes only records that are not current for the active Technical MIDI Scan pipeline. Unchanged current results are reused.
- A pure file move does not require re-analysis when the content fingerprint is unchanged. Changed file content is analysed again once.
- Newly prepared files are handled end-to-end instead of first preparing thousands of rows, so progress begins with real resolved files.
- Stop Safely finishes and saves the current file before stopping. Start / Resume continues with the remaining files; completed work is retained.
- During a run, the status shows files resolved in this run, remaining files, speed, estimated time and the current file.
- Failures reach a terminal state instead of being retried endlessly. Review Failed analysis or repair the source file/path before retrying.
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
- Start / Resume Analysis is grey when Remaining is 0. Every indexed record already has a final state.
- It is grey before Step 1 has created indexed records.
- It is grey while Source Index or Technical MIDI Scan is already running.
- Stop Safely is grey when no analysis is running.
Analysis trust, score explanations and arranger/backing-track compatibility
- A current analysis stores provenance: analyzer/ruleset information and a source hash. Legacy analysis records explicitly ask you to reanalyse before current evidence is available.
- File Detail shows Why these scores? with the baseline, final value, ruleset and measured contributions for quality, corruption, event complexity and pattern complexity.
- Program changes are shown with raw channel/bank/program context. General MIDI names are reference labels only; device-specific bank/program semantics are not silently rewritten.
- The arranger/backing-track profile preserves direct evidence such as Bank Select, RPN/NRPN, pitch bend, manufacturer SysEx, MIDI Tuning Standard messages, markers/cues and lyrics.
- The compatibility profile is evidence-first. It does not infer a keyboard model, replacement sound or cultural origin from musical or protocol data.
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.
- Library → Organized Library provides database-backed text search plus Device and modes, Performance and content, Structure and analysis, Liked and Genre filters.
- Review → Failed analysis shows terminal analysis failures and can prepare selected files for a new Step 2, Technical MIDI Scan.
- Review → Review Queue is a safe working list; removing a queue row does not delete the MIDI/KAR file.
- File Detail shows analysis provenance, MIDI metadata, controller/message evidence, lyrics information and Deep Analysis results for the selected file.
- Single-file actions use the highlighted row; checked rows are used only where the page explicitly offers batch actions.
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.
Library: Organized Library
Search and filter the Organized Library: the managed collection intended for normal day-to-day lookup.
MIDI by Device
Browse analyzed MIDI files by detected manufacturer, mode and compatibility evidence such as Yamaha/XG, Roland/GS and Korg/GM.
Recognition 2.0: local-first identity evidence
Recognition combines filename and embedded metadata into artist/title hypotheses. It can use folder context and cleanup of karaoke suffixes and parenthetical title text as corroborating evidence. It selects the safest identity it can justify; it does not treat every plausible result as automatic.
- When the optional Offline Music Reference Database is installed, local reference lookup has priority and supports offline or high-volume work. Install it only from Settings by explicitly downloading it; MIDI Manager verifies the published SHA-256, can resume an interrupted download, and publishes the verified dataset atomically. Nothing downloads silently.
- If local lookup does not produce useful evidence, Online Music Reference is a fallback inside the normal Recognition route. It receives only a candidate artist and title: never MIDI/KAR bytes, filenames, local paths, profile data or library/database IDs.
- An Exact or Strong reference match is evidence, not a blanket permission to copy. Ambiguous direction, conflicting metadata or an uncertain identity remains Needs review. Your saved manual correction is authoritative and is not replaced by a later automatic suggestion.
Re-evaluate an existing library
Open Settings → Library Health → Advanced maintenance → Library intelligence & metadata. Re-evaluate Library rebuilds Recognition decisions against the current rules without requiring a new profile or a new database.
- Re-evaluation works on the existing indexed library. It can be stopped safely and resumed; completed per-file work and the saved preview remain available.
- Use Review Re-evaluate Library changes to inspect proposed artist, title, path or metadata corrections. Your explicit user correction remains authoritative.
- Before Apply selected changes, MIDI Manager performs a final safety check and shows executable versus blocked rows. Only selected, still-safe changes are applied.
Library Organizer: analyze, review, plan, execute and verify
Recognition combines filename and embedded metadata into artist/title hypotheses and uses local reference evidence where available. Library Organizer keeps analysis, planning, review, corrected-copy planning, execution and archive cleanup separate. It can already work with the current-DONE subset while Technical MIDI Scan is still finishing other files; pending, stale and failed analysis rows are excluded.
- 1 Organization analysis: process the next eligible current-DONE source batch. The analyzer classifies each result as Auto-safe, needs review or skipped.
- 2 Plan safe copies: build copy-only plans for open Auto-safe results. Planning does not copy, move or delete any source file.
- 3 Review: inspect the review backlog, approve a reference-supported identification or keep/correct your own artist and title decision.
- 4 Corrected copies: use Plan manual metadata corrections for approved manual corrections, or Plan reviewed identifications for saved review approvals. Existing open reviewed-identification plans are loaded again instead of silently creating a different job.
- 5 Execute + verify: load an approved copy job, execute the planned copies and verify the Organized Library targets. 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
- Archive + cleanup is deliberately separate from the five copy workflow steps. Opening the archive view is read-only.
- Archive actions must be explicitly selected and confirmed. Do not treat an Organizer copy plan as permission to delete its source file.
- Use the configured MIDI Archive as the review point before any final source cleanup. The status line reports what is previewed, archived, skipped or failed.
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.
- The first row may be selected automatically so file details are visible immediately.
- Double-click a row to play it. The play, pause and stop controls do not modify the file.
- Add Selected to Playback Queue builds a listening list. Add Selected to Disk Image Basket stages files for floppy IMG creation.
- The heart column marks liked files. Filters can show linked files and genre selections.
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.
- Move Up and Move Down change the order.
- Mark Played and Reset Played maintain listening state.
- Play Liked starts the liked subset; the active row shows NOW PLAYING.
- Remove Selected and Clear Queue remove queue records only. They do not remove MIDI/KAR files.
- Open Detail shows the full physical file path and metadata.
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.
- Add files to the Disk Image Basket from Organized Library or Review Queue.
- 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.
- Pack Basket assigns a disk number and position without writing IMG files yet.
- Review estimated and assigned disk counts, oversized files and order.
- Create IMG Files opens a Save dialog. Choose the output folder and a clear base name such as POP1-001.
- The app creates a numbered IMG series and a companion manifest.
FAT12 8.3 names and the sidecar manifest
- FAT12 stores short DOS-style 8.3 names. Long artist/title filenames must be shortened and collision-safe.
- The .mnh-img-manifest.json sidecar preserves official display names, disk numbers, positions and the generated 8.3 names.
- Keep the manifest beside the IMG files. Without it, IMG Viewer can still read FAT12 but cannot always recover the original long names.
- Do not manually rename only one IMG in a numbered set without also considering the manifest and reports.
IMG Viewer: Single IMG and Folder Catalog
IMG Viewer opens FAT12 IMG files, uses the manifest when available and provides two complementary views.
- Single IMG shows image metadata, capacity, official/display names, sizes, clusters, attributes and raw 8.3 names.
- Open IMG selects one image. Reload rereads the current image; Open Folder opens its filesystem folder.
- Folder Catalog scans all IMG files in a folder, optionally including subfolders.
- Disk overview shows status, disk number, filename, format and file counts.
- Master contents combines all scanned disks. Double-click a master row to open the corresponding disk in Single IMG.
- 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.
- Rebuild Genre Caches works locally. It rebuilds cached reference tags, restores verified Organizer links and applies only strict EXACT or STRONG local matches.
- Weak and conflicting matches are skipped. The confirmation explicitly states that MIDI/KAR files are not changed.
- Analyze Next 25 Artists performs up to 25 rate-limited online artist lookups, caches every completed artist immediately and rebuilds local caches afterwards.
- If the report shows 0 artists selected and 0 remaining uncached artists, there is no new artist work for that profile; this is not an error.
- Organized Library can filter With genre and then by a cached genre. Genre values may come from a larger established profile than the small first-start test set.
Settings → Library Health
Open Settings → Library Health. Start with the compact Library Health check; expand Advanced maintenance only when you need Database, Organized Library check, Library intelligence & metadata, Organized Library planning, Organized Library reset or Archive & cleanup.
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 reference-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.
- Check Library compares database state with physical files and reports stale records or other consistency issues without silently changing MIDI/KAR files.
- Find identical files uses full-content BLAKE3 identity. Exact copies are reported separately from filename/path history; the same filename and size with different content is not a duplicate.
- Advanced maintenance keeps database, Organized Library, intelligence/metadata, planning, reset and archive workflows separate so their scope is explicit.
- Re-evaluate Library refreshes Recognition decisions inside the existing profile/database. Stop Safely preserves completed work and the saved preview so the remaining work can be resumed later.
- Review Re-evaluate Library changes before Apply selected changes. Only selected changes that still pass the final safety check are applied.
- Archive & cleanup remains preview-first. Read the report and verify the archive target before any later destructive cleanup.
Empty Organized Library: deliberate reset
- Open Settings → Library Health → Advanced maintenance → Organized Library reset and choose Empty Organized Library. The app asks for two confirmations before permanently removing files from the configured Organized Library output folder.
- The reset also clears Organizer copy records, derived index rows and saved analysis previews for that output root, so you can start a fresh organization run. It does not remove, move, rename or delete source-library files.
- This reset is not source cleanup. Check the configured output root carefully and keep an independent backup of anything you want to retain.
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
- No files on Dashboard: verify the source folder, then open Analyze → Analyze Library and click Update Source Index.
- Step 2 buttons grey: check Remaining, indexed records and whether another job is running; follow the grey-button recovery steps above.
- Playback unavailable: verify the SoundFont path, FluidSynth/platform support and audio output.
- Source/parser failures: reconnect drives or shares, verify file permissions and inspect Failed Analysis Review.
- Deep failures: inspect the exact error; damaged or truncated MIDI/KAR files may remain terminally failed.
- Device filters empty: complete Technical MIDI Scan and try another device/mode filter.
- No genres: rebuild local caches, then analyze uncached artists where appropriate. Not every file or artist will receive a genre.
- Duplicate Organized Library names: use preview and collision-safe planning; do not manually overwrite files.
- IMG warnings: open the Technical Problem Report and keep the manifest beside the IMG files.
Beginner checklist before using a large collection
- Install the correct platform build and read the installation guide.
- Create or choose separate source, Organized Library, archive and generated-output folders.
- Choose a legal SoundFont and confirm playback with one file.
- Review Trial / Free limits or activate and save the required licence.
- Run Source Index and compare discovered/indexed counts with the source folder.
- Run Technical MIDI Scan; use Stop Safely when needed and resume later.
- Review Deep complete, Deep failed, Source/parser failed and Remaining.
- Test Library → Organized Library, Review → Failed analysis and Review → Review Queue. Inspect File Detail provenance after analysis.
- Re-evaluate an existing library: Open Settings → Library Health → Library intelligence & metadata. Choose Re-evaluate Library to build a read-only preview with the current Recognition and analysis pipeline. You keep the existing profile and database; a new library or profile is not required.
- Run one small Library Organizer Organization analysis and inspect safe-to-copy, needs-review and skipped decisions.
- Plan and execute only reviewed copy jobs; verify source files remain untouched.
- Verify Organized Library playback and queue behaviour.
- Create a small IMG set, keep its manifest, scan it in Folder Catalog and generate finder/problem reports.
- Use Maintenance preview/check actions before repair or cleanup.
- Keep independent backups and record the app version when requesting support.