Skip to content
BranchesTags

Repository files navigation

BCho TONEX Loader

BCho TONEX Loader

Carga presets .txp en tu IK Multimedia TONEX One y TONEX Pedal por USB — sin abrir el editor oficial.
Load .txp presets onto your IK Multimedia TONEX One and TONEX Pedal over USB — without the official editor.

Ayuda activacion Ko-fi

Release Plataformas MIT

Español | English

Español

Herramienta de código abierto (Go + Wails) para subir presets .txp a un IK Multimedia TONEX One o TONEX Pedal por USB, detectando automáticamente qué pedal tienes conectado y adaptando la interfaz a cada uno.

⚠️ No sustituye al TONEX Editor. No crea, edita, captura ni entrena modelos de amplificador. Su trabajo es mover presets .txp al pedal, leerlos y gestionarlos directamente por USB.

Compatibilidad

TONEX One TONEX Pedal
Slots / presets 20 150 (50 bancos × 3)
Numeración en la app 1–20 0–149 (igual que la pantalla del pedal)
Subir .txp ✅ ✅
Exportar slot a .txp ✅ ✅
Cambiar preset activo desde la app — (usa A/B/Stomp) ✅ clic en un slot
Reflejar en la app el footswitch del pedal ✅ (A/B/Stomp activo) ✅ (preset activo en vivo)
Asignar slots a A / B / Stomp ✅ — (el Pedal usa bancos)
Color del LED por slot ✅ —

La app detecta el modelo por USB. Si por lo que sea no lo reconoce, puedes elegir el puerto COM a mano y la conexión identifica el pedal al conectar.

Funciones

  • Detección automática del modelo (One / Pedal) y UI adaptada a cada uno.
  • Leer todos los presets del pedal en vivo (nombre, character, ampli, pantalla, efectos).
  • Subir cualquier .txp a cualquier slot: arrastrándolo a la ventana, con Abrir .txp, o clic derecho en un slot → Subir aquí. Si sueltas varios, se cargan en slots consecutivos.
  • Exportar un slot del pedal de vuelta a .txp (fiel, o con firma BCho).
  • Cambio de preset bidireccional (TONEX Pedal): clic en un slot → el pedal cambia a ese preset; y al pisar el footswitch del pedal, la app resalta el preset activo al instante.
  • Asignar un slot a A / B / Stomp y cambiar el color del LED (solo TONEX One).
  • Backup y Restore completos: Backup exporta todos los slots a un único .zip (un .txp por slot + un manifest.json con asignaciones A/B/Stomp y colores de LED), y Restaurar vuelve a cargar ese .zip en el pedal. Ideal para migrar a otro pedal, recuperar tras un reset o clonar una configuración.
  • Recarga solo el slot cambiado tras una subida (rápido, sobre todo con 150 presets).
  • Interfaz en español / inglés con selector de idioma.

Descarga

Ve a la pestaña Releases y descarga el paquete de tu sistema:

  • Windows: BCho-TONEX-Loader-windows-amd64.zip
  • macOS: BCho-TONEX-Loader-macos-intel.zip (Intel) · BCho-TONEX-Loader-macos-apple-silicon.zip (Apple Silicon)
  • Linux: BCho-TONEX-Loader-linux-amd64.tar.gz

Todos los paquetes incluyen AYUDA_ACTIVACION_KOFI.html, con instrucciones de activacion Ko-fi en todos los idiomas de la app.

Requisitos mínimos de ejecución: Windows 10 1809 o superior de 64 bits con Microsoft WebView2 Runtime; macOS 11.0 Big Sur o superior (Catalina 10.15 no se considera compatible con estas builds; Mojave 10.14 o anterior no está soportado); Linux 64 bits moderno con glibc 2.31+ y WebKit2GTK 4.0/4.1 instalado.

Windows: descarga en ZIP y posible aviso de SmartScreen

La descarga de Windows se publica como .zip para reducir bloqueos de navegador o Windows Defender sobre ejecutables sueltos. Extrae el .zip y ejecuta BCho-TONEX-Loader.exe.

Al abrir el .exe por primera vez todavia puede aparecer una pantalla azul de Windows SmartScreen diciendo "Windows protegió tu PC" / editor desconocido.

No es un virus. Ocurre porque la aplicación no está firmada digitalmente (un certificado de firma cuesta dinero) y, al ser un binario nuevo, todavía no tiene "reputación" en Windows. El proyecto es de código abierto: puedes revisar el código o compilarlo tú mismo.

Para ejecutarla igualmente:

  1. En el aviso azul, pulsa Más información.
  2. Pulsa Ejecutar de todas formas.

(Solo hace falta hacerlo la primera vez.) Si tu navegador bloquea la descarga, elige Conservar / Mantener.

Uso básico

  1. Conecta el pedal (TONEX One o TONEX Pedal) por USB.
  2. Cierra el TONEX Editor si está abierto (solo un programa puede usar el puerto a la vez).
  3. Abre la aplicación: detecta el pedal y lee sus presets.
  4. Arrastra un .txp a la ventana — o pulsa Abrir .txp — y elige el slot de destino.
  5. TONEX Pedal: haz clic en un slot para que el pedal cambie a ese preset. TONEX One: carga el slot en A/B/Stomp para oírlo.

Compilar desde el código fuente

Requisitos: Go 1.25+, Node.js 18+, Wails v2.

git clone https://github.com/bchosoft/bcho-tonex-loader.git
cd bcho-tonex-loader
go test ./...
wails build

El ejecutable queda en build/bin/.

Estructura del proyecto

  • app.go — backend Wails expuesto al frontend; serializa el acceso al pedal y expone leer/subir/exportar/seleccionar.
  • main.go — arranque de la app Wails.
  • internal/device — comunicación serie/USB; detección de modelo y protocolo por pedal.
  • internal/librarian — workflows de alto nivel: snapshot, subida, exportación, asignación, color, selección y polling.
  • internal/upload — parser/conversor entre .txp y el payload en el cable (One y Pedal).
  • internal/preset — parseo de presets/estado y codificación de comandos.
  • internal/assets — plantillas de subida embebidas (One y Pedal).
  • frontend/ — interfaz de usuario (HTML/CSS/JS vanilla).

Apoya el proyecto

Si te resulta útil, puedes invitarme a un café: ko-fi.com/bchosoft ☕

Licencia

MIT — software libre, úsalo, modifícalo y redistribúyelo como quieras.

Este proyecto no está afiliado ni respaldado por IK Multimedia. "TONEX" es marca de IK Multimedia. Úsalo bajo tu responsabilidad.

English

BCho TONEX Loader

Open-source tool (Go + Wails) to upload .txp presets to an IK Multimedia TONEX One or TONEX Pedal over USB. It auto-detects which pedal is connected and adapts the UI to each one.

⚠️ It is not a replacement for the TONEX Editor. It does not create, edit, capture or train amp models. Its job is to move .txp presets to the pedal, read them and manage them directly over USB.

Compatibility

TONEX One TONEX Pedal
Slots / presets 20 150 (50 banks × 3)
Numbering in the app 1–20 0–149 (matches the pedal screen)
Upload .txp ✅ ✅
Export slot to .txp ✅ ✅
Change active preset from the app — (uses A/B/Stomp) ✅ click a slot
Reflect the pedal's footswitch in the app ✅ (active A/B/Stomp) ✅ (live active preset)
Assign slots to A / B / Stomp ✅ — (the Pedal uses banks)
Per-slot LED colour ✅ —

The app detects the model over USB. If it can't, you can pick the COM port manually and the connection identifies the pedal on connect.

Features

  • Auto-detect the model (One / Pedal) with a UI tailored to each.
  • Read all pedal presets live (name, character, amp, cab, effects).
  • Upload any .txp to any slot: drag onto the window, use Open .txp, or right-click a slot → Upload here. Drop several and they fill consecutive slots.
  • Export a pedal slot back to .txp (faithful, or with BCho signature).
  • Bidirectional preset switching (TONEX Pedal): click a slot → the pedal jumps to it; press the pedal's footswitch → the app highlights the active preset instantly.
  • Assign a slot to A / B / Stomp and change the LED colour (TONEX One only).
  • Full Backup & Restore: Backup exports every slot to a single .zip (one .txp per slot + a manifest.json with A/B/Stomp assignments and LED colours), and Restore loads that .zip back onto the pedal. Ideal for migrating to another pedal, recovering after a reset or cloning a setup.
  • Refreshes only the changed slot after an upload (fast, especially with 150 presets).
  • Spanish / English UI with a language switcher.

Download

Check the Releases tab for your platform's package:

  • Windows: BCho-TONEX-Loader-windows-amd64.zip
  • macOS: BCho-TONEX-Loader-macos-intel.zip (Intel) · BCho-TONEX-Loader-macos-apple-silicon.zip (Apple Silicon)
  • Linux: BCho-TONEX-Loader-linux-amd64.tar.gz

Every package includes AYUDA_ACTIVACION_KOFI.html, with Ko-fi activation instructions in all app languages.

Minimum runtime requirements: Windows 10 1809 or newer, 64-bit, with Microsoft WebView2 Runtime; macOS 11.0 Big Sur or newer (Catalina 10.15 is not considered compatible with these builds; Mojave 10.14 or earlier is not supported); modern 64-bit Linux with glibc 2.31+ and WebKit2GTK 4.0/4.1 installed.

Windows: ZIP download and possible SmartScreen warning

The Windows download is published as a .zip to reduce browser or Windows Defender blocks on standalone executables. Extract the .zip and run BCho-TONEX-Loader.exe.

The first time you open the .exe, Windows SmartScreen may still show a blue "Windows protected your PC" / unknown publisher screen.

It is not a virus. It happens because the app is not code-signed (a signing certificate costs money) and, being a brand-new binary, it has no "reputation" with Windows yet. The project is open source: you can review the code or build it yourself.

To run it anyway:

  1. On the blue dialog, click More info.
  2. Click Run anyway.

(You only need to do this once.) If your browser blocks the download, choose Keep.

Basic usage

  1. Connect the pedal (TONEX One or TONEX Pedal) over USB.
  2. Close the TONEX Editor if it's open (only one program can hold the port at a time).
  3. Open the app: it detects the pedal and reads its presets.
  4. Drag a .txp onto the window — or click Open .txp — and pick the target slot.
  5. TONEX Pedal: click a slot to make the pedal switch to it. TONEX One: load the slot into A/B/Stomp to hear it.

Build from source

Requirements: Go 1.25+, Node.js 18+, Wails v2.

git clone https://github.com/bchosoft/bcho-tonex-loader.git
cd bcho-tonex-loader
go test ./...
wails build

The binary will be in build/bin/.

Project layout

  • app.go — Wails backend exposed to the frontend; serializes pedal access and exposes read/upload/export/select.
  • main.go — Wails app entry point.
  • internal/device — serial/USB communication; per-pedal model and protocol detection.
  • internal/librarian — high-level workflows: snapshot, upload, export, assignment, colour, select and polling.
  • internal/upload — parser/converter between .txp and the on-wire payload (One and Pedal).
  • internal/preset — preset/state parsing and command encoding.
  • internal/assets — embedded upload templates (One and Pedal).
  • frontend/ — UI (vanilla HTML/CSS/JS).

Support the project

If you find it useful, support the project on Ko-fi: ko-fi.com/bchosoft

License

MIT — free software, use it, modify it, redistribute it as you like.

This project is not affiliated with or endorsed by IK Multimedia. "TONEX" is a trademark of IK Multimedia. Use it at your own risk.

About

Load your txp to Tonex One or Tonex Pedal without Tonex Editor and without restrictions

Resources

Readme
License
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages