{
    "info": {
        "author": "Teriks",
        "author_email": "Teriks@users.noreply.github.com",
        "bugtrack_url": null,
        "classifiers": [
            "Development Status :: 5 - Production/Stable",
            "Intended Audience :: End Users/Desktop",
            "License :: OSI Approved :: BSD License",
            "Natural Language :: English",
            "Operating System :: OS Independent",
            "Programming Language :: Python :: 3.4",
            "Programming Language :: Python :: 3.5",
            "Topic :: Artistic Software",
            "Topic :: Utilities"
        ],
        "description": "Details\n-------\n\nCompiles a native binary that plays a GIF in ASCII on the terminal using\nncurses.\n\n.. figure:: https://github.com/Teriks/giftoa/raw/master/readme_demo.gif\n   :alt: Demo\n\n   Demo\n\n``giftoa -i cat.gif -o cat_gif --invert && ./cat_gif``\n\nRequirements\n------------\n\n-  gcc or compatible compiler, you can specify the compiler with ``-cc``\n   or ``--compiler``\n-  Python 3.x\n-  ImageMagick\n-  jp2a\n-  libncurses-dev development package for your distro\n\nOn debian based distributions:\n\n``sudo apt-get install gcc python3 imagemagick jp2a libncurses-dev``\n\nThis may be or may not be required to install pip3:\n\n``sudo apt-get install python3-pip``\n\nPip Install\n-----------\n\nAfter you have installed the above dependencies, you can install the\n**giftoa** and **rightgif** scripts into your environment using the pip\npackage manager like this:\n\n``sudo pip3 install giftoa``\n\nOr to upgrade:\n\n``sudo pip3 install giftoa --upgrade``\n\n\nDebian Packaging\n----------------\n\nYou can also build two **.deb** files for the **rightgif** and\n**giftoa** commands seperately by running the 'package.py' script in the\n**debian\\_packaging** directory.\n\nThe giftoa **.deb** file will install the dependencies listed above.\n\nOnce the **.deb** packages are built you can install each selectively\nwith:\n\n``sudo dpkg -i deb_package_here.deb``\n\n``sudo apt-get install -f``\n\nBasic Usage\n-----------\n\n``giftoa -i gif_file.gif -o output_exe [jp2a options...]``\n\n**or**\n\n``giftoa -i gif_file.gif [jp2a options...]`` (Executable is named after\nGIF file)\n\n**or**\n\n``giftoa -i http://gifwebsite.com/somegif.gif -o output_exe [jp2a options...]``\n\n-o/--output must be specified when using a URL.\n\n**or**\n\nYou can specify a directory containing JPEG files, the images in the\ndirectory will be used as frames for the animation.\n\nThey will be sorted in natural order by name, so you should include some\nkind of frame number at the beginning or end of each file name.\n\nOnly JPEG files will be considered, other types of files will be\nignored.\n\nIf you do this, you must specify the name of the output executable\nexplicitly.\n\n``giftoa -i directory -o output_file_name_required.exe [jp2a options...]``\n\n**or**\n\nUse ``--stdin-frames`` to read a newline separated list of jpeg frames\nfrom standard input.\n\nexample:\n\n``find image_dir -mindepth 1 | sort --version-sort | giftoa --stdin-frames -o output_exe [jp2a options...]``\n\nNote that ``--version-sort`` is specific to GNU sort.\n\nThe above command emulates how passing a directory to ``-i`` behaves for\nthe most part.\n\ngiftoa will not accept non JPEG file paths from STDIN, it will produce\nan error when a non JPEG is detected.\n\nUsing with rightgif companion script\n------------------------------------\n\nrightgif.py is a simple client for `rightgif <https://rightgif.com>`__\n\nIt returns a URL to a GIF that is related to whatever sentence/statement\nyou pass as an argument.\n\nFor example:\n\n``rightgif really fat cats``\n\nYou dont need to quote your query but you can:\n\n``rightgif \"horrifically obese cats\"``\n\nPairing it with giftoa:\n\n``giftoa -i $(rightgif kitties) -o kitties_exe``\n\n**or**\n\n``giftoa -i $(rightgif kitties) -o kitties_exe && ./kitties_exe``\n\nNote: You must specify an output file when passing a URL to giftoa.\n\nFrame Delay / FPS\n-----------------\n\n``-fps`` or ``--frames-per-second`` can be used to set a target FPS for\nthe animation.\n\nIf not specified, it defaults to 10 frames per second.\n\nThis option cannot be used together with ``-fss`` or ``-fsn``.\n\nThe minimum value is 1 and the maximum value is 1000000000, the value\nmust be a whole number.\n\nexample:\n\n``giftoa -i gif_file.gif -fps 25 -o output_exe [jp2a options...]``\n\n----------\n\n``-fsn`` or ``--framesleep-nanoseconds`` can be used to adjust the delay\nin nanoseconds between GIF frames.\n\nThis option cannot be used with ``-fps`` / ``--frames-per-second``.\n\nThe minimum value is 0 and the maximum value is 999999999, the value\nmust be a whole number.\n\nexample:\n\n``giftoa -i gif_file.gif -fsn 100000000 -o output_exe [jp2a options...]``\n\n----------\n\n``-fss`` or ``--framesleep-seconds`` can be used to adjust the delay in\nseconds between GIF frames. This is in addition to whatever amount of\nnanoseconds you specify.\n\nThis option cannot be used with ``-fps`` / ``--frames-per-second``.\n\n``-fsn`` will default to 0 when ``-fss`` is used and additional\nnanoseconds are not explicitly specified.\n\nexample (1 second and 100 nanoseconds):\n\n``giftoa -i gif_file.gif -fss 1 -fsn 100 -o output_exe [jp2a options...]``\n\nThe minimum value is 0 and the maximum value is 2147483647, the value\nmust also be a whole number.\n\nC Compiler Selection\n--------------------\n\n``-cc`` or ``--compiler`` can be used to specify the compiler used to\ncompile the binary\n\nexamples:\n\n``giftoa -i gif_file.gif -cc clang -o output_exe [jp2a options...]``\n\njp2a Options\n------------\n\nSee ``jp2a -h`` for more options once it is installed.\n\njp2a homepage: https://csl.name/jp2a/",
        "description_content_type": "",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/Teriks/giftoa",
        "keywords": "",
        "license": "BSD 3-Clause",
        "maintainer": "",
        "maintainer_email": "",
        "name": "giftoa",
        "package_url": "https://pypi.org/project/giftoa/",
        "platform": "",
        "project_url": "https://pypi.org/project/giftoa/",
        "project_urls": {
            "Homepage": "https://github.com/Teriks/giftoa"
        },
        "release_url": "https://pypi.org/project/giftoa/1.0.6.2/",
        "requires_dist": null,
        "requires_python": "",
        "summary": "Python script which compiles a native binary that plays a GIF in ASCII on the terminal using ncurses.",
        "version": "1.0.6.2"
    },
    "last_serial": 5719687,
    "releases": {
        "1.0.6.2": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "b00ff17e43411545d7c47e1da1b4d6a1",
                    "sha256": "5b32f0a858c881e950ef2cd47bfd675792de8c0eedfac08ea8fe1a583b554517"
                },
                "downloads": -1,
                "filename": "giftoa-1.0.6.2.tar.gz",
                "has_sig": false,
                "md5_digest": "b00ff17e43411545d7c47e1da1b4d6a1",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 12028,
                "upload_time": "2019-08-23T09:09:32",
                "url": "https://files.pythonhosted.org/packages/5b/28/d14e7cee2cf571891cd9a33eae371fa353a9a31dd4cc77f69f4bde696767/giftoa-1.0.6.2.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "b00ff17e43411545d7c47e1da1b4d6a1",
                "sha256": "5b32f0a858c881e950ef2cd47bfd675792de8c0eedfac08ea8fe1a583b554517"
            },
            "downloads": -1,
            "filename": "giftoa-1.0.6.2.tar.gz",
            "has_sig": false,
            "md5_digest": "b00ff17e43411545d7c47e1da1b4d6a1",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 12028,
            "upload_time": "2019-08-23T09:09:32",
            "url": "https://files.pythonhosted.org/packages/5b/28/d14e7cee2cf571891cd9a33eae371fa353a9a31dd4cc77f69f4bde696767/giftoa-1.0.6.2.tar.gz"
        }
    ]
}