# drumfort42/musictoolkit architecture

> Architecture diagram of the GitHub repository drumfort42/musictoolkit, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/drumfort42/musictoolkit
- Repository: https://github.com/drumfort42/musictoolkit

## Overview

Music Toolkit is a notebook-based audio utility for analyzing, converting, and moving audio, with folder-based genre tagging and audio-property extraction. The README describes configuration of FFmpeg and input/output folders, but the available source excerpts contain no notebook code, so internal calls and data flow cannot be verified. The graph preserves the documented capabilities and the notebooks named in the tree without asserting unsupported connections between them.

Main entry points: [`mp3-analysis.ipynb`](https://github.com/drumfort42/musictoolkit/blob/main/mp3-analysis.ipynb) (Audio analysis), [`config.yml.example`](https://github.com/drumfort42/musictoolkit/blob/main/config.yml.example) (Audio configuration), [`mp3convert.ipynb`](https://github.com/drumfort42/musictoolkit/blob/main/mp3convert.ipynb) (Convert and move), [`genre-tagger.ipynb`](https://github.com/drumfort42/musictoolkit/blob/main/genre-tagger.ipynb) (Folder genre tagging)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_audio_ops["Audio operations"]
  node_config["Audio configuration<br/>[config.yml.example]"]
  node_conversion["Convert and move<br/>[mp3convert.ipynb]"]
end

subgraph group_tagging["Genre tagging"]
  node_genre_tagging["Folder genre tagging<br/>[genre-tagger.ipynb]"]
end

subgraph group_analysis["Audio analysis"]
  node_audio_analysis["Audio analysis<br/>[mp3-analysis.ipynb]"]
  node_audio_metrics["Audio characteristics<br/>[mp3-analysis.ipynb]"]
end

node_user(("User"))

node_user -->|"sets paths"| node_config
node_user -.->|"converts audio"| node_conversion
node_user -.->|"tags by folder"| node_genre_tagging
node_user -.->|"analyzes audio"| node_audio_analysis
node_audio_analysis -.->|"extracts metrics"| node_audio_metrics

click node_config "https://github.com/drumfort42/musictoolkit/blob/main/config.yml.example"
click node_conversion "https://github.com/drumfort42/musictoolkit/blob/main/mp3convert.ipynb"
click node_genre_tagging "https://github.com/drumfort42/musictoolkit/blob/main/genre-tagger.ipynb"
click node_audio_analysis "https://github.com/drumfort42/musictoolkit/blob/main/mp3-analysis.ipynb"
click node_audio_metrics "https://github.com/drumfort42/musictoolkit/blob/main/mp3-analysis.ipynb"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_config,node_conversion,node_user toneBlue
class node_genre_tagging toneAmber
class node_audio_analysis,node_audio_metrics toneMint
```

## Components

### Audio operations

- [Audio configuration](https://github.com/drumfort42/musictoolkit/blob/main/config.yml.example): `config.yml.example`
- [Convert and move](https://github.com/drumfort42/musictoolkit/blob/main/mp3convert.ipynb): `mp3convert.ipynb`

### Genre tagging

- [Folder genre tagging](https://github.com/drumfort42/musictoolkit/blob/main/genre-tagger.ipynb): `genre-tagger.ipynb`

### Audio analysis

- [Audio analysis](https://github.com/drumfort42/musictoolkit/blob/main/mp3-analysis.ipynb): `mp3-analysis.ipynb`
- [Audio characteristics](https://github.com/drumfort42/musictoolkit/blob/main/mp3-analysis.ipynb): `mp3-analysis.ipynb`

### Other components

- **User**

## Connections

- User → Audio configuration: sets paths (evidence: `README.md`)
- User → Convert and move: converts audio
- User → Folder genre tagging: tags by folder
- User → Audio analysis: analyzes audio
- Audio analysis → Audio characteristics: extracts metrics
