How adna1206/karaoke-toolkit works
Karaoke Toolkit is a local karaoke-file management product with an Avalonia desktop app plus CLI and MCP entry points. Users choose files or folders, select an operation, review options, and receive converted or managed files and a completion report. The Core execution layer dispatches operations into conversion, tagging, validation, recipes, and file-management workflows; staged transactions and recovery journals protect publication and support resuming interrupted work. The README documents the major capability branches; some GUI wiring and unsampled implementations are represented only where documented, rather than inferred from names.
Main entry points: OperationExecutionService.cs Operation Dispatch · ConversionService.cs Conversion Engine · App.axaml.cs Desktop App · KaraokeTaggingService.cs Metadata Tagging
Components 21
User Interfaces
- Desktop App
KaraokeToolkit.App/App.axaml.cs - CLI
KaraokeToolkit.Cli/CliApplication.cs - MCP Tools
KaraokeToolkit.Mcp/McpTools.cs
Workflow Execution
- Operation Dispatch
KaraokeToolkit.Core/Execution/OperationExecutionService.cs - Input Selection
KaraokeToolkit.Core/Conversion/InputSelection.cs - Conversion Workflow
KaraokeToolkit.Core/Conversion/SelectionConversionService.cs - Recipes
KaraokeToolkit.Core/Recipes/RecipeRunner.cs
Media Processing
- Conversion Engine
KaraokeToolkit.Core/Conversion/ConversionService.cs - Karaoke Archives
KaraokeToolkit.Core/Archives/ArchiveZipConverter.cs - Audio Encoding
KaraokeToolkit.Core/Audio/AudioEncoderService.cs - Video Encoding
KaraokeToolkit.Core/Video/VideoEncoderService.cs - Disc Ripping
KaraokeToolkit.Core/DiscRipping/DiscRipService.cs
File Management
- Metadata Tagging
KaraokeToolkit.Core/Tagging/KaraokeTaggingService.cs - Karaoke Validation
KaraokeToolkit.Core/Validation/ValidationService.cs - File Organization
KaraokeToolkit.Core/FileOperations/TrackGroupingPlanner.cs - Completion Reports
KaraokeToolkit.Core/Reporting/CompletionReport.cs
Settings and Recovery
- User Settings
KaraokeToolkit.Core/Settings/SettingsStore.cs - File Transactions
KaraokeToolkit.Core/Recovery/FileTransaction.cs - Recovery Store
KaraokeToolkit.Core/Recovery/RecoveryStore.cs - Workflow Journal
KaraokeToolkit.Core/Recovery/WorkflowSession.cs
Other components
- User
Connections 30
- User → Desktop App: chooses tools
README.md - User → CLI: runs commands
README.md - User → MCP Tools: invokes tools
README.md - Desktop App → Operation Dispatch: runs operations
- CLI → Operation Dispatch: executes requests
- MCP Tools → Operation Dispatch: executes requests
- Operation Dispatch → Input Selection: expands inputs
KaraokeToolkit.Core/Execution/OperationExecutionService.cs - Operation Dispatch → Conversion Workflow: dispatches conversions
KaraokeToolkit.Core/Execution/OperationExecutionService.cs - Operation Dispatch → Metadata Tagging: dispatches tagging
KaraokeToolkit.Core/Execution/OperationExecutionService.cs - Operation Dispatch → Karaoke Validation: dispatches validation
KaraokeToolkit.Core/Execution/OperationExecutionService.cs - Operation Dispatch → File Organization: dispatches file tasks
KaraokeToolkit.Core/Execution/OperationExecutionService.cs - Conversion Workflow → Conversion Engine: runs batches
KaraokeToolkit.Core/Conversion/SelectionConversionService.cs - Conversion Engine → Karaoke Validation: validates inputs
KaraokeToolkit.Core/Conversion/ConversionService.cs - Conversion Engine → File Transactions: publishes outputs
KaraokeToolkit.Core/Conversion/ConversionService.cs - Conversion Engine → Karaoke Archives: converts archives
KaraokeToolkit.Core/Conversion/ConversionService.cs - Conversion Engine → Audio Encoding: encodes audio
KaraokeToolkit.Core/Conversion/ConversionService.cs - Conversion Engine → Video Encoding: creates video
KaraokeToolkit.Core/Conversion/ConversionService.cs - Operation Dispatch → Recipes: runs workflows
KaraokeToolkit.Core/Execution/OperationExecutionService.cs - Recipes → Workflow Journal: saves progress
KaraokeToolkit.Core/Recovery/WorkflowSession.cs - Operation Dispatch → Disc Ripping: supports ripping
- Operation Dispatch → Completion Reports: returns results
KaraokeToolkit.Core/Execution/OperationExecutionService.cs - Metadata Tagging → File Transactions: stages updates
KaraokeToolkit.Core/Tagging/KaraokeTaggingService.cs - File Transactions → Recovery Store: registers journals
KaraokeToolkit.Core/Recovery/RecoveryStore.cs - Workflow Journal → Recovery Store: registers journal
KaraokeToolkit.Core/Recovery/WorkflowSession.cs - Desktop App → User Settings: stores preferences
- User → Karaoke Validation: checks files
README.md - User → Metadata Tagging: edits metadata
README.md - User → File Organization: organizes files
README.md - User → Disc Ripping: rips discs
README.md - User → Recovery Store: resumes work
README.md