Sniplet

<div align = "center">

<img src="./images/logo.png" width="100" height="100"></img>

</div> <h1 align = "center">Sniplet</h1> <p align = "center">Free and Open Source Text Replacement Tool</p> <div align = "center">

</div>

Description:

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.

Features:

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

Sample Video:

<img src="./images/Sample.gif" width="660" height="210"></img>

Installation:

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 setup.py 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]"
   

Configuration:

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

    Short:
    [Shortcut name]
    Repl:
    [Replacement lines]
    ...
   

Usage:

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

Help

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)