Convert "Screenshot-sharing" utility links to markdown-ready \*.png files I'm sure you are also annoyed that screenshot-sharing utilities like Screencloud and Dropbox only copy a link to their screenshot viewing page, not to the ``.png`` file itself.
==========================================================================================================================================================================================================================================================

If you've installed as a command line utility, simply type
``copyscreen`` at the command prompt to fetch the actual image file from
the link that is currently in your clipboard (or, alternatively, pass
the link directly as an argument
(``copyscreen http://dropbox.screenshotaddress.com?dl=0``).

If you are using python, use this module to quickly
``convert_clipboard()`` to a downloadable link.

In the background, this simply accesses the page linked by the
screenshot-sharing utility using ``requests``, parses it with
``BeautifulSoup``, finds the first link that ends in png using regex,
and copies that to the clipboard using ``pyperclip``.

Installation
------------

Python Module
~~~~~~~~~~~~~

``pip install copysc``

or

.. code:: bash

    $ git clone https://github.com/rv816/copysc.git
    $ cd copysc
    $ python setup.py install

Command Line Utility
~~~~~~~~~~~~~~~~~~~~

*Mac*
^^^^^

.. code:: bash

    $ export copyscpath=$(python -c 'import copysc; print(copysc.__path__[0])')
    $ sudo chmod 755 $copyscpath/copyscreen.py
    $ ln -s $copyscpath/copyscreen.py $copyscpath/copyscreen
    $ echo export PATH=$PATH:$copyscpath >> ~/.bash_profile

Note: If symlink already exists (at step 3: ln -s ....), then just move
on to next step. I've tried to configure the installer to install the
symlink, but that's still in alpha and may not work.

*Linux*
^^^^^^^

.. code:: bash

    $ export copyscpath=$(python -c 'import copysc; print(copysc.__path__[0])')
    $ sudo chmod 755 $copyscpath/copyscreen.py
    $ ln -s $copyscpath/copyscreen.py $copyscpath/copyscreen
    $ echo export PATH=$PATH:$copyscpath >> ~/.bashrc

Note: If symlink already exists (at step 3: ln -s ....), then just move
on to next step. I've tried to configure the installer to install the
symlink, but that's still in alpha and may not work.

You may also need to install a clipboard drivers to enable pyperclip to
interact with your X clipboard.

::

    $ sudo apt-get install xclip
    $ sudo apt-get install xsel

*Windows*
^^^^^^^^^

Install Linux or buy a Mac and see above.

*Forgive my rudeness. I'm sure it's possible, but I don't have the
faintest idea how Windows works* *My hunch is that the below
instructions might be helpful:*

1. Find out the absolute path of the module as follows:
   ``C:\>python -c 'import copysc; print(copysc.__path__[0])'``

2. Copy that path and add it to your PATH variable on windows.

--------------

Usage:
------

From the command line:
~~~~~~~~~~~~~~~~~~~~~~

``$ copyscreen``

*or*

``$ copyscreen http://screencloud.net/v/zOk6``

As python module:
~~~~~~~~~~~~~~~~~

.. code:: python

    from copysc.copyscreen import convert_clipboard
    convert_clipboard()

OR...you can feed it a link directly

.. code:: python

    from copysc.copyscreen import convert_clipboard
    convert_clipboard(link= 'https://www.dropbox.com/s/wg24eyirfaqrbnw/Screenshot%202014-10-17%2018.06.22.png?dl=0')

