{"id":16345439,"url":"https://github.com/unclechu/pi-pedalboard","last_synced_at":"2026-05-03T12:37:33.486Z","repository":{"id":66006997,"uuid":"57853680","full_name":"unclechu/pi-pedalboard","owner":"unclechu","description":"My custom pedalboard stuff that works on Raspberry Pi","archived":false,"fork":false,"pushed_at":"2020-12-28T06:56:24.000Z","size":644,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-07-18T21:44:28.401Z","etag":null,"topics":["controller","guitar","python","raspberry-pi"],"latest_commit_sha":null,"homepage":null,"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/unclechu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-05-01T22:05:25.000Z","updated_at":"2020-12-28T06:56:26.000Z","dependencies_parsed_at":null,"dependency_job_id":"3522a4bd-610a-4105-b5c9-117484892d0d","html_url":"https://github.com/unclechu/pi-pedalboard","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/unclechu/pi-pedalboard","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unclechu%2Fpi-pedalboard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unclechu%2Fpi-pedalboard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unclechu%2Fpi-pedalboard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unclechu%2Fpi-pedalboard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/unclechu","download_url":"https://codeload.github.com/unclechu/pi-pedalboard/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unclechu%2Fpi-pedalboard/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32569714,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-03T06:36:36.687Z","status":"ssl_error","status_checked_at":"2026-05-03T06:36:09.306Z","response_time":103,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["controller","guitar","python","raspberry-pi"],"created_at":"2024-10-11T00:31:46.612Z","updated_at":"2026-05-03T12:37:33.463Z","avatar_url":"https://github.com/unclechu.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# pi-pedalboard\n\nPedalboard implementation for Raspberry Pi microcomputer.\n\n![pedalboard photo](./_stuff/pedalboard_photo_2_pluggable.jpg)\n\n## Requirements\n\n* Raspberry Pi microcomputer with GPIO (with Raspbian OS installed on it)\n* Python3\n* [`gpiozero`](https://pypi.python.org/pypi/gpiozero) and\n  [`radio-class`](https://pypi.python.org/pypi/radio-class) python packages\n* Some buttons connected to GPIO\n  ([see here for mapping](https://github.com/unclechu/pi-pedalboard/blob/6bfb629fed36bb0f536d0ea523d6a08b7d8fb66e/server.py#L20-L26)\n  and [see here for pins numbers](https://www.raspberrypi.org/documentation/usage/gpio/))\n\n## Usage\n\nFor example you have connected to your Raspberry PI over SSH and it has\n`192.168.1.10` IPv4 address (use `nmap 192.168.1.0/24` to find its address\nif you don't know it already).\n\n1. Go to directory that is cloned version of this repo,\n   \u003cdel\u003ecreate and init\n   [virtual environment](https://pypi.python.org/pypi/virtualenv)\u003c/del\u003e:\n\n   ```bash\n   # python3 -m venv -- .venv\n   # source .venv/bin/activate\n\n   ```\n   When I try to start `./server.py` with activated **virtualenv** everything is\n   freezing on `s.bind((TCP_IP, TCP_PORT))` line, even SSH connection.\n   After that any new attempt to establish SSH connection fails until I restart\n   device by unplugging and plugging power cable again. So, **skip item 1 and\n   item 2** and **install dependencies globally instead**:\n   ```bash\n   sudo apt-get install python3-gpiozero\n   sudo pip install radio-class\n   ```\n\n2. Install dependencies:\n\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n3. Run pedalboard server:\n\n   ```bash\n   ./server.py\n   ```\n\n4. Go to your host machine terminal\n   (it supposed to be linux-based distro with X11,\n   `xdotool` and python3 installed) and run\n   (in directory that is cloned version of this repo):\n\n   ```bash\n   ./client_numpad.py 192.168.1.10\n   ```\n\n   It will start a daemon that simulates numpad keys pressing by pushing on\n   buttons on pedalboard. You could use this as basic example for everything\n   you could imagine. I'm actually using it for switching between\n   [guitarix](http://guitarix.org/) presets.\n\n## Author\n\n[Viacheslav Lotsmanov](https://github.com/unclechu)\n\n## License\n\n[GNU/GPLv3](./LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funclechu%2Fpi-pedalboard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Funclechu%2Fpi-pedalboard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funclechu%2Fpi-pedalboard/lists"}