Skip to content

csettles/climgur

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

27 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

climgur

Climgur (command line imgur) is a fork of the imgurup repo, but instead uses argparse and imgurpython. Actually, almost 100% of the original code is gone as I got a little carried away (oops). Current features:

  • Upload anonymously or as a registered user
  • Upload single image
  • Upload local folder as album
  • Take screenshot and upload from command line
  • Set title, description, album type, privacy setting depending on upload type

Setup

In order to run climgur, you must create an auth.ini file in the main directory.

Provide your client_id and client_secret by adding an imgur client (requires an imgur account). Leave the access and refresh token fields blank.

[credentials]
client_id=
client_secret=
access_token=
refresh_token=

Requirements

To install any dependencies, do:

$ pip install -r requirements.txt

AutoPy is not required to run climgur, only to take screenshots. If you receive errors installing autopy, please look below for installation instructions

Linux

You need to install libpng and zlib before you try to run climgur.

$ sudo apt-get update
$ sudo apt-get install libpng-dev zlib1g-dev libxtst-dev
$ sudo apt-get install python-dev -y
$ sudo apt-get install <autopy or autopy3>

OS X

Install libpng and zlib from their websites and then enter pip install <autopy or autopy3>. Requires Mac OS 10.5 or later.

Windows

If you get errors through pip, go here and download the relevant .whl file. The .whl files are named like so: autopy-<pkg version>-cp<python version>-none-<architecture>.whl.
32 bit architecture is denoted by win32, while 64 bit is denoted by win_amd64. Install the downloaded file by changing into its directory and typing pip install <filename>.whl

Use

log.txt contains the submission time and deletion link of an upload (image/album). Delete the entry from log.txt after you are done.

Only use the -m argument when the path argument points to a folder. Single file uploads can use the -t and -d arguments to add relavent metadata. Please note that using the -m argument will overwrite -t and -d arguments.

By default, all uploads are anonymous. If you want to associate an upload with a user account, use the -u argument.

Taking a screenshot will save to the path argument. The image destination must end with '.png' or '.bmp' or the program will quit. Any screenshot taken will overwrite an existing image if given an identical path.

positional arguments:
 path                  path to file or folder to upload

optional arguments:
 -h, --help            show this help message and exit
 -t TITLE, --title TITLE
                       title of upload
 -d DESCRIPTION, --description DESCRIPTION
                       upload description
 -u, --user            upload to stored user account
 -m, --metadata        add data to images when uploading album
 -s, --screenshot      take screenshot and upload it
 --delay DELAY         delay (s) before taking screenshot

To-Do

  • Add support for >1 account
  • Figure out way to make saving screenshot locally optional

Licence

Licenced under the WTFPL.

About

Commandline Imgur

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%