Version 3.4.2 – March 2025
GIFSoup is an open‑source, cross‑platform image editing program that provides a visual, user‑friendly interface for working with animated GIF files. It is part of the GNU “Gifsoup” project, maintained by an international volunteer team. This manual covers the installation, configuration, and typical use of GIFSoup on Linux.
Table of Contents
- Introduction
- Installation
- Usage
- Plugins
- Use Cases
- Community and Support
- Related Software
- See Also
- References
1. Introduction
GIFSoup was created in 2006 by John Smith as a lightweight editor for animated GIFs. The project grew rapidly because of its simple interface, robust support for GIF89a features, and strong community engagement. Since version 3.0 the code base is written in C using GTK+ 3 for the graphical interface and libgdk-pixbuf for image decoding and encoding. The program is released under the GNU General Public Licence (GPL) v2 or later.
2. Installation
GIFSoup is available for all major Linux distributions. Install it with your package manager or compile from source.
2.1 Binary Packages
- Debian/Ubuntu:
sudo apt-get install gifsoup - Fedora:
sudo dnf install gifsoup - Arch Linux:
sudo pacman -S gifsoup - OpenSUSE:
sudo zypper install gifsoup
2.2 Building from Source
Requirements:
- GTK+ 3 (≥ 3.10)
- libgdk-pixbuf 2 (≥ 2.32)
- pkg-config, make, gcc or clang
- Optional: libgif for advanced processing
Steps:
$ tar xf gifsoup-3.4.2.tar.gz $ cd gifsoup-3.4.2 $ ./configure $ make $ sudo make install
2.3 Plugins
Plugins reside in /usr/lib/gifsoup/plugins by default. Add custom directories with Plugins → Manage Plugin Directories.
3. Usage
3.1 Starting the Application
Run gifsoup from a terminal or launch it from the application menu. The main window shows an empty canvas, a menu bar, a toolbar, and a thumbnail sidebar.
3.2 File Operations
- Open – Load a GIF file (Ctrl‑O). The sidebar shows all frames as thumbnails.
- Save – Overwrite the current animation (Ctrl‑S).
- Export Animation – Save as a new GIF or as a PNG sequence (Ctrl‑E). A dialog lets you set the output format, optimization, and frame‑level options.
- Import Directory – Load all PNG/JPG files from a folder as individual frames.
3.3 Editing Frames
Interact with thumbnails:
- Click – select frame.
- Right‑click – context menu: duplicate, delete, adjust delay, set disposal method.
- Double‑click – launch external editor (e.g. GIMP).
3.4 Frame Properties
Per‑frame delay can be set from 0 ms to 2000 ms. Disposal methods include:
- None – normal frame rendering.
- Background – previous frame is cleared to the background colour.
- Previous – previous frame is restored before rendering.
3.5 Export Settings
When exporting, you can choose:
- Global optimization – reduce palette across all frames.
- Per‑frame optimization – adjust delay and disposal per frame.
- Output format – GIF, PNG sequence.
- Lossless compression – enabled for PNG output.
4. Plugins
4.1 Developing a Plugin
Use gifsoup-plugin.h as the header. Implement functions:
gboolean plugin_init(void); void plugin_exit(void); void plugin_import(const gchar *path, GsAnimation *anim); void plugin_export(const gchar *path, GsAnimation *anim);
4.2 Popular Plugins
- Batch Resizer – Resize all frames in one operation.
- Auto‑Palette Optimizer – Reduces palette size automatically.
- WebP Exporter – Adds export to WebP.
- Color Correction – Basic color balance per frame.
4.3 Installing Plugins
Copy the compiled .so file to /usr/lib/gifsoup/plugins or to a user directory and refresh via Plugins → Refresh.
5. Use Cases
- Graphic design – create marketing GIFs with precise timing.
- Educational content – illustrate processes with looped steps.
- Archival – preserve or convert historical GIFs.
- Creative art – generate looping visual experiments.
6. Community & Support
Documentation
PDF manual: Download. Available in many languages.
Mailing Lists
- gifsoup-users – support and announcements.
- gifsoup-dev – development discussion.
Issue Tracker
Public issue tracker: bugs.gifsoup.org. Submit bug reports and feature requests.
7. Related Software
- GIMP – raster editor with GIF support.
- ImageMagick – command‑line GIF processing.
- ffmpeg – video to GIF conversion.
- APNG‑Edit – APNG editing.
- GIFcurry – simple GIF viewer.
8. See Also
- Animated Image File Formats – APNG spec
- GIF Image File Format – GIF89a spec
- GTK+ 3 Programming – GTK+ 3 docs
No comments yet. Be the first to comment!