macrokeyd 0.1.7

Macro daemon for dedicated keyboards

macrokeyd

macrokeyd is a Python daemon that allows assigning custom actions to a specific keyboard, such as commands, text, system shortcuts, or chained sequences. It is designed to run as a systemd service and configured through modular JSON files.

---

🚀 Quick Installation from PyPI

pip install macrokeyd

Requires Python >= 3.7 and Linux with evdev support.

---

🧪 Testing Installation

macrokeyd --help
macrokeyd --version

You can start the daemon with:

macrokeyd --run

By default, it searches for ~/.local/share/macrokeyd/default.json and creates it if it doesn't exist.

---

⚙️ Installing as a systemd service

macrokeyd-install-service

Check the status:

systemctl status macrokeyd

Uninstall:

macrokeyd-uninstall-service

---

🎛️ Macro Configuration

The configuration file is located at (or created at):

~/.local/share/macrokeyd/default.json

Example content:

{
  "meta": {
    "target_device_name": "TEC-FX556K"
  },
  "macros": {
    "KEY_Q": {"action": "command", "value": "gnome-terminal"},
    "KEY_W": {"action": "text", "value": "Hello world"}
  }
}

---

🧱 Local Development

git clone https://gitlab.com/your_user/macrokeyd.git
cd macrokeyd
make install

---

🛠 Useful Commands (make)

• make build → generates .whl and .tar.gz packages
• make install → installs locally with --force-reinstall
• make clean → cleans up artifacts
• make release LEVEL=patch → bumps version and pushes
• make release-changelog → same as release and updates CHANGELOG.md
• make release-pypi → publishes to PyPI
• make release-test → publishes to TestPyPI

---

📦 Publishing to PyPI

Check RELEASE.md for the full versioning and release cycle details.