Skip to content
Window handling library in pure Rust
Branch: master
Clone or download
t6 and Osspial Fix build on FreeBSD (#815)
* Fix build on FreeBSD

error[E0432]: unresolved import `libc::__errno_location`
  --> src/platform/linux/x11/
22 | use libc::{select, fd_set, FD_SET, FD_ZERO, FD_ISSET, EINTR, EINVAL, ENOMEM, EBADF, __errno_location};
   |                                                                                     ^^^^^^^^^^^^^^^^ no `__errno_location` in the root

__errno_location is called __error on FreeBSD and __errno on Open- and NetBSD.

Signed-off-by: Tobias Kortkamp <>

* Import __error / __errno on *BSD as __errno_location

Signed-off-by: Tobias Kortkamp <>

* Add changelog entry

Signed-off-by: Tobias Kortkamp <>
Latest commit 0019ff2 Mar 22, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Implement virtual key translation for emscripten (#289) Sep 16, 2017
examples feat: add macos simple fullscreen (#692) Dec 19, 2018
src Fix build on FreeBSD (#815) Mar 22, 2019
.gitignore X11+Windows: Guess initial DPI factor (#583) Jul 1, 2018
.gitmodules Add basic support for Android Sep 11, 2014
.travis.yml Fix build on FreeBSD (#815) Mar 22, 2019
Cargo.toml Update winit to 0.19.0 (#798) Mar 7, 2019

winit - Cross-platform window creation and management in Rust Build Status Build status

winit = "0.19.0"


Contact Us

Join us in any of these:

Freenode Matrix Gitter


Winit is a window creation and management library. It can create windows and lets you handle events (for example: the window being resized, a key being pressed, a mouse movement, etc.) produced by window.

Winit is designed to be a low-level brick in a hierarchy of libraries. Consequently, in order to show something on the window you need to use the platform-specific getters provided by winit, or another library.

extern crate winit;

fn main() {
    let mut events_loop = winit::EventsLoop::new();
    let window = winit::Window::new(&events_loop).unwrap();

    events_loop.run_forever(|event| {
        match event {
            winit::Event::WindowEvent {
              event: winit::WindowEvent::CloseRequested,
            } => winit::ControlFlow::Break,
            _ => winit::ControlFlow::Continue,

Winit is only officially supported on the latest stable version of the Rust compiler.

Cargo Features

Winit provides the following features, which can be enabled in your Cargo.toml file:

  • icon_loading: Enables loading window icons directly from files. Depends on the image crate.
  • serde: Enables serialization/deserialization of certain types with Serde.

Platform-specific usage

Emscripten and WebAssembly

Building a binary will yield a .js file. In order to use it in an HTML file, you need to:

  • Put a <canvas id="my_id"></canvas> element somewhere. A canvas corresponds to a winit "window".
  • Write a Javascript code that creates a global variable named Module. Set Module.canvas to the element of the <canvas> element (in the example you would retrieve it via document.getElementById("my_id")). More information here.
  • Make sure that you insert the .js file generated by Rust after the Module variable is created.
You can’t perform that action at this time.