Install the latest release from PyPi:

python -m pip install gfypy

Or install the latest development version from source:

python -m pip install -U git+https://github.com/noahkw/gfypy

Request API credentials at https://developers.gfycat.com/signup/#/apiform. Make sure to add http://localhost:8000/callback as a redirect URI or the OAuth authentication will fail.

from gfypy import Gfypy

gfypy = Gfypy(CLIENT_ID, CLIENT_SECRET, './creds.json')
gfypy.authenticate()

# getting info on a single gfycat
gfycat_info = gfypy.get_gfycat('apprehensivefixedgermanpinscher')

# creating a new gfycat via file upload
gfypy.upload_from_file(f'test_video.webm', title='This is a test video. Don\'t upvote.',
                                           tags=['testing stuff', 'gfycat is awesome'])

gfy-uploader conf.ini \
                   file-1.webm file-2.webm \
                   --tags section1 newvideo \
                   --extra-tags "funny video" lol

--dry-run -d: Do not upload any files. Good for debugging.

--sort -s: Sort titles by the suffix after "-".

A sample conf.ini can be found here: https://github.com/noahkw/gfypy/blob/master/bin/conf.ini.sample.

Each section's tags defined under tags may be added using --tags <section>. Additional tags are added via --extra-tags. The title is generated from the filename by taking the base name and removing the extension.