message_visualizer v0.0.1

Message_visualizer

forked from macos-key-cast

Origin Readme

Send simple message to screen on macOS. Useful for simple notification.

Requires macOS 10.12 or later.

Run as CLI

Installing

Download the excutable file from release

Usage

Usage: message_visualizer <text> [options]

Options:
  -b, --bounds <value>      JSON object with bounds of a rectangle to show the UI in. Example: '{"bounds":[[955,627],[656,384]]}'
  -d, --display <value>     Display number of the screen to show the UI in. Defaults to the main screen.
  -h, --help                Show help information
  -k, --key-combinations    Show key combinations only
  -s, --size <value>        Size of the window and font to use. Defaults to normal
  -t, --delay <value>       How long the key remains on screen in seconds

Node API

Installation

$ npm install macos-key-cast

Demo

Dark Mode support

API

castKeys(options: object): PCancelable<void>

Start the process.

The returned promise is an instance of PCancelable, so it has a .cancel() method which can be used to kill the process

options: object

Additional options passed to the CLI

options.size: 'small' | 'normal' | 'large'

Default: normal

How big the window and the font should be

options.delay: number

Default: 0.5

How long the window should remain on screen after the last key press

options.display: number

Display id of the screen to show the UI in. Defaults to the main screen.

Note: If you are using electron, you can find the display id in the Display Object.

options.keyCombinationsOnly: boolean

Default: false

Whether or not it should track all key presses or only combinations

options.bounds: Object

An object containing keys x, y, width, height defining an area within the display to use for the UI's initial position.

Contributing

If you want to use this and need more features or find a bug, please open an issue and I'll do my best to implement.

PRs are always welcome as well 😃

Related

• mac-focus-window - Focus a window and bring it to the front on macOS
• mac-windows - Provide Information about Application Windows running
• macos-accessibility-permissions - Check and request macOS accessibility permissions

License

MIT