README.md

   1 # CHARSEL
   2 A simple bash script to make copying frequently used special characters to your clipboard easy.
   3
   4 It uses a plain-text file known as a "charfile" to define shortcuts to special characters that are easy to access on the keyboard.
   5
   6 ## Installation
   7 Run `make install` as root to install
   8 Run `make uninstall` as root to remove. Will not delete your personal charfiles
   9
  10 ## Dependencies
  11   * Bash
  12   * Linux
  13   * Xclip
  14   * A terminal with UTF-8 encoding enabled
  15
  16 ## Usage
  17 To start the program, run `charsel <charfile>`, this will start the program with the specified charfile. There are a few installed by default, to see them, use `charsel list`.
  18
  19 Once you have started the program, simply type the shortcut listed on the left side of the table to copy the character on the right side of the table to your clipboard. Shortcodes the same length as the longest one will automatically be entered.
  20
  21 Some of the default charfiles have hidden shortcuts for capital letters that are not shown on the table. Simply type a capital version of the shortcut key to access the capital version of the special character.
  22
  23 ## Creating a charfile
  24 Make a new file in `~/.local/share/charsel/` or `/usr/share/charsel` with the name that you would like to use to call the charfile in the command.
  25
  26 Fill it in, using the provided examples as a template. Hidden shortcuts go above the '-', lines can be commented out using a '#' at the start of the line
  27
  28 ## License
  29 Charfile is GNU GPLv3 licensed, see COPYING for more information
  30
  31 Charfile is written by [Armaan Bhojwani](https://armaan.bhojwani.org), [Email](mailto:3fb650a9-b47e-4604-a282-1dd91953b2ee@anonaddy.me)