StickUp

🚀 Update: v0.2.0 is here!
StickUp now supports full per-frame state snapshots, binding resolution ("joy0.axis1"), and cleaner device management via the new DeviceManager.
Built to scale with sim rigs, overlays, game engines, and beyond.

Already passed 500 downloads in 24 hours — thank you to everyone testing and sharing it

🔐 Security Note

The name stickup was previously used in 2023 for a malicious crate which has since been removed from crates.io. (I wasn't aware of this at the time of publishing.)

This version — authored by Belegrade Studio — is a clean and fully rewritten project, unrelated to the original.

✅ No build.rs
✅ No network activity
✅ 100% open and auditable

Transparency and trust matter. You're welcome to inspect the source or reach out directly

StickUp is a modular, high-performance input framework for Rust.
It supports both HID and virtual devices with precision, persistence, and clarity.

Created by Belegrade Studio as part of the CelerisTech stack.

✨ Features

• 🔌 Plug-and-play device management via DeviceManager
• 🎮 Unified Device trait for axis + button input
• 🧠 Persistent device identity (hardware fingerprint)
• 🧰 Binding resolution like "joy0.axis1" → Option<f32>
• 🔁 Per-frame polling and snapshot state tracking
• 🔧 Hotplug-friendly and fully extendable
• 🛠 Supports hid and virtual backends via features
• 💡 Zero magic — minimal, intentional design

📦 Installation

stickup = { version = "0.2.0", features = ["hid", "virtual"] }

🚀 Quick Start

use stickup::DeviceManager;

fn main() {
    let mut input = DeviceManager::new();
    input.snapshot(); // poll + build snapshot

    if let Some(throttle) = input.get_axis("joy0.throttle") {
        println!("Throttle: {:.2}", throttle);
    }

    if input.is_pressed("joy1.trigger") {
        println!("Trigger is pressed!");
    }
}

📋 Full Snapshot Example

let mut input = DeviceManager::new();
let state = input.snapshot();

for (id, device_state) in state.iter() {
    println!("Device: {id}");

    for (axis, value) in &device_state.axes {
        println!("  Axis {axis}: {value:.2}");
    }

    for (button, pressed) in &device_state.buttons {
        println!("  Button {button}: {}", if *pressed { "Pressed" } else { "Released" });
    }
}

🧬 Device Identity

StickUp assigns a stable, persistent ID to each device:

vendor_id:product_id:serial_number
# Example: 044f:0402:ABCD1234

🔍 Examples

Run any with:

cargo run --example <name>

• poll – Print a full snapshot of all input state
• virtual_demo – Feed input into a simulated virtual device

🛠️ Optional Features

🧭 Philosophy

StickUp is about presence, clarity, and persistence.
It doesn't guess. It doesn't simulate. It reflects exactly what your device is doing — no more, no less.

📜 License

This project is licensed under the Pact of the Amaranth Rite.
See LICENSE for details.

Third-Party Dependencies

StickUp uses the following libraries, each under permissive open source licenses:

• hidapi — MIT/Apache-2.0 (HID support)
• serde — MIT/Apache-2.0 (serialization)
• serde_json — MIT/Apache-2.0 (layout/config IO)
• toml — MIT/Apache-2.0 (if config parsing used)

💬 Connect

• ✉️ Email: belegrade@belegrades.gg
• 💬 Discord: Join the Chat
• 🎮 Sim pilots & devs: I’d love to hear how you’re using StickUp.