{"id":50396396,"url":"https://github.com/allansomensi/openhx","last_synced_at":"2026-05-30T21:01:44.156Z","repository":{"id":342885087,"uuid":"1175461462","full_name":"allansomensi/openhx","owner":"allansomensi","description":"Unofficial open-source alternative to HX Edit — CLI \u0026 GUI in Rust for Line 6 HX/Helix devices, on any platform.","archived":false,"fork":false,"pushed_at":"2026-04-29T14:34:52.000Z","size":174,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-29T14:41:35.673Z","etag":null,"topics":["audio","cli","gui","hx-stomp","line6","reverse-engineering","rust","usb"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/allansomensi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-07T18:38:57.000Z","updated_at":"2026-04-29T14:37:34.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/allansomensi/openhx","commit_stats":null,"previous_names":["allansomensi/openhx"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/allansomensi/openhx","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/allansomensi%2Fopenhx","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/allansomensi%2Fopenhx/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/allansomensi%2Fopenhx/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/allansomensi%2Fopenhx/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/allansomensi","download_url":"https://codeload.github.com/allansomensi/openhx/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/allansomensi%2Fopenhx/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33709269,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-30T02:00:06.278Z","response_time":92,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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","cli","gui","hx-stomp","line6","reverse-engineering","rust","usb"],"created_at":"2026-05-30T21:01:41.455Z","updated_at":"2026-05-30T21:01:44.149Z","avatar_url":"https://github.com/allansomensi.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg width=\"190\"  alt=\"OpenHX Logo\" src=\"https://github.com/user-attachments/assets/4b159aec-5a66-4afd-8f5d-e68fb9c1eab0\" /\u003e\n\n  # OpenHX\n\n  \u003cp\u003e\u003cem\u003eAn unofficial, open-source alternative to HX Edit — built in Rust, runs everywhere.\u003c/em\u003e\u003c/p\u003e\n\n  [![Built with Rust](https://img.shields.io/badge/built_with-Rust-dca282.svg)](https://www.rust-lang.org/)\n  [![Version](https://img.shields.io/github/v/release/allansomensi/openhx?color=blue\u0026label=version)](https://github.com/allansomensi/openhx/releases)\n  [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)\n\n  \u003cbr/\u003e\n\u003c/div\u003e\n\nOpenHX is a community-driven tool for managing Line 6 HX series devices (HX Stomp, HX Stomp XL, and Helix family) from any operating system. It ships as both a **command-line interface** and a **graphical interface**, with no dependency on HX Edit or any official Line 6 software.\n\n---\n\n## 🎯 Motivation\n\nHX Edit — the official companion software for Line 6 HX devices — is only supported on Windows and macOS. Linux users, BSD users, and anyone running an unsupported OS are left without a way to manage their presets, update settings, or interact with their hardware programmatically.\n\nOpenHX was built to close that gap.\n\n---\n\n## ✨ Features\n\n\u003e ⚠️ OpenHX is in early development. Features marked 🚧 are planned but not yet implemented.\n\n- ✅ List presets\n- ✅ Select preset\n- 🚧 Rename preset\n- 🚧 Import and export presets (`.hlx` files)\n- 🚧 Reorder blocks\n- 🚧 Toggle individual effect blocks\n- 🚧 Manage Impulse Responses (IRs)\n- 🚧 Configure Global EQ\n- 🚧 Full GUI with preset browser and editor\n- 🚧 Support for multiple HX devices\n\n---\n\n## ✅ Supported Devices\n\n| Device | Status |\n|---|---|\n| HX Stomp | 🚧 Planned |\n| HX Stomp XL | ✅ Validated |\n| HX Effects | 🚧 Planned |\n| Helix Floor | 🟡 Partial (active setlist only — other 7 setlists not yet reachable) |\n| Helix LT | 🚧 Planned |\n\n---\n\n## 📥 Installation\n\nYou can find pre-built binaries, installers (`.msi`), and automated installation scripts (`.ps1`, `.sh`) on the **Releases** page.\n\n\u003e **Windows Users:** If you encounter a \"SmartScreen\" warning when running the MSI, click **\"More info\"** → **\"Run anyway\"**. This is normal for unsigned open-source tools.\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eOr install from source (Cargo)\u003c/strong\u003e\u003c/summary\u003e\n\n**Prerequisites:** Rust toolchain (`rustup`), `libusb` 1.0+.\n\n```bash\ngit clone https://github.com/allansomensi/openhx\ncd openhx\ncargo build --release\n```\n\nThe binary will be at `target/release/openhx`.\n\u003c/details\u003e\n\n---\n\n## 💻 Usage\n\n### CLI\n\n```bash\n# List all presets\nopenhx-cli preset list\n\n# Select a specific preset by its index and bank\nopenhx-cli preset select --preset \u003cPRESET\u003e --bank \u003cBANK\u003e\n```\n\n### GUI\n\n```bash\nopenhx\n```\n\n---\n\n## 🔬 How It Works\n\nOpenHX communicates with HX devices over **USB bulk transfers** using the same vendor-specific protocol as HX Edit.\n\nThe protocol was reverse-engineered entirely **black-box** — by capturing and analyzing USB traffic between an HX Stomp XL and the official HX Edit software. No Line 6 source code, firmware, or proprietary SDKs were accessed or used at any point. The reverse engineering was done **strictly for the purpose of interoperability** with a platform not officially supported by Line 6.\n\nThe full protocol is documented in [`docs/protocol/`](./docs/protocol/README.md).\n\n---\n\n## 🤝 Contributing\n\nContributions are very welcome, especially:\n\n- Protocol research for additional devices or operations\n- Testing on different hardware and operating systems\n- GUI development\n- Documentation improvements\n\nPlease open an issue before starting work on a large feature so we can coordinate.\n\n---\n\n## ⚖️ Legal\n\n**OpenHX is an unofficial, community-driven, open-source project. It is not affiliated with, endorsed by, sponsored by, or associated with Line 6 or Yamaha Guitar Group, Inc. in any way.**\n\n\"Line 6\", \"HX Stomp\", \"HX Effects\", \"Helix\", and \"HX Edit\" are trademarks of Yamaha Guitar Group, Inc. All trademarks are the property of their respective owners and are used here strictly for descriptive and nominative purposes.\n\nThe reverse engineering performed in this project was conducted entirely black-box — by observing USB communication between the device and the official software — and is intended solely to enable interoperability on platforms not officially supported. No proprietary code, firmware, or trade secrets were accessed or incorporated.\n\nOpenHX is released under the [MIT License](./LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fallansomensi%2Fopenhx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fallansomensi%2Fopenhx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fallansomensi%2Fopenhx/lists"}