📦 tauri-apps / tauri-plugin-shell

Access the system shell. Allows you to spawn child processes and manage files and URLs using their default application.

Install

This plugin requires a Rust version of at least 1.77.2

There are three general methods of installation that we can recommend.

• Use crates.io and npm (easiest, and requires you to trust that our publishing pipeline worked)
• Pull sources directly from Github using git tags / revision hashes (most secure)
• Git submodule install this repo in your tauri project and then use file protocol to ingest the source (most secure, but inconvenient to use)

src-tauri/Cargo.toml

[dependencies]
tauri-plugin-shell = "2.0.0"
# alternatively with Git:
tauri-plugin-shell = { git = "https://github.com/tauri-apps/plugins-workspace", branch = "v2" }

You can install the JavaScript Guest bindings using your preferred JavaScript package manager:

pnpm add @tauri-apps/plugin-shell
# or
npm add @tauri-apps/plugin-shell
# or
yarn add @tauri-apps/plugin-shell

Usage

First you need to register the core plugin with Tauri:

src-tauri/src/lib.rs

fn main() {
    tauri::Builder::default()
        .plugin(tauri_plugin_shell::init())
        .run(tauri::generate_context!())
        .expect("error while running tauri application");
}

Afterwards all the plugin's APIs are available through the JavaScript guest bindings:

import { Command } from '@tauri-apps/plugin-shell'
Command.create('git', ['commit', '-m', 'the commit message'])

Contributing

PRs accepted. Please make sure to read the Contributing Guide before making a pull request.

Partners

For the complete list of sponsors please visit our website and Open Collective.

License

Code: (c) 2015 - Present - The Tauri Programme within The Commons Conservancy.

MIT or MIT/Apache 2.0 where applicable.