https://github.com/soliez/mac-utils
A collection of useful (mostly macOS specific) shell scripts
https://github.com/soliez/mac-utils
apple bash bash-script bash-scripting mac macos shell shell-scripting shell-scripts utilities utility utils
Last synced: 2 months ago
JSON representation
A collection of useful (mostly macOS specific) shell scripts
- Host: GitHub
- URL: https://github.com/soliez/mac-utils
- Owner: Soliez
- License: mit
- Created: 2024-06-24T04:32:13.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-04-06T20:41:55.000Z (3 months ago)
- Last Synced: 2025-04-06T21:31:27.345Z (3 months ago)
- Topics: apple, bash, bash-script, bash-scripting, mac, macos, shell, shell-scripting, shell-scripts, utilities, utility, utils
- Language: Shell
- Homepage:
- Size: 59.6 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Getting Started
To get started using the tools in this repository first install them using one of the methods below.
# Automated Installation (Makefile)
## Step 1: Clone this repository
```bash
git clone https://github.com/Soliez/mac-utils.git
```
## Step 2: Run the Makefile
First, `cd` into the project directory.
```bash
cd mac-utils
```
Then, run the following `make` command.
### `zsh`
```bash
make install
```
### `bash`
```bash
make install PROFILE=~/.profile
```
### Other shells
```bash
make install PROFILE=
```
> If you use a shell other than `bash` or `zsh`, replace `` with the path to your shell profile file in the above command
# Manual Installation
## Step 1: Install Command Line Tools for Xcode
Some of the scripts in this repository use tools from Apple's [`Command Line Tools for Xcode`](https://developer.apple.com/download/all/) package. You can install them with the following command.
```bash
xcode-select --install
```
Please ensure you have them installed in order to use all the tools in this repository.
## Step 2: Clone this repository
```bash
git clone https://github.com/Soliez/mac-utils.git
```
## Step 3: Install External Dependencies
Some of the scripts in this repository require you to install an external dependency to use.
These dependencies include:
- [`exiftool`](https://exiftool.org) - Perl lib for reading and writing EXIF metadata
- [`jq`](https://jqlang.github.io/jq/) - Lightweight and flexible command-line JSON processor
- [`man2html`](https://savannah.nongnu.org/projects/man2html/) - Convert nroff man pages to HTML
- [`pandoc`](https://pandoc.org/) - Swiss-army knife of markup format conversion
- [`ffmpeg`](https://ffmpeg.org/) - Media Converter
- [`tree`](https://oldmanprogrammer.net/source.php?dir=projects/tree) - Display directories as trees (with optional color/HTML output)
You can install each of these via [Homebrew](https://brew.sh) with the following one-liner.
```bash
brew install exiftool jq man2html pandoc ffmpeg tree
```
## Step 4: Add the repository's `bin` directory to your `PATH`
You will need to add the project's `bin` directory to your `PATH` variable to be able to call each script without providing it's full path each time.
To enable this, add the following lines to your shell profile file (i.e `~/.profile` or `~/.zprofile`)
```bash
# Add mac-utils repository tools to PATH
export PATH="/path/to/mac-utils/bin:$PATH"
```
> In this example, replace `/path/to/mac-utils/bin` with the full to path to the `bin` directory in the mac-utils repository on your computer.
## Step 5: Add the project's manual pages to `MANPATH`
To get help on any of the scripts in this repository you can view it's manual page using `man ` or by calling the script with its `-h` or `--help` flag.
To enable this, first run the following commands
```bash
# Create a local man directory in your home directory if it dosen't already exist
mkdir -p ~/man/man1
# Copy all of the project's manual pages to your local man directory
cp /path/to/mac-utils/man/*.1 ~/man/man1
```
> In this example, replace `/path/to/mac-utils/man` with the full to path to the `man` directory in the mac-utils repository on your computer.
Next, add the following lines to your shell profile file (i.e `~/.profile` or `~/.zprofile`)
```bash
# Add mac-utils repo man pages to MANPATH
export MANPATH="$HOME/man/man1:$MANPATH"
```
---