Egg Images

A Pelican Panel plugin that automatically fetches and manages game artwork for your eggs using Steam and IGDB.

Features

• Steam artwork — fetch game images directly from Steam CDN by App ID or automatic name search
• IGDB fallback — fetch artwork from IGDB (via Twitch API) for non-Steam games
• Image protection — manually set images are never overridden by auto-fetch
• Bulk fetch — fetch artwork for all eggs at once from Steam or IGDB
• Per-egg control — fetch, protect, unprotect, or clear images per egg
• Admin overview — dedicated admin page showing all eggs with image status, Steam App ID, and protection state
• Secure credentials — API keys stored via plugin settings, never hardcoded

Screenshots

The plugin adds an Egg Images page under Service Management in the admin panel:

Requirements

• Pelican Panel v1.0.0-beta35 or higher
• PHP 8.3+
• Twitch Developer account for IGDB support (free, optional)

Installation

Manual

# Copy plugin to your Pelican plugins directory
cp -r egg-images /var/www/pelican/plugins/

# Install the plugin
cd /var/www/pelican
php artisan p:plugin:install egg-images

# Fix permissions (done automatically by plugin provider on boot)
chown -R www-data:www-data /var/www/pelican/plugins/egg-images

# Create storage link if not already done
php artisan storage:link

From zip

cd /var/www/pelican/plugins
unzip egg-images-plugin.zip
cd /var/www/pelican
php artisan p:plugin:install egg-images
php artisan storage:link

Configuration

IGDB (optional)

To enable IGDB fallback for non-Steam games:

1. Go to https://dev.twitch.tv/console
2. Create a new application (type: Application Integration)
3. Generate a Client Secret
4. In Pelican: Admin → Plugins → Egg Images → Settings
5. Enter your Twitch Client ID and Twitch Client Secret
6. Save settings

Steam

No credentials required — Steam CDN is public. Steam auto-fetch works out of the box.

Usage

Single egg

Navigate to Admin → Egg Images, find your egg and use the row actions:

Bulk fetch

Use the toolbar buttons at the top of the Egg Images page:

• Auto-fetch all from Steam — searches Steam by egg name for all unprotected eggs without an image
• Auto-fetch missing from IGDB — searches IGDB for all unprotected eggs still missing an image after Steam fetch

Note: Bulk operations process all eggs sequentially and may take a few minutes. The page will appear frozen during this time — this is normal.

How images are stored

Images are stored using Pelican's built-in HasIcon trait:

storage/app/public/icons/egg/{egg-uuid}.jpg

Accessible via the public storage URL after running php artisan storage:link.

How metadata is stored

No database migrations required. Metadata is stored in the egg's existing tags array:

Uninstall

cd /var/www/pelican
php artisan p:plugin:uninstall egg-images

Note: This removes the plugin but does not delete egg images already downloaded. To remove images manually:

rm -rf /var/www/pelican/storage/app/public/icons/egg/

License

MIT — feel free to use, modify and distribute.

Contributing

Pull requests welcome. Built for Pelican Panel beta — expect API changes as Pelican matures.