Skip to content

A tiny Rust library that allows you to easily obtain selected text across all platforms (macOS, Windows, Linux).

Notifications You must be signed in to change notification settings

yetone/get-selected-text

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

get-selected-text

Lint crates.io

A tiny Rust library that allows you to easily obtain selected text across all platforms (macOS, Windows, Linux).

Corresponding Node.js package: node-get-selected-text

Usage

Add:

cargo add get-selected-text

Use:

use get_selected_text::get_selected_text;

fn main() {
    match get_selected_text() {
        Ok(selected_text) => {
            println!("selected text: {}", selected_text);
        },
        Err(()) => {
            println!("error occurred while getting the selected text");
        }
    }
}

How does it work?

macOS

Prioritize using the A11y API to obtain selected text. If the application does not comply with the A11y API, simulate pressing cmd+c to borrow from the clipboard to get the selected text.

To avoid annoying Alert sounds when simulating pressing cmd+c, it will automatically mute the Alert sound (Only the Alert sound is muted, it won't affect the volume of listening to music and watching videos). The volume of the Alert sound will be restored after releasing the key.

Therefore, on macOS, you need to grant accessbility permissions in advance. The sample code is as follows:

fn query_accessibility_permissions() -> bool {
    let trusted = macos_accessibility_client::accessibility::application_is_trusted_with_prompt();
    if trusted {
        print!("Application is totally trusted!");
    } else {
        print!("Application isn't trusted :(");
    }
    trusted
}

Windows + Linux

Simulate pressing ctrl+c to use the clipboard to obtain the selected text.

About

A tiny Rust library that allows you to easily obtain selected text across all platforms (macOS, Windows, Linux).

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages