@desklink/host 0.1.0

package/engine/vendor/inputtino/CMakeLists.txt

@@ -0,0 +1,187 @@
+cmake_minimum_required(VERSION 3.13...3.24)
+
+# Project name and a few useful settings. Other commands can pick up the results
+project(inputtino
+        VERSION 0.1
+        DESCRIPTION "A virtual input library"
+        LANGUAGES C CXX)
+
+#----------------------------------------------------------------------------------------------------------------------
+# general settings and options
+#----------------------------------------------------------------------------------------------------------------------
+
+include(cmake/utils.cmake)
+include(GNUInstallDirs)
+include(CMakePackageConfigHelpers)
+
+# Only do these if this is the main project, and not if it is included through add_subdirectory
+if (CMAKE_PROJECT_NAME STREQUAL PROJECT_NAME)
+
+    # Optionally set things like CMAKE_CXX_STANDARD, CMAKE_POSITION_INDEPENDENT_CODE here
+
+    set(CMAKE_CXX_STANDARD 17)
+
+    set(CMAKE_CXX_STANDARD_REQUIRED ON)
+
+    # Let's ensure -std=c++xx instead of -std=g++xx
+    set(CMAKE_CXX_EXTENSIONS OFF)
+
+    # Let's nicely support folders in IDEs
+    set_property(GLOBAL PROPERTY USE_FOLDERS ON)
+
+    option(BUILD_SHARED_LIBS "Build libs as shared" ON)
+
+    include(CTest)
+
+    set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY "${PROJECT_BINARY_DIR}")
+    set(CMAKE_LIBRARY_OUTPUT_DIRECTORY "${PROJECT_BINARY_DIR}")
+    set(CMAKE_RUNTIME_OUTPUT_DIRECTORY "${PROJECT_BINARY_DIR}")
+
+    if (NOT DEFINED CMAKE_BUILD_TYPE AND NOT DEFINED CMAKE_CONFIGURATION_TYPES)
+        set(CMAKE_BUILD_TYPE Release CACHE STRING "Build type" FORCE)
+        set_property(CACHE CMAKE_BUILD_TYPE PROPERTY STRINGS "Debug" "Release" "MinSizeRel" "RelWithDebInfo")
+    endif ()
+endif ()
+
+# Make an automatic library - will be static or dynamic based on user setting
+add_library(libinputtino)
+add_library(inputtino::libinputtino ALIAS libinputtino)
+
+# All users of this library will need at least C++17
+target_compile_features(libinputtino PUBLIC cxx_std_17)
+set_target_properties(libinputtino PROPERTIES LINKER_LANGUAGE CXX)
+target_compile_definitions(libinputtino PUBLIC "$<$<NOT:$<BOOL:${BUILD_SHARED_LIBS}>>:INPUTTINO_STATIC_DEFINE>")
+
+#----------------------------------------------------------------------------------------------------------------------
+# Export symbols
+#----------------------------------------------------------------------------------------------------------------------
+
+include(GenerateExportHeader)
+set(export_file_name "export_shared.h")
+
+if (NOT BUILD_SHARED_LIBS)
+    set(export_file_name "export_static.h")
+endif ()
+
+message(STATUS "Export file name: ${export_file_name}")
+
+generate_export_header(libinputtino EXPORT_FILE_NAME include/inputtino/${export_file_name})
+
+
+#----------------------------------------------------------------------------------------------------------------------
+# Options
+#----------------------------------------------------------------------------------------------------------------------
+
+option(BUILD_C_BINDINGS "Build C bindings" OFF)
+option(LIBINPUTTINO_INSTALL "Generate the install target" OFF)
+option(USE_UHID "Add uhid implementation for advanced DualSense features" ON)
+
+#----------------------------------------------------------------------------------------------------------------------
+# Dependencies
+#----------------------------------------------------------------------------------------------------------------------
+
+if (UNIX AND NOT APPLE)
+    option(LIBEVDEV_CUSTOM_INCLUDE_DIR "Location to a custom libevdev source" OFF)
+    option(LIBEVDEV_CUSTOM_LIBRARY "Location to a custom libevdev library" OFF)
+    if (LIBEVDEV_CUSTOM_INCLUDE_DIR AND LIBEVDEV_CUSTOM_LIBRARY)
+        target_include_directories(libinputtino PUBLIC "${LIBEVDEV_CUSTOM_INCLUDE_DIR}")
+        target_link_libraries(libinputtino PUBLIC "${LIBEVDEV_CUSTOM_LIBRARY}")
+    else ()
+        find_package(PkgConfig)
+        pkg_check_modules(LIBEVDEV REQUIRED IMPORTED_TARGET libevdev)
+        target_link_libraries(libinputtino PUBLIC PkgConfig::LIBEVDEV)
+    endif ()
+endif ()
+
+find_program(CCACHE_FOUND ccache)
+if (CCACHE_FOUND)
+    set_property(GLOBAL PROPERTY RULE_LAUNCH_COMPILE ccache)
+endif (CCACHE_FOUND)
+
+#----------------------------------------------------------------------------------------------------------------------
+# Sources
+#----------------------------------------------------------------------------------------------------------------------
+
+set(PUBLIC_HEADERS
+        include/inputtino/input.hpp
+        include/inputtino/result.hpp
+        include/inputtino/input.h)
+
+if (UNIX AND NOT APPLE)
+    list(APPEND SRC_LIST
+            "src/uinput/joypad_nintendo.cpp"
+            "src/uinput/joypad_xbox.cpp"
+            "src/uinput/keyboard.cpp"
+            "src/uinput/mouse.cpp"
+            "src/uinput/pentablet.cpp"
+            "src/uinput/touchscreen.cpp"
+            "src/uinput/trackpad.cpp")
+
+    if (USE_UHID)
+        message("Using uhid implementation for DualSense controller")
+        list(APPEND SRC_LIST "src/uhid/joypad_ps5.cpp")
+        target_include_directories(libinputtino PUBLIC "src/uhid/include/")
+    else ()
+        message("Using uinput implementation for DualSense controller")
+        list(APPEND SRC_LIST "src/uinput/joypad_ps.cpp")
+    endif ()
+
+    target_sources(libinputtino PRIVATE ${SRC_LIST})
+    target_include_directories(libinputtino PUBLIC "src/uinput/include")
+endif ()
+
+if (BUILD_C_BINDINGS)
+    file(GLOB C_SRC_FILES SRCS src/c-bindings/*.cpp)
+    target_sources(libinputtino PRIVATE
+            src/c-bindings/helpers.hpp
+            ${C_SRC_FILES})
+endif ()
+
+# Testing only available if this is the main app
+# Emergency override MODERN_CMAKE_BUILD_TESTING provided as well
+if ((CMAKE_PROJECT_NAME STREQUAL PROJECT_NAME OR MODERN_CMAKE_BUILD_TESTING)
+        AND BUILD_TESTING)
+    add_subdirectory(tests)
+endif ()
+
+#----------------------------------------------------------------------------------------------------------------------
+# Install
+#----------------------------------------------------------------------------------------------------------------------
+
+# Only do these if this is the main project, and not if it is included through add_subdirectory
+if (CMAKE_PROJECT_NAME STREQUAL PROJECT_NAME)
+    # Only export explicitly defined symbols
+    set_if_undefined(CMAKE_CXX_VISIBILITY_PRESET hidden)
+    set_if_undefined(CMAKE_VISIBILITY_INLINES_HIDDEN ON)
+
+    if (LIBINPUTTINO_INSTALL AND NOT CMAKE_SKIP_INSTALL_RULES)
+        install(TARGETS libinputtino
+                EXPORT libinputtino_export
+                RUNTIME COMPONENT libinputtino
+                LIBRARY COMPONENT libinputtino
+                NAMELINK_COMPONENT libinputtino-dev
+                ARCHIVE COMPONENT libinputtino-dev
+                INCLUDES DESTINATION "${CMAKE_INSTALL_INCLUDEDIR}")
+        install(DIRECTORY include/
+                TYPE INCLUDE
+                COMPONENT libinputtino-dev)
+        install(FILES "${CMAKE_CURRENT_BINARY_DIR}/include/inputtino/${export_file_name}"
+                COMPONENT libinputtino-dev
+                DESTINATION "${CMAKE_INSTALL_INCLUDEDIR}/inputtino")
+        configure_file(
+                ${CMAKE_CURRENT_SOURCE_DIR}/share/pkgconfig/libinputtino.pc.in
+                ${CMAKE_CURRENT_BINARY_DIR}/libinputtino.pc
+                @ONLY
+        )
+        install(FILES ${CMAKE_CURRENT_BINARY_DIR}/libinputtino.pc
+                DESTINATION ${CMAKE_INSTALL_DATAROOTDIR}/pkgconfig)
+    endif ()
+endif ()
+
+target_include_directories(libinputtino PUBLIC
+        "$<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>"
+        "$<BUILD_INTERFACE:${CMAKE_CURRENT_BINARY_DIR}/include>")
+set_target_properties(libinputtino PROPERTIES
+        VERSION ${PROJECT_VERSION}
+        PUBLIC_HEADER "${PUBLIC_HEADERS}")
+set_target_properties(libinputtino PROPERTIES OUTPUT_NAME "libinputtino")

package/engine/vendor/inputtino/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021-2024 Games on Whales https://github.com/games-on-whales/
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/engine/vendor/inputtino/README.md

@@ -0,0 +1,110 @@
+# inputtino
+
+An easy to use virtual input library for Linux built on top of `uinput`, `evdev` and `uhid`.  
+Currently in use by [Wolf](https://github.com/games-on-whales/wolf), [Sunshine](https://github.com/LizardByte/Sunshine) and [Moonshine](https://github.com/hgaiser/moonshine)
+
+Supports:
+
+- Keyboard
+- Mouse
+- Touchscreen
+- Trackpad
+- Pen tablet
+- Joypad
+    - Correctly emulates Xbox, PS5 or Nintendo joypads
+    - Supports callbacks on Rumble events
+    - Gyro, Acceleration, Touchpad, Adaptive triggers, LED and battery status fully supported when creating a virtual DualSense joypad (with full support without Steam Input for games that are compatible with DualSense)
+
+Interested in how the joypad works under the hood? Checkout these blog posts:
+- [When uinput Isn’t Enough: Virtualizing a DualSense controller](https://abeltra.me/blog/inputtino-uhid-1/)
+- [Creating a Virtual DualSense Controller via UHID](https://abeltra.me/blog/inputtino-uhid-2/)
+- [Beyond USB: Improving Virtual Controller Support in Linux Games](https://abeltra.me/blog/inputtino-uhid-3/)
+
+A special thanks goes to [@hgaiser](https://github.com/hgaiser) for all the help in yak shaving the DualSense implementation.
+
+## Include in a C++ project
+
+If using `Cmake` it's as simple as
+
+```cmake
+FetchContent_Declare(
+        inputtino
+        GIT_REPOSITORY https://github.com/games-on-whales/inputtino.git
+        GIT_TAG <GIT_SHA_OR_TAG>)
+FetchContent_MakeAvailable(inputtino)
+target_link_libraries(<your_project_name> PUBLIC inputtino::libinputtino)
+```
+
+### Example usage
+
+```c++
+#include <inputtino/input.hpp>
+
+auto joypad = Joypad::create(Joypad::PS, Joypad::RUMBLE | Joypad::ANALOG_TRIGGERS);
+
+joypad->set_stick(Joypad::LS, 1000, 2000);
+joypad->set_pressed_buttons(Joypad::X | Joypad::DPAD_RIGHT);
+
+auto rumble_data = std::make_shared<std::pair<int, int>>();
+joypad.set_on_rumble([rumble_data](int low_freq, int high_freq) {
+    rumble_data->first = low_freq;
+    rumble_data->second = high_freq;
+});
+```
+
+For more examples you can look at the unit tests under `tests/`: Joypads have been tested using `SDL2` other input
+devices have been tested with `libinput`.
+
+The main interface is easily accessible
+under [include/inputtino/input.hpp](include/inputtino/input.hpp)
+
+## Using the Python bindings
+
+Checkout the instructions in [bindings/python/](bindings/python/); example usage:
+
+```python
+from inputtino import Mouse, MouseButton
+
+# Initialize mouse device
+mouse = Mouse()
+
+# Move mouse
+mouse.move(100, 50)  # Move right 100, down 50
+mouse.move_abs(500, 300, 1920, 1080)  # Move to absolute position
+
+# Click operations
+mouse.click(MouseButton.LEFT)
+mouse.click(MouseButton.RIGHT, duration=0.5)  # Hold for 0.5 seconds
+
+# Scrolling
+mouse.scroll_vertical(120)  # Scroll up
+mouse.scroll_horizontal(-120)  # Scroll left
+```
+
+## Using the Rust bindings
+
+After building and installing `inputtino` you can use the Rust bindings by adding the following to your `Cargo.toml`:
+
+```toml
+[dependencies]
+inputtino = { git = "https://github.com/games-on-whales/inputtino.git", branch="stable" }
+```
+
+Example usage:
+
+```rust
+let device = DeviceDefinition::new(
+        "Rusty Keyboard",
+        0xAB,
+        0xCD,
+        0xEF,
+        "Rusty Keyboard Phys",
+        "Rusty Keyboard Uniq",
+    );
+let keyboard = Keyboard::new(&device).unwrap();
+
+keyboard.press_key(0x41); // KEY_A
+keyboard.release_key(0x41);
+```
+
+See the [tests](bindings/rust/inputtino/tests) for more examples.

package/engine/vendor/inputtino/bindings/python/.devcontainer/Dockerfile

@@ -0,0 +1,23 @@
+FROM ubuntu:24.04
+
+# Install uv
+COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
+ENV UV_LINK_MODE=copy
+# Shell completion
+RUN echo 'eval "$(uv generate-shell-completion bash)"' >> ~/.bashrc
+
+ENV DEBIAN_FRONTEND=noninteractive
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    build-essential \
+    ca-certificates \
+    cmake \
+    clang-format \
+    # clang-tidy \
+    cpplint \
+    cppcheck \
+    # iwyu \
+    libevdev-dev \
+    make \
+    pkg-config \
+    git \
+    && rm -rf /var/lib/apt/lists/*

package/engine/vendor/inputtino/bindings/python/.devcontainer/devcontainer.json

@@ -0,0 +1,28 @@
+{
+  "name": "inputtino-python-dev",
+  "build": {
+    "context": "../../../", // The root of the repository
+    "dockerfile": "Dockerfile"
+  },
+  "privileged": true,
+  // Mount the root of the repository so that the C++ code can be built
+  "workspaceMount": "source=${localWorkspaceFolder}/../../,target=/workspace,type=bind",
+  "workspaceFolder": "/workspace/bindings/python",
+  "mounts": [
+    "source=uv-cache,target=/root/.cache/uv,type=volume",
+    "source=pip-cache,target=/root/.cache/pip,type=volume",
+    "source=pre-commit-cache,target=/root/.cache/pre-commit,type=volume"
+  ],
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "ms-python.python",
+        "ms-vscode.cpptools-extension-pack"
+      ],
+      "settings": {
+        "python.defaultInterpreterPath": "/workspace/.venv/bin/python"
+      }
+    }
+  },
+  "shutdownAction": "stopContainer"
+}

package/engine/vendor/inputtino/bindings/python/.python-version

@@ -0,0 +1 @@
+3.10

package/engine/vendor/inputtino/bindings/python/CMakeLists.txt

@@ -0,0 +1,23 @@
+cmake_minimum_required(VERSION 3.15)
+project(${SKBUILD_PROJECT_NAME} LANGUAGES CXX)
+
+set(CMAKE_POSITION_INDEPENDENT_CODE ON)
+
+set(PYBIND11_FINDPYTHON ON)
+find_package(pybind11 CONFIG REQUIRED)
+
+# add inputtino
+get_filename_component(PROJECT_ROOT "${CMAKE_CURRENT_SOURCE_DIR}/../.." ABSOLUTE)
+add_subdirectory(${PROJECT_ROOT} "${CMAKE_CURRENT_BINARY_DIR}/inputtino")
+
+execute_process(
+    COMMAND pybind11-config --includes
+    OUTPUT_VARIABLE PYBIND11_INCLUDES
+    OUTPUT_STRIP_TRAILING_WHITESPACE
+)
+
+pybind11_add_module(_core MODULE src/main.cpp)
+target_include_directories(_core PRIVATE ${PYBIND11_INCLUDES})
+target_link_libraries(_core PUBLIC inputtino::libinputtino)
+
+install(TARGETS _core DESTINATION inputtino)

package/engine/vendor/inputtino/bindings/python/CPPLINT.cfg

@@ -0,0 +1,2 @@
+set noparent
+filter=-legal/copyright

package/engine/vendor/inputtino/bindings/python/Makefile

@@ -0,0 +1,49 @@
+help:  ## Show help
+	@grep -E '^[.a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-30s\033[0m %s\n", $$1, $$2}'
+
+clean: ## Clean autogenerated files
+	rm -rf dist
+	rm -rf build
+	rm -rf .venv
+	find . -type f -name "*.DS_Store" -ls -delete
+	find . | grep -E "(__pycache__|\.pyc|\.pyo)" | xargs rm -rf
+	find . | grep -E ".pytest_cache" | xargs rm -rf
+	find . | grep -E ".ipynb_checkpoints" | xargs rm -rf
+	find . | grep -E ".ruff_cache" | xargs rm -rf
+	rm -f .coverage
+
+install: ## Install this project to site-packages
+	uv sync --reinstall
+
+stubs: install ## Generate stub file.
+	uv run pybind11-stubgen inputtino._core -o src/
+	@sed -i 's/def _pybind11_conduit_v1_(\*args, \*\*kwargs):/def _pybind11_conduit_v1_(*args: typing.Any, **kwargs: typing.Any) -> typing.Any:/' src/inputtino/_core.pyi
+
+type: ## Run type check
+	uv run pyright src
+
+test: ## Run tests
+	uv run pytest -v --log-level INFO --cov -m "not practical"
+
+test-full: ## Run full test
+	uv run pytest -v --cov
+
+CPP_FILES=$(shell find src -regex '.*\.\(cpp\|hpp\|cc\|cxx\)')
+PYTHON_FILES=$(shell find src -regex '.*\.\(py\|pyi\)')
+PYTHON_TEST_FILES=$(shell find tests -regex '.*\.\(py\|pyi\)')
+lint: ## Run linter
+	uv run ruff check . --fix
+	cppcheck $(CPP_FILES)
+	cpplint $(CPP_FILES)
+
+format: ## Run formatter
+	uv run docformatter $(PYTHON_FILES) $(PYTHON_TEST_FILES) --in-place --wrap-summaries=79 --wrap-descriptions=72
+	uv run pyupgrade --py310-plus $(PYTHON_FILES) $(PYTHON_TEST_FILES) 
+	uv run ruff format .
+	clang-format --style=Google -i $(CPP_FILES)
+
+run: format lint test type ## Run all workflow.
+
+includes: ## Shows the include directories.
+	@pybind11-config --includes | tr ' ' '\n' | grep -e '^-I' | sed 's/^-I//'
+	@echo $(PWD)/../../include

package/engine/vendor/inputtino/bindings/python/README.md

@@ -0,0 +1,215 @@
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Document Style](https://img.shields.io/badge/%20docstyle-google-3666d6.svg)](https://google.github.io/styleguide/pyguide.html#s3.8-comments-and-docstrings)
+
+# inputtino-python
+
+Python bindings for the [inputtino](../../README.md) library, providing virtual input device control for Linux.
+
+## Features
+
+- Mouse, keyboard, touchscreen, trackpad and pen tablet input simulation
+- Full gamepad support (Xbox One, PS5, Nintendo Switch)
+- Complete type hints and documentation
+- Pythonic interface with easy-to-use API
+
+## Requirements
+
+- Python 3.10 or higher
+- Linux system with uinput support
+- Root privileges or appropriate permissions for `/dev/uinput` and `/dev/uhid` (for PS5Joypad)
+
+## Installation
+
+1. Install system dependencies:
+
+**Ubuntu / Debian**:
+
+```sh
+sudo apt install git cmake build-essential pkg-config libevdev-dev
+```
+
+**Arch Linux**:
+
+```sh
+sudo pacman -Sy git cmake base-devel pkgconf libevdev
+```
+
+**Fedora**:
+
+```sh
+sudo dnf install git cmake gcc gcc-c++ make pkgconf-pkg-config libevdev-devel
+# Optional python3-devel
+```
+
+2. Install inputtino-python:
+
+```bash
+pip install "git+https://github.com/games-on-whales/inputtino.git#subdirectory=bindings/python&branch=stable"
+```
+
+This package requires root privileges or appropriate permissions for /dev/uinput to work properly.
+
+## Quick Start
+
+### Mouse Control
+
+```python
+from inputtino import Mouse, MouseButton
+
+# Initialize mouse device
+mouse = Mouse()
+
+# Move mouse
+mouse.move(100, 50)  # Move right 100, down 50
+mouse.move_abs(500, 300, 1920, 1080)  # Move to absolute position
+
+# Click operations
+mouse.click(MouseButton.LEFT)
+mouse.click(MouseButton.RIGHT, duration=0.5)  # Hold for 0.5 seconds
+
+# Scrolling
+mouse.scroll_vertical(120)  # Scroll up
+mouse.scroll_horizontal(-120)  # Scroll left
+```
+
+### Keyboard Control
+
+```python
+from inputtino import Keyboard, KeyCode
+
+# Initialize keyboard device
+keyboard = Keyboard()
+
+# Type individual keys
+keyboard.press(KeyCode.A)
+keyboard.release(KeyCode.A)
+
+# Convenient typing with auto-release
+keyboard.type(KeyCode.ENTER)
+keyboard.type(KeyCode.from_str("space"))  # From string representation
+```
+
+### PS5 Controller
+
+```python
+from inputtino import PS5Joypad, ControllerButton, StickPosition
+
+# Initialize PS5 controller
+joypad = PS5Joypad()
+
+# Set button states
+joypad.set_pressed_buttons(ControllerButton.X | ControllerButton.DPAD_UP)
+
+# Move analog sticks
+joypad.set_stick(StickPosition.LS, x=100, y=200)
+
+# Set trigger pressure
+joypad.set_triggers(left=32000, right=16000)
+
+# Handle rumble feedback
+joypad.set_on_rumble(lambda low, high: print(f"Rumble: {low}, {high}"))
+```
+
+## Docker Container Integration
+
+When using inputtino-python in Docker environments, add these required configurations:
+
+### Required Docker Settings
+
+```yaml
+# docker-compose.yml example
+services:
+  your-service:
+    volumes:
+      - /dev/input:/dev/input:rw  # For input device access
+      - /dev/uhid:/dev/uhid       # For PS5 controller support
+    devices:
+      - /dev/uinput              # For virtual device creation
+    privileged: true             # Required for device access
+```
+
+Or when running Docker:
+
+```bash
+docker run -it --rm \
+  -v /dev/input:/dev/input:rw \
+  -v /dev/uhid:/dev/uhid \
+  --device /dev/uinput \
+  --privileged \
+  your-image-name
+```
+
+## Development
+
+Simply open this directory in your favorite IDE and use [devcontainers](https://code.visualstudio.com/docs/devcontainers/containers)!
+
+Or for a more manual approach, follow these steps:
+
+### Prerequisites
+
+- Python 3.10 or higher
+- Git
+
+### Setting Up
+
+1. If using `uv` (recommended):
+```bash
+git clone https://github.com/your-username/inputtino.git
+cd inputtino/bindings/python
+uv sync
+```
+
+2. If using `pip`:
+```bash
+git clone https://github.com/your-username/inputtino.git
+cd inputtino/bindings/python
+python -m venv ./venv
+source ./venv/bin/activate
+pip install .
+```
+
+### Running Tests
+
+```bash
+uv run pytest -v --log-level INFO --cov -m "not practical"
+```
+
+## Coding Standards
+
+### Python Code
+
+- Use type hints for all function arguments and return values
+- Prefer built-in `list` and `tuple` over `typing.List` and `typing.Tuple`
+- All public classes and methods must have docstrings (Google Style)
+- Follow PEP 8 guidelines
+- Keep functions focused and single-purpose
+- Prioritize code readability
+
+Example docstring:
+
+```python
+def function_name(param1: str, param2: list[int]) -> bool:
+    """Short description of function.
+
+    Args:
+        param1: Description of first parameter
+        param2: Description of second parameter
+
+    Returns:
+        Description of return value
+
+    Raises:
+        ValueError: Description of when this is raised
+    """
+    pass
+```
+
+### C++ Code
+
+- Use pybind11 for Python bindings
+- Run `make includes` to see the include directories path for your IDE setup
+- After modifying C++ binding code, always run `make stubs` to regenerate Python stubs
+- Follow modern C++ practices
+- Keep binding code simple and focused on Python integration
+- Document any platform-specific considerations