mac-terminal

Control the macOS Terminal app with Node.js

Install

npm install mac-terminal

API

getTerminalDefaultProfile()

function getTerminalDefaultProfile(): Promise<string>;

Example

import {getTerminalDefaultProfile} from 'mac-terminal';

await getTerminalDefaultProfile(); // 'Clear Dark'

getTerminalProfiles()

function getTerminalProfiles(): Promise<string[]>;

Get a list of installed Terminal profiles

Example

import {getTerminalProfiles} from 'mac-terminal';

await getTerminalProfiles(); // ['Basic', 'Clear Dark', 'Clear Light', ...]

isTerminalRunning()

function isTerminalRunning(): Promise<boolean>;

Determine whether Terminal is currently running

Example

import {isTerminalRunning} from 'mac-terminal';

await isTerminalRunning(); // true

setTerminalDefaultProfile()

function setTerminalDefaultProfile(profile: string): Promise<void>;

Set the default Terminal profile for new windows / tabs

Example

import {setTerminalDefaultProfile} from 'mac-terminal';

await setTerminalDefaultProfile('Clear Dark');

setTerminalProfile()

function setTerminalProfile({
	profile: string,
	setDefault?: boolean = false
}): Promise<void>;

Update all open Terminal tabs to the given profile

Examples

import {setTerminalProfile} from 'mac-terminal';

await setTerminalProfile({profile: 'Clear Dark'});

await setTerminalProfile({
	profile: 'Clear Dark',
	setDefault: true, // Also set as the default profile
});

Related

• auto-terminal-profile – Automatically switch Terminal profiles when macOS dark/light mode changes