TinyPNG Compressor Pro

English | 简体中文 | 繁體中文

A powerful IntelliJ IDEA plugin that seamlessly integrates TinyPNG image compression into your development workflow. Compress PNG, JPEG, WebP, and AVIF images directly from your IDE with advanced features including batch processing, before/after comparison, format conversion, and intelligent API key management.

• Multiple Format Support: Compress PNG, JPEG, WebP, and AVIF images
• Batch Processing: Compress single files, multiple selections, or entire directories
• Smart Context Menu: Right-click on any image file or folder in the Project View
• Visual Comparison: Side-by-side and overlay comparison modes to review compression quality
• Real-time Statistics: Track compression ratio, file size savings, and processing progress

• Multi-API Key Management: Configure multiple TinyPNG API keys with automatic rotation
• Usage Monitoring: Real-time tracking of API usage and limits for each key
• Image Resizing: Built-in resize options (Scale, Fit, Cover, Thumb) during compression
• Format Conversion: Convert images between PNG, JPEG, WebP, and AVIF formats
• Metadata Preservation: Optionally preserve copyright, location, and creation date information
• Flexible Output: Choose to replace originals, save compressed versions, or create backups

• Interactive File Tree: Select which images to compress with checkbox-based tree view
• Progress Tracking: Real-time progress indicators for batch operations
• Comparison Panel: Professional before/after comparison with zoom and overlay modes
• Settings Integration: Comprehensive settings page in IDE preferences

1. Open Settings/Preferences → Plugins
2. Search for "TinyPNG Compressor Pro"
3. Click Install
4. Restart your IDE

1. Download the latest release from Releases
2. Open Settings/Preferences → Plugins
3. Click the ⚙️ icon → Install Plugin from Disk...
4. Select the downloaded .zip file
5. Restart your IDE

Before using the plugin, you'll need a TinyPNG API key:

1. Get a free API key at tinypng.com/developers
2. Open Settings → Tools → TinyPNG
3. Add your API key(s)
4. Configure your preferences (optional)

Settings page showing multi-API key configuration and usage monitoring

Right-click on any image file, multiple files, or a directory in the Project View:

Right-click context menu showing TinyPNG option

Select TinyPng from the context menu to open the compression dialog.

Main compression dialog with file tree, options panel, and preview

The compression dialog provides:

• File Tree: Select which images to compress
• Options Panel: Configure resize, format conversion, and metadata settings
• Preview: See selected image details and estimated savings

After compression, review the before/after comparison:

Before/after comparison with side-by-side and overlay modes

Features:

• Side-by-side view: Compare original and compressed versions
• Overlay mode: Drag slider to reveal differences
• Zoom controls: Inspect quality in detail
• Statistics: View file size, compression ratio, and dimensions

The plugin supports multiple API keys with automatic rotation:

Key 1: xxxxxxxxxxxxxxxxxxxxxxxxxxxx (480/500 compressions)
Key 2: yyyyyyyyyyyyyyyyyyyyyyyyyyyy (125/500 compressions)
Key 3: zzzzzzzzzzzzzzzzzzzzzzzzzzzz (50/500 compressions)

When one key reaches its limit, the plugin automatically switches to the next available key.

Each API key displays:

• Current compression count
• Monthly limit
• Visual progress indicator
• Status (Active/Limit Reached)

Choose from four resize methods:

• Scale: Proportionally resize by width and height
• Fit: Fit within specified dimensions while maintaining aspect ratio
• Cover: Fill specified dimensions, cropping if necessary
• Thumb: Create a thumbnail with smart cropping

Configure dimensions:

Width: 1920 px
Height: 1080 px
Method: Fit

Convert images during compression:

• PNG → JPEG (for photos without transparency)
• JPEG → PNG (to add transparency support)
• Any format → WebP (modern format with better compression)
• Any format → AVIF (next-gen format with superior compression)

Optionally preserve:

• Copyright: Copyright notices and credits
• Location: GPS coordinates and location data
• Creation Date: Original file creation timestamp

Choose how to handle compressed images:

1. Replace Original: Overwrites the original file with the compressed version
2. Save As: Creates a new compressed file (e.g., image_compressed.png)
3. Create Backup: Keeps original and saves compressed version

Access settings via Settings → Tools → TinyPNG:

• Add/remove multiple API keys
• View usage statistics for each key
• Enable/disable automatic key rotation

• Default Resize Method: Set the default resize method for all operations
• Auto-switch Keys: Automatically rotate keys when limit is reached
• Show Notifications: Display success/failure notifications after compression

• Preserve Original Files: Keep original files after compression
• Replace Original: Directly replace original files (default)
• Create Backup: Save original files with .backup extension

Contributions are welcome! Here's how you can help:

Found a bug? Please open an issue with:

• Description of the problem
• Steps to reproduce
• Expected vs actual behavior
• Screenshots (if applicable)
• IDE version and plugin version

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Make your changes
4. Add tests if applicable
5. Commit your changes: git commit -m 'Add amazing feature'
6. Push to the branch: git push origin feature/amazing-feature
7. Open a Pull Request

# Clone the repository
git clone https://github.com/yourusername/TinyPNG.git
cd TinyPNG

# Build the plugin
./gradlew build

# Run the plugin in a sandbox IDE
./gradlew runIde

# Run tests
./gradlew test

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Copyright 2025 Hugo

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

• TinyPNG Website: tinypng.com
• API Documentation: tinypng.com/developers
• Plugin Homepage: JetBrains Marketplace
• Issue Tracker: GitHub Issues

Need help? Here's how to get support:

• 📧 Email: gsd@androidcycle.com
• 🌐 Website: androidcycle.com
• 🐛 Bug Reports: GitHub Issues

• TinyPNG for their excellent image compression service
• Tinify Java SDK for the Java API client
• JetBrains for the IntelliJ Platform SDK

Made with ❤️ by Android Cycle