An easy to use clipboard manager made using tkinter.
Switch branches/tags
Nothing to show
Clone or download
#18 Compare This branch is even with nikhilkumarsingh:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
clix
.gitignore
LICENSE.txt
MANIFEST.in
README.md
README.rst
icon.ico
requirements.txt
setup.py

README.md

PyPI license

clix

An easy to use clipboard manager made using tkinter.

Note: Currently, clix works only on Linux systems.

Installation

  • To install clix, simply,

     $ pip install clix
    
  • If you get ImportError for Xlib module, install it using this command:

     $ sudo apt-get install python-xlib
    

Usage

  • To run clix, open terminal and run this command:

     $ clix
    

    if error shown try:

     $ sudo clix
    

    On Mac OSX, one of the following must be true:

      -The process must run as root.
      -Your application must be white listed under Enable access for assistive devices. Note that this might require that you package your  	application, since otherwise the entire Python installation must be white listed.
    

    Note: Leave this terminal open as long as you want to use clix.

    Another alternative is to use this command:

    $ nohup clix &
    

    Now, you can close the terminal but clix will keep running.

    To close clix, open a terminal and simply run:

    $ pkill clix
    
  • Press Ctrl + space keys to open clix GUI. And Ctrl + space again to close it. Initially, all clip frames are empty.

  • Now, as you copy any text, (using Ctrl + c keys), the text is saved to topmost frame of clix clipboard.

  • Whenever you want to paste any clip, just open clix GUI (usin Ctrl + space keys) and click on clip it button to copy clip text to main clipboard.

    Now, simply pressing Ctrl + v keys will paste the desired clip text!

  • CLI usage to configure keys

     $ clix [-h] [-s SET_KEYBINDING] [-a] [-c]
    

    You can always use $ clix -h command to open this help message:

     optional arguments:
       -h, --help            show this help message and exit
       -s SET_KEYBINDING, --set-keybinding SET_KEYBINDING
                             Set alternate key binding. Default is LCTRL+SPACE
                             Format :- <KEY1>+<KEY2>. Ex:- RCTRL+RALT. To see
                             availble key bindings use 'clix -a' option
       -a, --available-keybindings
                             Show available key bindings
       -c, --show-current-keybinding
    

TODO

  • Add support for user configurable keys.

  • Add support for Windows and MacOS.

  • Create a file system to log the clipboard.

  • Improve UI.

  • Add more functionalities.

Want to contribute?

  • Clone the repository

     $ git clone http://github.com/nikhilkumarsingh/clix
    
  • Install dependencies

     $ pip install -r requirements.txt
    
  • Remove the . prefix from .pyxhook and .gui for the following imports in clix.py, so it changes from:

     from .pyxhook import HookManager
     from .gui import clipboard

    to:

     from pyxhook import HookManager
     from gui import clipboard
  • To test local version of clix:

     $ pip install -U .
    

    OR :

     $ pip install -e <project dir.> .
    

Finally, do report bugs and help us make clix more and more productive!