{"id":13657179,"url":"https://github.com/GuitarML/TS-M1N3","last_synced_at":"2025-04-24T01:31:30.811Z","repository":{"id":43820817,"uuid":"424011115","full_name":"GuitarML/TS-M1N3","owner":"GuitarML","description":"TS-9 guitar pedal clone using neural networks.","archived":false,"fork":false,"pushed_at":"2023-01-05T14:58:36.000Z","size":1892,"stargazers_count":53,"open_issues_count":1,"forks_count":5,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-10-29T21:06:48.622Z","etag":null,"topics":["audio-processing","guitar","machine-learning","neural-network"],"latest_commit_sha":null,"homepage":"https://guitarml.com/","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GuitarML.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":["GuitarML"],"patreon":"GuitarML","custom":"https://www.paypal.com/donate?business=H22K2S7B7ACMJ\u0026no_recurring=0\u0026item_name=Support+GuitarML\u0026currency_code=USD"}},"created_at":"2021-11-02T21:59:14.000Z","updated_at":"2024-10-18T09:23:18.000Z","dependencies_parsed_at":"2023-02-04T06:15:34.717Z","dependency_job_id":null,"html_url":"https://github.com/GuitarML/TS-M1N3","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GuitarML%2FTS-M1N3","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GuitarML%2FTS-M1N3/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GuitarML%2FTS-M1N3/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GuitarML%2FTS-M1N3/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GuitarML","download_url":"https://codeload.github.com/GuitarML/TS-M1N3/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223940865,"owners_count":17228913,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["audio-processing","guitar","machine-learning","neural-network"],"created_at":"2024-08-02T05:00:38.156Z","updated_at":"2024-11-10T10:30:49.222Z","avatar_url":"https://github.com/GuitarML.png","language":"C++","funding_links":["https://github.com/sponsors/GuitarML","https://patreon.com/GuitarML","https://www.paypal.com/donate?business=H22K2S7B7ACMJ\u0026no_recurring=0\u0026item_name=Support+GuitarML\u0026currency_code=USD"],"categories":["C++"],"sub_categories":[],"readme":"# TS-M1N3\n\n[![CI](https://github.com/GuitarML/TS-M1N3/actions/workflows/cmake.yml/badge.svg)](https://github.com/GuitarML/TS-M1N3/actions/workflows/cmake.yml) [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-brightgreen.svg)](https://www.gnu.org/licenses/gpl-3.0) [![Downloads](https://img.shields.io/github/downloads/GuitarML/TS-M1N3/total)](https://somsubhra.github.io/github-release-stats/?username=GuitarML\u0026repository=TS-M1N3\u0026page=1\u0026per_page=30)\n\n![app](https://github.com/GuitarML/TS-M1N3/blob/main/resources/app.jpg)\n\nTS-M1N3 is a guitar plugin clone of the TS-9 Tubescreamer overdrive pedal. Machine learning was used to train a model of both the drive and tone knobs for an accurate recreation of the pedal in all possible configurations. This plugin uses two conditioned parameters during model training to recreate the entire device using machine learning, as opposed to snapshot models at a particular setting. For best results, use prior to amp -\u003e cabinet -\u003e reverb effects to fully simulate playing an overdrive pedal through a physical amplifier. This can be done with the [NeuralPi](https://github.com/GuitarML/NeuralPi) plugin.\n\nCheck out a video demo on [Youtube](https://youtu.be/QVlmr_bECBE)\n\n## Installing the plugin\n\n1. Download the appropriate plugin installer [here](https://github.com/GuitarML/TS-M1N3/releases) (Windows, Mac, Linux)\n2. Run the installer and follow the instructions. May need to reboot to allow your DAW to recognize the new plugin.\n\n## Info\n\nThe [Automated-GuitarAmpModelling](https://github.com/Alec-Wright/Automated-GuitarAmpModelling) project was used to train the .json models.\u003cbr\u003e\nGuitarML maintains a [fork](https://github.com/GuitarML/Automated-GuitarAmpModelling) with a few extra helpful features, including a Colab training script and wav file processing for conditioned parameters.\n\nThe plugin uses [RTNeural](https://github.com/jatinchowdhury18/RTNeural), which is a highly optimized neural net inference engine intended for audio applications.\n\nFor the training data, five steps for the gain and tone knobs were recorded (0.0, 0.25, 0.50, 0.75, 1.0), for a total of 25 output samples at 2 minutes each. An LSTM layer with a hidden size of 20 was used.\n\n## Build Instructions\n\n### Build with Cmake\n\n```bash\n# Clone the repository\n$ git clone https://github.com/GuitarML/TS-M1N3.git\n$ cd TS-M1N3\n\n# initialize and set up submodules\n$ git submodule update --init --recursive\n\n# build with CMake\n$ cmake -Bbuild\n$ cmake --build build --config Release\n```\nThe binaries will be located in `TS-M1N3/build/TS-M1N3_artefacts/`\n\n### Special Thanks\nSpecial thanks to the UAH (University of Alabama in Huntsville) [MLAMSK](https://github.com/mlamsk) Senior Design Team, whose research and hard work directly impacted the development of this plugin.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FGuitarML%2FTS-M1N3","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FGuitarML%2FTS-M1N3","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FGuitarML%2FTS-M1N3/lists"}