ReadMe.md

iFunny-Captions is a pack of scripts providing widely customizable GIF caption generation.

Capabilities

	iFunny App	iFunny-Captions
PNG Captions	✔️	✔️
GIF Captions	✔️	✔️
MP4 Captions	✔️	✔️
Image optimization	❌	✔️
Custom Fonts	❌	✔️
Emoji support	✔️	✔️
Crop support	✔️	❌
Graphical User Interface	✔️	❌
Batch Processing	❌	✔️

---

Completed & Planned Features

• ✔️ PNG Captions
• ✔️ GIF Captions
• ✔️ Local file support
• ✔️ GIF size reduction
• ✔️ Custom fonts support
• ✔️ Transparent GIF support
• ❌ Program Showcase (Broken Colab)
• ❌ Colab Notebook
• ✔️ Emoji support³
• ✔️ Automatic text wrap

¹ - Please look at Custom Fonts section in wiki.
² - Problems with wrap height might occur.

Requirements

Programs:

• Python >= 3.7

Modules:

• Pillow >= 5.1.0 - Making images
• requests >= 2.13 - URL fetching
• emoji >= 0.4.5 - Text to emoji support
• clipboard >= 0.0.4 - Clipboard values handling
• sty >= 0.0.4 - Colored prints
• colour >= 0.1.5 - Colored text values handling
• unidecode - Text normalization
• distro >= 1.7¹ - Directory opening helper
• pyshortcuts >= 1.8 - Shortcuts making

Packages (bold links are Windows static executable binaries):

• FFmpeg >= 4.2.0 - Since PIL.ImageSequence.Iterator messes up the frames colors.
• Gifsicle >= 1.92-2 - Check after 64-bit if possible! (Scale_Back option)
• PNGQuant >= 2.14 (optional)
• OxiPNG >= 5.0.1 (optional)
• Python3-PIP¹
• Python3-TK¹

¹ - Required on Linux

---

Linux Installation & Usage

sudo apt-get install git python3-apt python3-pip python3-tk ffmpeg pngquant gifsicle

For non-Debian distros, use the equivalent package manager to install these dependencies.

1. Clone the repository and move to its directory.

   git clone http://github.com/Amirhan-Taipovjan-Greatest-I/iFunny-Captions
   cd iFunny-Captions

2. Install required modules by inputting pip install -r requirements.txt
3. Allocate the required files to PATH system environment variable.
4. Modify the parameters in the Config.json file. Its documentation can be found here.
5. Open shell script file named Run. Supports positional arguments - type python iFunny_Captions.pyw -h for more.
6. Output should be in the Images folder.

Support

This project was tested on:

OS	Python Version
Windows 10	3.7.6

If there are problems, create an issue here.

---

Supported GIF services

Be sure to copy the raw image URL.

Tenor	Giphy	Gfycat	Tumblr (GIFV)	ImgFlip	GifImage	BestAnimations	GifFinder	ReactionGIFs

---

Comparisons

• iFunny Android App	GIF-Caption-Creator