i3ipc-rs

一个 Rust 库，通过其 IPC 接口 控制 i3-wm。

用法

将以下内容添加到您的 Cargo.toml 中

[dependencies.i3ipc]
version = "0.10.1"

消息

extern crate i3ipc;
use i3ipc::I3Connection;

fn main() {
    // establish a connection to i3 over a unix socket
    let mut connection = I3Connection::connect().unwrap();
    
    // request and print the i3 version
    println!("{}", connection.get_version().unwrap().human_readable);
    
    // fullscreen the focused window
    connection.run_command("fullscreen").unwrap();
}

事件

extern crate i3ipc;
use i3ipc::I3EventListener;
use i3ipc::Subscription;
use i3ipc::event::Event;

fn main() {
    // establish connection.
    let mut listener = I3EventListener::connect().unwrap();

    // subscribe to a couple events.
    let subs = [Subscription::Mode, Subscription::Binding];
    listener.subscribe(&subs).unwrap();

    // handle them
    for event in listener.listen() {
        match event.unwrap() {
            Event::ModeEvent(e) => println!("new mode: {}", e.change),
            Event::BindingEvent(e) => println!("user input triggered command: {}", e.binding.command),
            _ => unreachable!()
        }
    }
}

版本控制

默认情况下，i3ipc-rs 以最小 i3 版本 4.11 为目标。要解锁更多功能，您可以在 Cargo.toml 中选择以下之一： "i3-4-12"， ..., "i3-4-14"。

[dependencies.i3ipc]
version = "0.10.1"
features = ["i3-4-14"]

编译的二进制文件不理解 i3 IPC 接口的扩展通常将返回一个 Unknown 值，并使用 log crate 将警告记录到目标 "i3ipc"。使用此库的二进制文件应 安装日志记录器 以查看此类扩展的详细信息。