# mdeff/fma

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/mdeff-fma).**

2,559 stars · 458 forks · Jupyter Notebook · mit

## Links

- GitHub: https://github.com/mdeff/fma
- Homepage: https://arxiv.org/abs/1612.01840
- awesome-repositories: https://awesome-repositories.com/repository/mdeff-fma.md

## Topics

`dataset` `deep-learning` `music-analysis` `music-information-retrieval` `open-data` `open-science` `reproducible-research`

## Description

This project is a music information retrieval library and research dataset designed for audio feature extraction and music genre classification. It provides a framework for training and evaluating machine learning models that categorize audio tracks into hierarchical genre structures, supported by a collection of open-licensed MP3 tracks and pre-computed features.

The project includes a music metadata API client to fetch structured track, album, and artist information from external data sources. It utilizes these external integrations to map parent-child relationships between genres and organize music libraries.

The system covers a broad range of capabilities including audio feature analysis, music dataset management, and the implementation of baseline models for genre recognition. It also facilitates the downloading and syncing of remote audio files for local offline analysis and the indexing of music collections based on computed audio characteristics.

The project utilizes interactive computation notebooks for feature extraction and the generation of analysis results.

## Tags

### Artificial Intelligence & ML

- [Music Genre Classifiers](https://awesome-repositories.com/f/artificial-intelligence-ml/music-genre-classifiers.md) — Implements a framework for training and evaluating models that categorize audio tracks into hierarchical genre structures.
- [Audio Genre Classification](https://awesome-repositories.com/f/artificial-intelligence-ml/machine-learning-classification/audio-genre-classification.md) — Trains and evaluates machine learning models to automatically categorize music tracks into specific genres.

### Graphics & Multimedia

- [Audio Feature Extraction](https://awesome-repositories.com/f/graphics-multimedia/media-processing-analysis/media-manipulation/media-processing-workflows/audio-analysis-synthesis/audio-feature-extraction.md) — Extracts technical audio characteristics from raw files to create feature sets for machine learning.
- [Feature-Based Indexing](https://awesome-repositories.com/f/graphics-multimedia/media-processing-analysis/media-manipulation/media-processing-workflows/audio-analysis-synthesis/audio-feature-extraction/feature-based-indexing.md) — Organizes large music collections by mapping pre-computed audio characteristics to searchable datasets for efficient retrieval.
- [Music Metadata Retrieval](https://awesome-repositories.com/f/graphics-multimedia/music-metadata-retrieval.md) — Implements systems for retrieving detailed track, album, and artist information from external databases. ([source](https://github.com/mdeff/fma/blob/master/utils.py))
- [Genre Hierarchies](https://awesome-repositories.com/f/graphics-multimedia/music-metadata-retrieval/genre-hierarchies.md) — Provides capabilities to fetch and map hierarchical relationships between music genres for library organization. ([source](https://github.com/mdeff/fma/blob/master/utils.py))
- [Music Collection Organization](https://awesome-repositories.com/f/graphics-multimedia/music-collection-organization.md) — Analyzes pre-computed audio data to facilitate browsing, searching, and organizing large music collections. ([source](https://github.com/mdeff/fma/blob/master/usage.ipynb))
- [Open-Licensed Media Datasets](https://awesome-repositories.com/f/graphics-multimedia/open-licensed-media-datasets.md) — The project provides audio files and metadata under open licenses to train and evaluate retrieval systems. ([source](https://github.com/mdeff/fma/blob/master/setup.py))
- [Audio-Only Downloads](https://awesome-repositories.com/f/graphics-multimedia/video-downloaders/audio-only-downloads.md) — Enables fetching audio tracks from remote servers for local offline processing. ([source](https://github.com/mdeff/fma/blob/master/utils.py))

### Part of an Awesome List

- [Music Information Retrieval](https://awesome-repositories.com/f/awesome-lists/ai/music-information-retrieval.md) — Extracts audio features and metadata from music files to search and organize large audio collections.
- [Genre Recognition Training](https://awesome-repositories.com/f/awesome-lists/media/audio-and-music/genre-recognition-training.md) — Provides tools to develop and evaluate audio-based music classification systems using baseline implementations. ([source](https://github.com/mdeff/fma#readme))
- [Computer Vision and Audio](https://awesome-repositories.com/f/awesome-lists/ai/computer-vision-and-audio.md) — Dataset for music genre recognition and audio analysis.

### Data & Databases

- [Audio Research Datasets](https://awesome-repositories.com/f/data-databases/audio-research-datasets.md) — Provides access to a large collection of MP3-encoded music tracks and metadata for research purposes. ([source](https://github.com/mdeff/fma/blob/master/README.md))
- [Research Datasets](https://awesome-repositories.com/f/data-databases/research-datasets.md) — Facilitates the retrieval of large collections of MP3 tracks paired with metadata and genre hierarchies for validation. ([source](https://github.com/mdeff/fma#readme))
- [Remote-to-Local Materialization](https://awesome-repositories.com/f/data-databases/local-data-stores/remote-to-local-materialization.md) — Downloads and persists filtered subsets of remote MP3 datasets into local storage for offline analysis.
- [Music Metadata Indexing](https://awesome-repositories.com/f/data-databases/sqlite-extensions/metadata-indexing-systems/music-metadata-indexing.md) — Utilizes structured tables of track IDs and genre mappings to index and organize music collections. ([source](https://github.com/mdeff/fma#readme))

### Education & Learning Resources

- [ML Baseline Implementations](https://awesome-repositories.com/f/education-learning-resources/educational-resources/reference-and-media/books-docs-reference/code-examples/reference-implementations/ml-baseline-implementations.md) — Provides canonical model implementations to establish performance baselines for audio-based genre recognition.

### Web Development

- [Music Metadata Integration](https://awesome-repositories.com/f/web-development/api-metadata-generators/metadata-integration-apis/music-metadata-integration.md) — Retrieves and maps structured artist and track information from external APIs to organize music libraries.

### Content Management & Publishing

- [External Metadata Integration](https://awesome-repositories.com/f/content-management-publishing/external-metadata-integration.md) — Enriches local datasets by fetching descriptive metadata and genre hierarchies from external databases.

### Development Tools & Productivity

- [Notebook Execution Environments](https://awesome-repositories.com/f/development-tools-productivity/code-execution-environments/notebook-execution-environments.md) — Supports the execution of interactive notebooks to pre-compute features and generate analysis results. ([source](https://github.com/mdeff/fma/blob/master/makefile))
- [Music Server API Clients](https://awesome-repositories.com/f/development-tools-productivity/rest-apis/rest-api-clients/music-server-api-clients.md) — Provides client-side implementations for interacting with music web services to retrieve and update dataset information. ([source](https://github.com/mdeff/fma/blob/master/README.md))
