📡 Discord IPC

discordipc is a Rust library that enables connection and interaction with Discord's IPC, allowing you to set custom activities for your project.

⭐ Features

✅ Rich Presence: Set custom activities, statuses, and more.
✅ Event listeners: Handle Discord responses dynamically with event listeners.
✅ Custom Packets: Extend functionality for advanced interactions.

🚀 Installation

Add the following to your Cargo.toml:

[dependencies]
discordipc = "0.1.1"

Or run:

cargo add discordipc

🔧 Basic usage

use discordipc::{activity::Activity, packet::Packet, Client};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new_simple("<application_id>");

    client.connect_and_wait()?.filter()?;

    let activity = Activity::new().details("Some activity");
    let activity_packet = Packet::new_activity(Some(&activity), None);

    match client.send_and_wait(activity_packet)?.filter() {
        Ok(_packet) => println!("Activity has been set!"),
        Err(e) => println!("Couldn't set activity: {}", e),
    }

    println!("Press ENTER to exit...");
    std::io::stdin().read_line(&mut String::new()).unwrap();
    client.disconnect()?;
    println!("Disconnected");

    Ok(())
}

🔎 Examples

All usage examples are located in the examples folder. You can run an example by executing:

cargo run --example <example_name>

Replace <example_name> with the name of the example file you wish to try.

🤝 Contributing

This is a small project and all contributions are widely appreciated! Any help whether it's improving the documentation, fixing bugs, adding new features, or sharing ideas is welcome.
Don’t forget to leave a ⭐ if you find the library useful!