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

*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

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')

