https://github.com/michidk/displayz

A CLI tool and library to control display settings on Windows written in Rust.
https://github.com/michidk/displayz

cli display display-library display-settings hacktoberfest monitoring-tool rust settings

Last synced: 17 days ago
JSON representation

A CLI tool and library to control display settings on Windows written in Rust.

• Host: GitHub
• URL: https://github.com/michidk/displayz
• Owner: michidk
• License: mit
• Created: 2022-06-09T05:19:45.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2025-04-01T23:18:29.000Z (25 days ago)
• Last Synced: 2025-04-02T00:24:45.334Z (25 days ago)
• Topics: cli, display, display-library, display-settings, hacktoberfest, monitoring-tool, rust, settings
• Language: Rust
• Homepage: https://docs.rs/displayz/latest/displayz/
• Size: 33.2 KB
• Stars: 43
• Watchers: 3
• Forks: 11
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# displayz

[![MIT License](https://img.shields.io/crates/l/displayz)](https://choosealicense.com/licenses/mit/) [![Continuous Integration](https://github.com/michidk/displayz/actions/workflows/ci.yaml/badge.svg)](https://github.com/michidk/displayz/actions/workflows/ci.yaml) [![rust docs](https://docs.rs/displayz/badge.svg)](https://docs.rs/displayz/latest/displayz/) [![Crates.io](https://img.shields.io/crates/v/displayz)](https://crates.io/crates/displayz)

[![Chocolatey](https://img.shields.io/chocolatey/v/displayz?include_prereleases)](https://community.chocolatey.org/packages/displayz)

A CLI tool and library to control display settings on Windows written in Rust.

## Installation

### Chocolatey

Install [displayz using Chocolatey](https://community.chocolatey.org/packages/displayz) on Windows:

```sh

choco install displayz

```

### Cargo

Install [displayz using Cargo](https://crates.io/displayz) on Windows:

```sh

cargo install displayz

```

## Usage

### Commandline

After installation, the `displayz` command will be available.

Use the following command to access the help:

```sh

displayz --help

```

The following subcommands are available:

- `set-primary --id `: Sets the display with the specified ID as the primary display.

- `primary `: Sets the primary display properties.

- `properties --id  `: Sets the display properties for the specified ID.

The `` argument can be multiple (but at least one and max one per kind) of:

- `--position ,`: Sets the position of the display.

- `--resolution x`: Sets the resolution of the display.

- `--orientation `: Sets the orientation of the display.

  - Orientation can be either `Default`, `UpsideDown`, `Right` or `Left`.

- `--fixedoutput `: Sets the fixed output mode of the display.

  - The mode can be one of `Default`, `Stretch` or `Center`.

- `--frequency `: Sets the refresh rate of the display.

### Rust Library

See the examples in the [examples/](examples/) folder and the [documentation](https://docs.rs/displayz/latest/displayz/) on how to use the library.