README.md

webbrowser

Rust library to open URLs in the web browsers available on a platform

Inspired by the webbrowser python library

Documentation

• API Reference
• Release Notes

Examples

use webbrowser;

if webbrowser::open("http://github.com").is_ok() {
    // ...
}

Platform Support

Platform	Supported	Browsers	Test status
macos	✅	default + others	✅ (unencoded non-ascii URLs currently fail on Github, but work locally, so YMMV)
windows	✅	default only	✅
linux/*bsd	✅	default only (respects $BROWSER env var, so can be used with other browsers)	✅
android	✅	default only	✅
wasm	✅	default only	✅
haiku	✅ (experimental)	default only	❌
ios	❌	default only	❌

Looking to contribute?

PRs invited for

• Fixing macos tests for UTF-8 URLs
• Support for other platforms, e.g. iOS

Important note (while testing):

• This library requires availability of browsers and a graphical environment during runtime
• cargo test will actually open the browser locally

When contributing, please note that your work will be dual licensed as MIT + Apache-2.0 (see below).

License

Licensed under either of

• Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.