ProClip

A lightweight terminal extension written in Python for storing and executing frequently used commands conveniently instead of having to re-type them everytime.

Requires Python 3+, created with PyCharm Python IDE

The executable ('pcl') for this tool (required for Homebrew) was created with pyinstaller:

pyinstaller ProClip.py --onefile

Local SQL database is stored in "userhome/Library/Application Support/ProClip"

Installation

ProClip can be installed and upgraded using Homebrew, to do so, follow the steps below.

Clone the repository and add the brew formula to the brew search path using:

  brew tap philjay/proclip https://github.com/PhilJay/homebrew-proclip.git

Install "proclip":

  brew install proclip

In order to upgrade to a newer version once already installed, run:

  brew tap philjay/proclip https://github.com/PhilJay/homebrew-proclip.git
  brew upgrade proclip

Usage

After successful installation, ProClip can be used via the pcl command:

  # shows the help explaining all available commands
  pcl -h

  # lists all currently stored entries / shortcuts
  pcl -l 
  
  # stores the command "ping www.google.com" under the alias pg (ping google)
  pcl -s pg "ping www.google.com"
  
  # executes "ping www.google.com"
  pcl -e pg
  
  # copies "ping www.google.com" to the clipboard
  pcl -c pg
  
  # removes the "pg" alias (meaning it is no longer usable and can be replaced by a new command)
  pcl -r pg
  
  # -v option enables "verbose" output for all preceding arguments
  pcl -l -v

More examples

  # store multiple commands and execute them at once
  pcl -s test "mkdir test && cd test && touch test1.txt"
  
  # execute the command and perform all operations (crate folder, move to it, create file)
  pcl -e test
  
  # execute the stored "test" command with additional arguments "test2.txt" (provided via -a)
  pcl -e test -a "test2.txt"
  # executed command -> "mkdir test && cd test && touch test1.txt test2.txt"