Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/kamilturek/macd

A macOS command line tool to manage an arrangement and configuration of your displays.
https://github.com/kamilturek/macd

display display-manager mac macos

Last synced: 26 days ago
JSON representation

A macOS command line tool to manage an arrangement and configuration of your displays.

Awesome Lists containing this project

README

        

# Mac Display Utility

A macOS command line tool to manage an arrangement
and configuration of your displays. A minimalistic alternative
and direct derivative of (apparently) no longer maintained
[displayplacer](https://github.com/jakehilborn/displayplacer).

## Usage

1. Go to System Preferences > Displays. Arrange your displays as desired.
1. Save your current display configuration by running:

```bash
macd save-configuration
```

1. Repeat steps 1-2 for every display configuration you need.
1. Apply any saved configuration by running:

```bash
macd apply-configuration
```

Configurations can be also edited manually via `~/.macd.json` file.

## Commands

- `macd list-displays` - list online displays and their properties
(origin, width, height, is built-in, is main).
- `macd list-configurations` - list saved configurations.
- `macd save-configuration ` - save the current configuration
of displays under ``.
- `macd apply-configuration ` - apply the saved configuration.

## Installation

```bash
brew install kamilturek/tap/macd
```

## Compilation

```bash
make
```

## Contribution

Please create a GitHub issue for any feedback, bugs,
feature requests or issues. PRs are also welcome.