# GT-1000PILOT - Remotely control a Boss GT-1000/GT-1000CORE
<p align="center">
<img width="200" alt="gt1000pilot-logo" src="https://github.com/user-attachments/assets/ef71fe17-919b-4a39-b296-84493101e417">
</p>
GT-1000PILOT is a web dashboard that lets you remotely control your Boss
GT-1000/GT-1000CORE effects in real-time over MIDI. Whether you’re jamming at
home or experimenting in the studio, GT-1000PILOT makes it easy to toggle
effects blocks, adjust levels, from your tablet or phone without interrupting
your playing.
This tool doesn’t replace Boss Tone Studio; instead, it complements it by
allowing you to see and modify the current state of each effects block quickly.
It’s designed to make your unit feel more like a traditional pedalboard,
offering a more dynamic and interactive way to shape your tone.
It doesn't interfere with any of the unit normal functions, it keeps refreshing
in the background to show the current state, so toggling effects, changing
patches with a different method works normally and after a few seconds the
current state is visible on the dashboard. It is really a companion app for the
unit !
For live/gig usage this is probably not ideal, but for home/studio it has
proven to be very fun and convenient to use !
<p align="center">
<img width="500" alt="gt1000pilot-fx" src="https://github.com/user-attachments/assets/48bd7944-8d1a-449e-b419-6db9105991d7">
<img width="500" alt="gt1000pilot-comp" src="https://github.com/user-attachments/assets/518028ca-1603-41e0-96b0-0c3583e063e4">
<img width="500" alt="gt1000pilot-pedalfx" src="https://github.com/user-attachments/assets/429e2278-d8d9-4a81-9cae-3acde65d9d16">
<img width="500" alt="gt1000pilot-delays" src="https://github.com/user-attachments/assets/5cfd74b8-127e-461c-ba53-0c5445197190">
<img width="500" alt="gt1000pilot-delays" src="https://github.com/user-attachments/assets/9fb24edc-6d52-46ae-885a-a974bfc6e001">
</p>
## Usage
This has been tested on Mac, Linux, Windows 11 and even embedded in a Raspberry Pi hidden
on a pedalboard (so it always come up when the pedals are powered on).
To use, connect directly the USB port of the unit to the host running this
application OR select the MIDI interface that can communicate with the unit.
Pre-built binary packages for Linux/Mac/Windows are available in the
[Releases](https://github.com/jdesfossez/pygt1000/releases) section. For a
more manual installation, you can follow the instructions from the Development
section below.
When the application starts (GUI or CLI), it connects to the unit, enables the
editor mode, and start the refresh loop to get the current state of the pedal.
When the initial sync is complete, it starts a small webserver so we can access
the dashboard remotely over Wifi.
The dashboard listens for HTTP on the port 8050, so you need to connect to the
machine running the program with an address like: `http://<your-ip>:8050`.
Finding the IP address of the host running the program depends on the operating
system running there. To access the dashboard from the same machine:
`http://localhost:8050` will work.
## Feedback
I would love to collect feedback and see what users of the GT-1000 think and
how we could improve the experience. This was started because I always feel
like I don't have enough buttons to trigger blocks and mapping all of that for
each patch gets annoying. Now I just create my patches with a lot of optional
blocks ready to fire and decide on the fly if I want them of not while playing.
This to me feels a bit more like a traditional pedalboard and makes it more fun
to use. Hopefully it is useful and fun for others as well ! Feel free to open
an issue, share your experiences, or suggest features that would make this tool
even better.
## Development
This tool is written in Python, the web dashboard is built using Dash and the
dependencies are managed with Poetry so after
[installing Poetry](https://python-poetry.org/docs/#installation) for your
platform
```
git clone https://github.com/jdesfossez/GT-1000PILOT
cd GT-1000PILOT
poetry install
poetry run python gt1000pilot/app.py [--gui]
```
It is also possible to install using `pip`:
```
pip install GT-1000PILOT
```
It depends mainly on the [pygt1000](https://github.com/jdesfossez/pygt1000)
library to interact with the pedal.
## Contributing
This is open source to make it possible to make the tool evolve to users needs.
I am not a web developer, so any help around CSS would be appreciated :-) !
Of course, contributions in all forms (feedback, improving the UI, adding new
features, or enhancing the documentation) is appreciated !
Raw data
{
"_id": null,
"home_page": "https://github.com/jdesfossez/GT-1000PILOT",
"name": "GT-1000PILOT",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.10",
"maintainer_email": null,
"keywords": null,
"author": "Julien Desfossez",
"author_email": "j@jdfz.org",
"download_url": "https://files.pythonhosted.org/packages/40/fe/83ee0822b145c3248c812c69b65d3c0e5fa49dafa672d359fba094021050/gt_1000pilot-0.2.0.tar.gz",
"platform": null,
"description": "# GT-1000PILOT - Remotely control a Boss GT-1000/GT-1000CORE\n\n<p align=\"center\">\n<img width=\"200\" alt=\"gt1000pilot-logo\" src=\"https://github.com/user-attachments/assets/ef71fe17-919b-4a39-b296-84493101e417\">\n</p>\n\nGT-1000PILOT is a web dashboard that lets you remotely control your Boss\nGT-1000/GT-1000CORE effects in real-time over MIDI. Whether you\u2019re jamming at\nhome or experimenting in the studio, GT-1000PILOT makes it easy to toggle\neffects blocks, adjust levels, from your tablet or phone without interrupting\nyour playing.\n\nThis tool doesn\u2019t replace Boss Tone Studio; instead, it complements it by\nallowing you to see and modify the current state of each effects block quickly.\nIt\u2019s designed to make your unit feel more like a traditional pedalboard,\noffering a more dynamic and interactive way to shape your tone.\n\nIt doesn't interfere with any of the unit normal functions, it keeps refreshing\nin the background to show the current state, so toggling effects, changing\npatches with a different method works normally and after a few seconds the\ncurrent state is visible on the dashboard. It is really a companion app for the\nunit !\n\nFor live/gig usage this is probably not ideal, but for home/studio it has\nproven to be very fun and convenient to use !\n\n<p align=\"center\">\n<img width=\"500\" alt=\"gt1000pilot-fx\" src=\"https://github.com/user-attachments/assets/48bd7944-8d1a-449e-b419-6db9105991d7\">\n<img width=\"500\" alt=\"gt1000pilot-comp\" src=\"https://github.com/user-attachments/assets/518028ca-1603-41e0-96b0-0c3583e063e4\">\n<img width=\"500\" alt=\"gt1000pilot-pedalfx\" src=\"https://github.com/user-attachments/assets/429e2278-d8d9-4a81-9cae-3acde65d9d16\">\n<img width=\"500\" alt=\"gt1000pilot-delays\" src=\"https://github.com/user-attachments/assets/5cfd74b8-127e-461c-ba53-0c5445197190\">\n<img width=\"500\" alt=\"gt1000pilot-delays\" src=\"https://github.com/user-attachments/assets/9fb24edc-6d52-46ae-885a-a974bfc6e001\">\n</p>\n\n## Usage\n\nThis has been tested on Mac, Linux, Windows 11 and even embedded in a Raspberry Pi hidden\non a pedalboard (so it always come up when the pedals are powered on).\n\nTo use, connect directly the USB port of the unit to the host running this\napplication OR select the MIDI interface that can communicate with the unit.\n\nPre-built binary packages for Linux/Mac/Windows are available in the\n[Releases](https://github.com/jdesfossez/pygt1000/releases) section. For a\nmore manual installation, you can follow the instructions from the Development\nsection below.\n\nWhen the application starts (GUI or CLI), it connects to the unit, enables the\neditor mode, and start the refresh loop to get the current state of the pedal.\nWhen the initial sync is complete, it starts a small webserver so we can access\nthe dashboard remotely over Wifi.\n\nThe dashboard listens for HTTP on the port 8050, so you need to connect to the\nmachine running the program with an address like: `http://<your-ip>:8050`.\nFinding the IP address of the host running the program depends on the operating\nsystem running there. To access the dashboard from the same machine:\n`http://localhost:8050` will work.\n\n## Feedback\n\nI would love to collect feedback and see what users of the GT-1000 think and\nhow we could improve the experience. This was started because I always feel\nlike I don't have enough buttons to trigger blocks and mapping all of that for\neach patch gets annoying. Now I just create my patches with a lot of optional\nblocks ready to fire and decide on the fly if I want them of not while playing.\nThis to me feels a bit more like a traditional pedalboard and makes it more fun\nto use. Hopefully it is useful and fun for others as well ! Feel free to open\nan issue, share your experiences, or suggest features that would make this tool\neven better.\n\n## Development\n\nThis tool is written in Python, the web dashboard is built using Dash and the\ndependencies are managed with Poetry so after\n[installing Poetry](https://python-poetry.org/docs/#installation) for your\nplatform\n\n```\ngit clone https://github.com/jdesfossez/GT-1000PILOT\ncd GT-1000PILOT\npoetry install\npoetry run python gt1000pilot/app.py [--gui]\n```\n\nIt is also possible to install using `pip`:\n```\npip install GT-1000PILOT\n```\n\nIt depends mainly on the [pygt1000](https://github.com/jdesfossez/pygt1000)\nlibrary to interact with the pedal.\n\n## Contributing\n\nThis is open source to make it possible to make the tool evolve to users needs.\nI am not a web developer, so any help around CSS would be appreciated :-) !\n\nOf course, contributions in all forms (feedback, improving the UI, adding new\nfeatures, or enhancing the documentation) is appreciated !\n",
"bugtrack_url": null,
"license": "GPLv2",
"summary": null,
"version": "0.2.0",
"project_urls": {
"Homepage": "https://github.com/jdesfossez/GT-1000PILOT",
"Repository": "https://github.com/jdesfossez/GT-1000PILOT"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d3341f4f88b40bd826b2859d82f749a4cc06383c6dcf48eaf9cadddf75480950",
"md5": "c3e35339130011f0eee03d787838b649",
"sha256": "ae43b11af5def41875372f120d4eaa21b3d5ce0b081b6f6b4fbb9e21d747b7bc"
},
"downloads": -1,
"filename": "gt_1000pilot-0.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c3e35339130011f0eee03d787838b649",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.10",
"size": 468814,
"upload_time": "2024-09-01T20:16:34",
"upload_time_iso_8601": "2024-09-01T20:16:34.328118Z",
"url": "https://files.pythonhosted.org/packages/d3/34/1f4f88b40bd826b2859d82f749a4cc06383c6dcf48eaf9cadddf75480950/gt_1000pilot-0.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "40fe83ee0822b145c3248c812c69b65d3c0e5fa49dafa672d359fba094021050",
"md5": "9e90cbdeed6728c1cc94e80edf380c71",
"sha256": "f192a7a1215065baf70dde70289280dc6ab1045ecfe2387d51e6a6c93936b46d"
},
"downloads": -1,
"filename": "gt_1000pilot-0.2.0.tar.gz",
"has_sig": false,
"md5_digest": "9e90cbdeed6728c1cc94e80edf380c71",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.10",
"size": 467219,
"upload_time": "2024-09-01T20:16:36",
"upload_time_iso_8601": "2024-09-01T20:16:36.194020Z",
"url": "https://files.pythonhosted.org/packages/40/fe/83ee0822b145c3248c812c69b65d3c0e5fa49dafa672d359fba094021050/gt_1000pilot-0.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-01 20:16:36",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "jdesfossez",
"github_project": "GT-1000PILOT",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "gt-1000pilot"
}