GIF-Caption-Creator is a tool designed to create GIF captions nearly identical to the "iFunny" caption style.

Capabilities

	iFunny App	GIF-Caption-Creator
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
• ✔️ Emoji support³
• ✔️ Automatic text wrap
• ❌ User-friendly GUI (4.0)
• ❌ Convenient setup process (4.0)

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

Requirements

Programs:

• Python >= 3.10

Modules:

• Pillow >= 10.0 - Making images
• requests >= 2.13 - URL fetching
• emoji == 1.6.1 - Text to emoji support (support for modern versions of this package soon)
• 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

The direct executable path for FFmpeg must be added to the "Path" Environment variable on Windows (for the time being).

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/UhhhAaron/GIF-Caption-Creator
   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.12.0

If there are problems, create an issue here.

---

Supported GIF services

All GIF hosting sites are supported, as long as you have access to the raw URL for the GIF file you want to use.

Comparisons

• iFunny Android App	GIF-Caption-Creator