{"id":15661150,"url":"https://github.com/mte90/pydal","last_synced_at":"2026-03-07T12:35:40.523Z","repository":{"id":143335167,"uuid":"133054269","full_name":"Mte90/pydal","owner":"Mte90","description":"Remap your specific keyboard to execute custom scripts!","archived":false,"fork":false,"pushed_at":"2025-04-04T16:11:47.000Z","size":30,"stargazers_count":24,"open_issues_count":1,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-01-13T03:22:57.481Z","etag":null,"topics":["footswitch","hacktoberfest","hid","linux","pedal","usb"],"latest_commit_sha":null,"homepage":"https://daniele.tech/2018/05/pydal-or-how-to-remap-your-keyboard-to-scripting-in-linux-easily/","language":"Python","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/Mte90.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,"zenodo":null}},"created_at":"2018-05-11T15:04:23.000Z","updated_at":"2025-11-13T14:50:37.000Z","dependencies_parsed_at":"2023-06-25T22:45:35.315Z","dependency_job_id":"7cbd48d2-383b-4a72-99d7-5b6d1a178859","html_url":"https://github.com/Mte90/pydal","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Mte90/pydal","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mte90%2Fpydal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mte90%2Fpydal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mte90%2Fpydal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mte90%2Fpydal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Mte90","download_url":"https://codeload.github.com/Mte90/pydal/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mte90%2Fpydal/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30213193,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-07T12:15:00.571Z","status":"ssl_error","status_checked_at":"2026-03-07T12:15:00.217Z","response_time":53,"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":["footswitch","hacktoberfest","hid","linux","pedal","usb"],"created_at":"2024-10-03T13:26:09.291Z","updated_at":"2026-03-07T12:35:40.496Z","avatar_url":"https://github.com/Mte90.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Pydal\n[![License](https://img.shields.io/badge/License-BSD%20v3-blue.svg)](https://spdx.org/licenses/BSD-3-Clause)\n\nA simple way to create your macros, with a config file to execute cusom script/program and target a specific keyboard.\n\n![](https://daniele.tech/wp-content/uploads/2018/05/footswitch-300x300.jpg)\n\nAs you can see in photo, in my case I have a foot switch and in this way I am able to use it to run scripts that move my mouse cursor in one of the 3 monitor I have.\nThis tiny Python script, parse the config file and map to the specific keyboard configured a script to execute on the various buttons.\n\n# Commands\n\n```\nmte90:~/pydal $ ./pydal.py \nusage: pydal.py [-h] [-devices [DEVICES]] [-run [RUN]] [--config [CONFIG]]\n                [--version]\n\nPydal is a tiny script to assign a script to a button of a specific keyboard\n\noptional arguments:\n  -h, --help          show this help message and exit\n  -devices [DEVICES]  The devices list\n  -run [RUN]          Launch Pydal\n  --config [CONFIG]   Config file for Pydal\n  --version           show program's version number and exit\n```\n\n# How to use it\n\n## First step\n\nRun `pydal.py -devices` to get a list of all the HID devices connected to your computer.  \nSave the name of the keyboard that you need to for your config file.\n\n## Second step\n\nCopy `config-sample.ini` where you want (also with a different name) and add the keyboard name in the config file.  \nConfigure the settings as you wish for every key, on the keydown/keyup status and a absolute path to the script that you want to execute.\n\n## Third step\n\nRun with `pydal.py --config /your/path/config.ini -run` and get fun!\n\n# Installation\n\nRequirements:\n\n* pyevdev - Debian has a package `python3-evdev` \n\nPermission to the user to access to all the input devices:\n\n```\nuseradd plugdev [your-user]\nusermod -a -G plugdev [your-user]\n```\n\nAdd the udev rules to your system `99-pydal.rules` on `/etc/udev/rules.d/`:\n\n```\nKERNEL==\"event*\", MODE=\"660\", GROUP=\"plugdev\"\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmte90%2Fpydal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmte90%2Fpydal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmte90%2Fpydal/lists"}