Metadata-Version: 2.1
Name: ptpimg-uploader
Version: 0.7
Summary: PTPImg uploader, handles local files and URLs, from the commandline
Home-page: https://github.com/theirix/ptpimg-uploader
Author: theirix
Author-email: theirix@gmail.com
License: BSD
Keywords: image uploader
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Topic :: Utilities
Requires-Python: >=3.3
License-File: LICENSE

===============
ptpimg_uploader
===============

|PyPI version| |Build Status| 

Upload image file or image URL to the ptpimg.me image hosting.


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

Using pip:

.. code-block:: bash

    pip install ptpimg_uploader


Using setup.py:

.. code-block:: bash

    python setup.py install


Manually:

  * Install python3 package ``requests`` (usually ``apt-get install python3-requests`` or ``pip3 install requests``).

  * If you want clipboard support, install ``pyperclip`` too.


API key
-------

To find your PTPImg API key, login to https://ptpimg.me, open the page source
(i.e. "View->Developer->View source" menu in Chrome), find the string api_key
and copy the hexademical string from the value attribute. Your API key should
look like 43fe0fee-f935-4084-8a38-3e632b0be68c.

You can export your ptpimg.me API key (usually in .bashrc or .zshenv) using:

.. code-block:: bash

    export PTPIMG_API_KEY=<your hex key>


or use the ``-k`` / ``--api-key`` command-line switch.

How to use
----------

Run

.. code-block:: bash

    ptpimg_uploader -h


to get command-line help.

To upload an image file:

.. code-block:: bash

    ptpimg_uploader ~/seed/mytorrent/folder.jpg


To rehost an imgur image:

.. code-block:: bash

    ptpimg_uploader https://i.imgur.com/eaT6j3X.jpg


An uploaded URL will be printed to the console.

If ``--bbcode`` parameter is specified, URLS will be wrapped in BBCode ``[img]`` tags:

.. code-block:: bash

    ptpimg_uploader --bbcode ~/seed/mytorrent/folder.jpg


If pyperclip python package is installed, the URL will be additionally copied to the clipboard.
Additionally, you can upload an URL from the clipboard:

.. code-block:: bash

    ptpimg_uploader --clip

If output is a terminal, a bell will be ringed on completion (can be disabled with a ``--nobell`` parameter).

You can specify multiple files and URLs on the command line:

.. code-block:: bash

    ptpimg_uploader ~/seed/mytorrent/folder.jpg https://i.imgur.com/eaT6j3X.jpg


The resulting URLs are printed each on separate line, and copied to your
clipboard with newlines in between.

License
-------

BSD

Acknowledgments
---------------

* mjpieters - a great refactoring and Python packaging
* lukacoufyl - fixing image upload order

.. |Build Status| image:: https://github.com/theirix/ptpimg-uploader/workflows/Upload%20Python%20Package/badge.svg
   :target: https://github.com/theirix/ptpimg-uploader/actions
.. |PyPI version| image:: https://img.shields.io/pypi/v/ptpimg-uploader.svg
   :target: https://pypi.python.org/pypi/ptpimg-uploader


