MIDI Software Center

A high-performance MIDI library management system for organizing, analyzing, and working with large-scale MIDI collections.

Overview

MIDI Software Center manages 2.15M+ MIDI files with advanced musical analysis, deduplication, and organization capabilities. Built with Rust and Tauri for maximum performance.

Key Features

• High-Speed Import: 7,830 files/sec with automatic deduplication
• Musical Analysis: BPM detection, key detection, chord analysis, drum pattern recognition
• Smart Organization: 97 instrument categories, 1,861 tag types, 7.9M+ tags applied
• Auto-Repair: Fixes corrupted MIDI files automatically (99.5% success rate)
• Track Splitting: Separates multi-track files into individual tracks
• Full-Text Search: Meilisearch integration for instant search
• DAW Integration: Real-time MIDI I/O, sequencer, piano roll editor

Performance

Architecture

midi-software-center/
├── app/                    # Main Tauri application (unified)
│   ├── src/               # Svelte/TypeScript frontend
│   └── src-tauri/         # Rust backend (midi-software-center)
├── database/               # PostgreSQL migrations and schemas
├── scripts/                # Automation and utility scripts
│   ├── import-tool/       # CLI import utilities
│   └── test-midi-files/   # MIDI testing tool
└── verification/           # Verification suite

Unified Application

The application combines all functionality in a single codebase:

Technology Stack

Backend:

• Rust 2021 Edition with Tokio async runtime
• Tauri 2.0 for desktop application framework
• SQLx 0.7 for type-safe database queries
• midly 0.5 for MIDI parsing

Frontend:

• Svelte 5 with TypeScript 5.3
• Vite 5.0 build system
• Tailwind CSS

Database:

• PostgreSQL 16 with 15 tables and 60+ indexes
• pgvector for similarity search
• Meilisearch 1.5 for full-text search

Quick Start

Prerequisites

• Rust 1.75+
• Node.js 20+ and pnpm 8+
• PostgreSQL 16
• Docker (optional, for containerized database)

Installation

# Clone the repository
git clone https://github.com/dojevou/midi-software-center.git
cd midi-software-center

# Setup (installs dependencies, starts database)
make setup
make docker-up

# Run database migrations
make db-migrate

# Start development server
make dev    # Launches application at :5173

Running the Pipeline

# Import MIDI files (ultra-fast mode)
./scripts/run-pipeline-ultra-fast.sh /path/to/midi/files

# Apply instrument organization (97 categories)
./scripts/organize-database.sh

# Monitor progress
./scripts/monitor-pipeline.sh

# Check database statistics
psql "postgresql://midiuser:145278963@localhost:5433/midi_library" \
  -c "SELECT COUNT(*) as total_files FROM files"

Database Schema

The system uses PostgreSQL with 15 tables:

Example Queries

-- Find all drum files at 120 BPM
SELECT f.filename, m.bpm, m.key_signature
FROM files f
JOIN musical_metadata m ON f.id = m.file_id
JOIN file_tags ft ON f.id = ft.file_id
JOIN tags t ON ft.tag_id = t.id
WHERE t.name = 'drums' AND m.bpm BETWEEN 118 AND 122;

-- Get files by instrument (built-in function)
SELECT * FROM get_files_by_instrument('piano');

-- Get files by BPM range
SELECT * FROM get_files_by_bpm_range(118, 122);

-- Search by multiple instruments
SELECT * FROM get_files_by_instruments(ARRAY['jazz', 'piano']);

Development

Make Commands

# Development
make dev               # Start dev server

# Building
make build-all         # Build all components
make build-release     # Production build

# Testing
make test              # Run all tests
make check             # Lint and type check
make format            # Format code

# Database
make db-migrate        # Run migrations
make db-backup         # Backup database
make db-reset          # Reset database (destructive!)

Running Tests

# All workspace tests
cargo test --workspace --lib

# Main application tests
cargo test --package midi-software-center --lib

# Verification suite
cargo test --package verification

# With coverage
cargo tarpaulin --workspace --out Html

Current Test Status: 1,999 tests passing

Key Files

Pipeline Phases

Recommended Order: Import -> Sanitize -> Split -> Analyze -> Rename

Configuration

Environment Variables

DATABASE_URL=postgresql://midiuser:password@localhost:5433/midi_library
MEILISEARCH_URL=http://localhost:7700
RUST_LOG=info

Docker Compose

# Start services
docker-compose up -d

# View logs
docker-compose logs -f postgres

# Stop services
docker-compose down

API Reference

Tauri Commands

The application exposes commands via Tauri's IPC system:

// Import files
await invoke('import_files', { paths: ['/path/to/midi'] });

// Search files
await invoke('search_files', {
  query: 'drum loop',
  bpmMin: 118,
  bpmMax: 122
});

// Get file details
await invoke('get_file_details', { fileId: 12345 });

// Analyze file
await invoke('analyze_file', { fileId: 12345 });

Repository Methods

// File operations
file_repository.insert_file(&file).await?;
file_repository.find_by_hash(&hash).await?;
file_repository.search(&query, limit, offset).await?;

// Metadata operations
metadata_repository.get_by_file_id(file_id).await?;
metadata_repository.update_bpm(file_id, bpm).await?;

// Tag operations
tag_repository.add_tags(file_id, &tags).await?;
tag_repository.get_files_by_tag("drums").await?;

License

This project is proprietary software. All rights reserved.

Status: Production Ready | Tests: 1,999 passing | Files Managed: 2.15M+ | Tags: 7.9M+