hyprkvm Public

Notifications Fork 0 Star 0
cf52745
Branches trunk
1 Branches 0 Tags
Go to file T
Code
mfwolffe Add networking, state management, and configuration
cf52745 5 Commits
config Add networking, state management, and configuration
contrib Add networking, state management, and configuration
hyprkvm-cli Add project structure with Hyprland IPC client
hyprkvm-common Add project structure with Hyprland IPC client
hyprkvm-daemon Add networking, state management, and configuration
scripts Add networking, state management, and configuration
.gitignore init
Cargo.lock Add project structure with Hyprland IPC client
Cargo.toml Add project structure with Hyprland IPC client
README.md Add networking, state management, and configuration
flake.lock Add networking, state management, and configuration
flake.nix add flake for dev

HyprKVM

Hyprland-native software KVM switch that integrates with workspace navigation.

Features

  • Workspace-integrated switching: Move past your last workspace to switch machines
  • Mouse edge switching: Standard screen-edge triggers like Synergy/Barrier
  • Encrypted connections: TLS with certificate pinning
  • Clipboard sharing: Sync clipboard between machines
  • GUI and CLI: Visual layout editor or config-file driven

Status

🚧 Early Development - Sprint 0 in progress

Building

Prerequisites

  • Rust 1.75+
  • GTK4 development libraries (for future GUI)
  • Hyprland

Arch Linux / CachyOS

sudo pacman -S rust gtk4 libadwaita

NixOS

nix develop  # When flake is available

Build

cargo build --release

Quick Start

  1. Start the daemon:

    ./target/release/hyprkvm daemon

  2. Configure neighbor machines in ~/.config/hyprkvm/hyprkvm.toml:

    [machines]
self_name = "my-laptop"

[[machines.neighbors]]
name = "desktop"
direction = "right"
address = "desktop.local:24850"

  3. Optionally, install keybinding interceptors in your hyprland.conf:

    bind = SUPER, Left,  exec, ~/.config/hypr/scripts/hyprkvm-move.sh left
bind = SUPER, Right, exec, ~/.config/hypr/scripts/hyprkvm-move.sh right
bind = SUPER, Up,    exec, ~/.config/hypr/scripts/hyprkvm-move.sh up
bind = SUPER, Down,  exec, ~/.config/hypr/scripts/hyprkvm-move.sh down

Configuration

See config/hyprkvm.example.toml for all options.

Architecture

See docs/ROADMAP.md for the full architecture and development plan.

License

MIT License