Sniplet is a work in progress CLI tool which can do text replacement globally in Linux, MacOS and Windows. It is a multi-threaded tool which runs quietly in the background with minimal resource utilization. It is open source and works completely offline.


  1. Custom Text Expansions
  2. Background process with low resource utilization
  3. Multi Line expansion support

Sample Video:



Python is required

Might require admin or su permission to install

Installing using pip:

  pip install sniplet==1.0.7

Installing from source:

  1. Download the files from github

  2. Run the following command in the terminal

     python install
  3. If you don't want Sniplet to be installed globally, it is recommended to create a virtualenv to install it

Adding Sniplet to the PATH variable on Windows:

  1. The Windows install is slightly different and pip install is recommended

  2. After installing the package find the python install folder with the following command

      python3 -c "import imp, os; os.chdir(imp.find_module('sniplet')[1]); os.chdir('../'); os.chdir('../'); print(os.getcwd() + '\\Scripts\\')"
  3. Copy this path and add to the following command

      setx PATH "%PATH%;[PathCopied]"


  1. Run the following command to configure the text replacements

     sniplet --config
  2. Alternatively, you can create your own file with the following specification and save it as a txt file. An example is provided inside config-files

     [Shortcut name]
     [Replacement lines]


  1. To start Sniplet just invoke sniplet and mention the config file you want to use (created using --config)

  2. To start Sniplet with your custom file use the following command. Replace filepath by the path to your custom file

     sniplet --usrfile [FILEPATH]
  3. To stop Sniplet use the keyboard interrupt in the terminal


Use the following command to get more info about usage and configuration

  sniplet --help

Known Issues:

  1. Threads crashing if ended abruptly
  2. Residual keyboard inputs dumped after aborting (Problem with MacOS)