Skip to content
This repository

Desktop application for uploading images to Imgur.com and keeping track of your uploads

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 data
Octocat-spinner-32 functions
Octocat-spinner-32 CHANGELOG
Octocat-spinner-32 INSTALL
Octocat-spinner-32 LICENSE
Octocat-spinner-32 README
Octocat-spinner-32 imgurup.py
README
*******************************************************************************
**************************** ImgurUploader v1.0 *******************************
*******************************************************************************



:: Contents ::

* Introduction
* Features
    - Limitation
    - API key
* Usage



====================
=   Introduction   =
====================

ImgurUploader is a desktop statusicon application for a simple task - to upload
images to Imgur using the Anonymous API of the imgur service, extending it with
a Logger for your uploaded images.

=====================
=      Features     =
=====================

The main features are as exptected:
- A status icon for easy access to the application
- Info Dialog - showing you the important links about the uploaded image
- Taking a screenshot of the whole screen
- Drag'n'drop images to the main window
- Database - stores the informatin about the uploaded image for later use

    = Limitations =
        
    The only limitation about the application is the 50 uploads per hour. That's
    because Imgur.com limits the request for the Anonymous API to 500 credits, 
    and ImgurUp doesn't support OAuth or the more extended service of Imgur. The
    last is also not planned for the feature, since Imgur attempts to be as 
    simple as possible.
    
    = API key =
    
    To use this application you will need an API Key. You can obtain one at the
    following webaddress:
        http://imgur.com/register/api_anon
    You will have to provide the following information:
        1. First Name
        2. Last Name
        3. Email
        4. Simple Application description
        
    Next to make ImgurUp use your own API Key start the application and click 
    with the right mouse button on the Status icon of ImgurUp, select the option
    API Key and in the opened Dialog paste your API Key. The Key will be stored
    in the imgurup database. After that you must restart the application so the
    changes can take effect. 
    
    That's it. 
    
=====================
=       Usage       =
=====================

The application is simple to use, but since I have to write the README, here some
tips:

- Uploading:
    To upload an image file use the filechooser button to point to the file
    The title will be autogenerated, if you don't like it, you can change it
    Pressing the Upload button does all the magic
    
- The Log viewer
    The Log dialog display some information about the already uploaded images:
        Imgur page to the image; Title of the image; Delete URL
    Double clicking on a row opens the tags page of your image, so you can access
        other formats for sharing your image
    Clicking on the Delete button deleats the selected image from Imgur and your
        database
Something went wrong with that request. Please try again.