rust-discord-activity

Crates.iorust-discord-activity
lib.rsrust-discord-activity
version0.3.1
sourcesrc
created_at2023-12-30 08:54:46.177477
updated_at2024-10-16 10:39:35.392549
descriptionA lightweight library to control Discord Rich Presence
homepage
repositoryhttps://github.com/DylanCa/Rust-Discord-Activity
max_upload_size
id1083991
size23,896
Dylan. (DylanCa)

documentation

https://docs.rs/Rust-Discord-Activity/latest

README

Rust Discord Activity

A lightweight Rust library to control Discord Rich Presence

crates.io maintenance-status docs.rs

Installation

Rust Discord Activity is available directly on crates.io: cargo add rust-discord-activity

How to use

  1. Instantiate a new DiscordClient
  2. Create your Activity and set desired data using provided structs
  3. Create a new Payload with your Activity
  4. Send your Payload through the DiscordClient

Et voilĂ  !

Example

let mut client = DiscordClient::new("<application_id>");

let _ = client.connect();

let limg = Some(String::from("https://placehold.co/600x400/png"));
let simg = Some(String::from("https://placehold.co/200x100/png"));
let asset = Asset::new(limg, None, simg, None);
let now_in_millis = SystemTime::now().duration_since(UNIX_EPOCH).unwrap().as_millis();
let timestamp = Timestamp::new(Some(now_in_millis - 10000), None);

let party = Party::new(None, Some((2, 4)));
let mut button_vec = vec![];
button_vec.push(Button::new("First Button".into(), "https://google.com".into()));
button_vec.push(Button::new("Second Button".into(), "https://yahoo.com".into()));

let mut activity = Activity::new();

activity
    .set_state(Some("This is State".into()))
    .set_activity_type(Some(ActivityType::LISTENING))
    .set_details(Some("This is Details".parse().unwrap()))
    .set_timestamps(Some(timestamp))
    .set_assets(Some(asset))
    .set_party(Some(party))
    .set_instance(Some(true))
    .set_buttons(Some(button_vec));

let payload = Payload::new(EventName::Activity, EventData::Activity(activity));

let _ = client.send_payload(payload);

And voilĂ ! This sets-up a new Activity for the current Discord user:

Discord Rich Presence

Limitations

For the moment, the library only works with MacOS and local Discord application.

Next Steps

  • Write proper documentation for this library
  • Write unit tests
Commit count: 61

cargo fmt