Add PDF image optimization#229

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
trevor-e wants to merge 2 commits into
base:main
Choose a base branch
from
Open

Add PDF image optimization #229

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
c66a7e4
Add PDF image optimization
trevor-e Jul 29, 2025
13e815c
update
trevor-e Jul 29, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions requirements.txt
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -28,3 +28,4 @@ asn1crypto>=1.5.0
cryptography>=41.0.0
datadog==0.51.*
lzfse>=0.4.2
pypdf>=5.0.0
139 changes: 112 additions & 27 deletions scripts/test_image_optimization.py
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -11,6 +11,7 @@
from typing import List, NamedTuple

import pillow_heif # type: ignore
from pypdf import PdfReader, PdfWriter
from PIL import Image

# Register HEIF support
Expand DownExpand Up@@ -85,6 +86,36 @@ def test_heic_conversion(img: Image.Image, file_size: int) -> OptimizationResult
return None


def test_pdf_optimization(pdf_path: Path, file_size: int) -> OptimizationResult | None:
"""Test PDF optimization."""
try:
reader = PdfReader(pdf_path)
writer = PdfWriter()

for page in reader.pages:
page.compress_content_streams(level=9)
writer.add_page(page)

writer.compress_identical_objects(remove_identicals=True, remove_orphans=True)

with io.BytesIO() as buf:
writer.write(buf)
new_size = buf.tell()

if new_size < file_size:
savings = file_size - new_size
return OptimizationResult(
original_size=file_size,
optimized_size=new_size,
savings=savings,
savings_percent=(savings / file_size) * 100,
method="optimized_PDF"
)
except Exception as e:
print(f" ❌ PDF optimization failed: {e}")
return None


def save_optimized_image(img: Image.Image, output_path: Path, method: str) -> None:
"""Save the optimized image to disk."""
try:
Expand All@@ -99,17 +130,71 @@ def save_optimized_image(img: Image.Image, output_path: Path, method: str) -> No
print(f" ❌ Failed to save optimized image: {e}")


def process_image(image_path: Path, output_dir: Path) -> None:
"""Process a single image and save optimized versions."""
print(f"\n📸 Processing: {image_path.name}")
def save_optimized_pdf(pdf_path: Path, output_path: Path) -> None:
"""Save the optimized PDF to disk."""
try:
reader = PdfReader(pdf_path)
writer = PdfWriter()

for page in reader.pages:
page.compress_content_streams(level=9)
writer.add_page(page)

writer.compress_identical_objects(remove_identicals=True, remove_orphans=True)

with open(output_path, 'wb') as f:
writer.write(f)
except Exception as e:
print(f" ❌ Failed to save optimized PDF: {e}")


def process_file(file_path: Path, output_dir: Path) -> None:
"""Process a single file (image or PDF) and save optimized versions."""
print(f"\n📄 Processing: {file_path.name}")

try:
file_size = image_path.stat().st_size
file_size = file_path.stat().st_size
print(f" 📊 Original size: {format_size(file_size)}")

with Image.open(image_path) as img:
file_ext = file_path.suffix.lower()

# Handle PDF files
if file_ext == '.pdf':
print(f" 🏷️ Format: PDF")
results: List[OptimizationResult] = []

if result := test_pdf_optimization(file_path, file_size):
results.append(result)

if not results:
print(" ℹ️ No optimization opportunities found")
return

# Show results
print(" 💡 Optimization opportunities:")
for i, result in enumerate(results, 1):
print(f" {i}. {result.method}: "
f"{format_size(result.savings)} saved "
f"({result.savings_percent:.1f}%) "
f"→ {format_size(result.optimized_size)}")

# Save optimized PDF
best_result = results[0]
if best_result.savings >= 4096: # 4KB threshold
output_path = output_dir / f"{file_path.stem}_optimized.pdf"
save_optimized_pdf(file_path, output_path)
print(f" ✅ Saved optimized version: {output_path.name}")
print(f" 🎯 Savings: {format_size(best_result.savings)} "
f"({best_result.savings_percent:.1f}%)")
else:
print(f" ⚠️ Savings ({format_size(best_result.savings)}) "
f"below 4KB threshold")
return

# Handle image files
with Image.open(file_path) as img:
img.load() # type: ignore
fmt = (img.format or image_path.suffix[1:]).lower()
fmt = (img.format or file_path.suffix[1:]).lower()
print(f" 🏷️ Format: {fmt.upper()}, Mode: {img.mode}, Size: {img.size}")

results: List[OptimizationResult] = []
Expand DownExpand Up@@ -145,13 +230,13 @@ def process_image(image_path: Path, output_dir: Path) -> None:
# Save the best optimization
best_result = max(results, key=lambda r: r.savings)
if best_result.savings >= 4096: # 4KB threshold
stem = image_path.stem
stem = file_path.stem
if best_result.method == "HEIC":
output_path = output_dir / f"{stem}_optimized.heic"
elif best_result.method.startswith("minified_"):
output_path = output_dir / f"{stem}_optimized{image_path.suffix}"
output_path = output_dir / f"{stem}_optimized{file_path.suffix}"
else:
output_path = output_dir / f"{stem}_optimized{image_path.suffix}"
output_path = output_dir / f"{stem}_optimized{file_path.suffix}"

save_optimized_image(img, output_path, best_result.method)
print(f" ✅ Saved optimized version: {output_path.name}")
Expand All@@ -162,18 +247,18 @@ def process_image(image_path: Path, output_dir: Path) -> None:
f"below 4KB threshold")

except Exception as e:
print(f" ❌ Failed to process image: {e}")
print(f" ❌ Failed to process file: {e}")


def main():
"""Main function."""
if len(sys.argv) != 2:
print("Usage: python test_image_optimization.py <directory_or_image_path>")
print("Usage: python test_image_optimization.py <directory_or_file_path>")
print("\nThis script will:")
print("- Analyze images for optimization opportunities")
print("- Analyze images and PDFs for optimization opportunities")
print("- Save optimized versions with '_optimized' suffix")
print("- Show before/after file sizes and savings")
print("- Allow you to visually compare original vs optimized")
print("- Allow you to compare original vs optimized files")
sys.exit(1)

input_path = Path(sys.argv[1])
Expand All@@ -183,35 +268,35 @@ def main():
sys.exit(1)

# Collect image files
image_extensions = {'.png', '.jpg', '.jpeg', '.heif', '.heic'}
image_extensions = {'.png', '.jpg', '.jpeg', '.heif', '.heic', '.pdf'}

if input_path.is_file():
if input_path.suffix.lower() not in image_extensions:
print(f"❌ Not a supported image file: {input_path}")
print(f"❌ Not a supported file: {input_path}")
sys.exit(1)
image_files = [input_path]
files = [input_path]
output_dir = input_path.parent
else:
image_files: List[Path] = []
files: List[Path] = []
for ext in image_extensions:
image_files.extend(input_path.glob(f"*{ext}"))
image_files.extend(input_path.glob(f"*{ext.upper()}"))
files.extend(input_path.glob(f"*{ext}"))
files.extend(input_path.glob(f"*{ext.upper()}"))

if not image_files:
print(f"❌ No supported image files found in: {input_path}")
if not files:
print(f"❌ No supported files found in: {input_path}")
sys.exit(1)
output_dir = input_path

print(f"🔍 Found {len(image_files)} image(s) to process")
print(f"🔍 Found {len(files)} file(s) to process")
print(f"📁 Output directory: {output_dir}")

# Process each image
for image_file in sorted(image_files):
process_image(image_file, output_dir)
# Process each file
for file in sorted(files):
process_file(file, output_dir)

print(f"\n✨ Processing complete!")
print(f"📂 Check {output_dir} for optimized images with '_optimized' suffix")
print("👀 Open original and optimized images side-by-side to compare quality")
print(f"📂 Check {output_dir} for optimized files with '_optimized' suffix")
print("👀 Open original and optimized files side-by-side to compare quality")


if __name__ == "__main__":
Expand Down
35 changes: 32 additions & 3 deletions src/launchpad/size/insights/apple/image_optimization.py
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -11,6 +11,7 @@
import pillow_heif # type: ignore

from PIL import Image
from pypdf import PdfReader, PdfWriter

from launchpad.size.insights.insight import Insight, InsightsInput
from launchpad.size.models.common import FileInfo
Expand DownExpand Up@@ -38,7 +39,7 @@ class _OptimizationResult:
class ImageOptimizationInsight(Insight[ImageOptimizationInsightResult]):
"""Analyse image optimisation opportunities in iOS apps."""

OPTIMIZABLE_FORMATS = {"png", "jpg", "jpeg", "heif", "heic"}
OPTIMIZABLE_FORMATS = {"png", "jpg", "jpeg", "heif", "heic", "pdf"}
MIN_SAVINGS_THRESHOLD = 4096
TARGET_JPEG_QUALITY = 85
TARGET_HEIC_QUALITY = 85
Expand DownExpand Up@@ -104,8 +105,16 @@ def _analyze_image_optimization(
if res := self._check_heic_minification(img, file_size):
minify_savings, minified_size = res.savings, res.optimized_size
except Exception as exc:
logger.error("Failed to process %s: %s", display_path, exc)
return None
if file_type.lower() == "pdf":
try:
if res := self._check_pdf_optimization(full_path, file_size):
minify_savings, minified_size = res.savings, res.optimized_size
except Exception as pdf_exc:
logger.error("Failed to process PDF %s: %s", display_path, pdf_exc)
return None
else:
logger.error("Failed to process %s: %s", display_path, exc)
return None

if max(minify_savings, conversion_savings) < self.MIN_SAVINGS_THRESHOLD:
return None
Expand DownExpand Up@@ -154,6 +163,26 @@ def _check_heic_minification(self, img: Image.Image, file_size: int) -> _Optimiz
logger.error("HEIC minification check failed: %s", exc)
return None

def _check_pdf_optimization(self, file_path: Path, file_size: int) -> _OptimizationResult | None:
try:
reader = PdfReader(file_path)
writer = PdfWriter()

for page in reader.pages:
page.compress_content_streams(level=9)
writer.add_page(page)

writer.compress_identical_objects(remove_identicals=True, remove_orphans=True)

with io.BytesIO() as buf:
writer.write(buf)
new_size = buf.tell()

return _OptimizationResult(file_size - new_size, new_size) if new_size < file_size else None
except Exception as exc:
logger.error("PDF optimization check failed: %s", exc)
return None

def _iter_optimizable_files(self, files: Sequence[FileInfo]) -> Iterable[FileInfo]:
for fi in files:
if fi.file_type == "car":
Expand Down
Loading
, 'i'); if (__m === '*' || __re.test(location.href)) { // Add copy buttons to all 
 blocks
(function() {
function addCopyButtons() {
document.querySelectorAll('pre code').forEach(function(codeBlock) {
if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;
codeBlock.parentElement.setAttribute('data-copy-added', 'true');
var btn = document.createElement('button');
btn.textContent = 'Copy';
btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';
btn.onmouseover = function() { this.style.opacity = '1'; };
btn.onmouseout = function() { this.style.opacity = '0.7'; };
btn.onclick = function() {
navigator.clipboard.writeText(codeBlock.textContent).then(function() {
btn.textContent = 'Copied!';
setTimeout(function() { btn.textContent = 'Copy'; }, 1500);
});
};
codeBlock.parentElement.style.position = 'relative';
codeBlock.parentElement.appendChild(btn);
});
}
addCopyButtons();
// Re-run on dynamic content
var observer = new MutationObserver(addCopyButtons);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '

Skip to content
Add PDF image optimization#229

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Open

trevor-e
wants to merge
2
commits into

base:main
Choose a base branch

from

 Open


Add PDF image optimization
#229
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


2 commits


Select commit
Hold shift + click to select a range
c66a7e4

Add PDF image optimization


trevor-e Jul 29, 2025
13e815c

update


trevor-e Jul 29, 2025

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


1 change: 1 addition & 0 deletions
requirements.txt

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -28,3 +28,4 @@ asn1crypto>=1.5.0
cryptography>=41.0.0
datadog==0.51.*
lzfse>=0.4.2
pypdf>=5.0.0

139 changes: 112 additions & 27 deletions
scripts/test_image_optimization.py

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -11,6 +11,7 @@
from typing import List, NamedTuple

import pillow_heif # type: ignore
from pypdf import PdfReader, PdfWriter
from PIL import Image

# Register HEIF support
Expand DownExpand Up@@ -85,6 +86,36 @@ def test_heic_conversion(img: Image.Image, file_size: int) -> OptimizationResult
 return None


def test_pdf_optimization(pdf_path: Path, file_size: int) -> OptimizationResult | None:
 """Test PDF optimization."""
 try:
 reader = PdfReader(pdf_path)
 writer = PdfWriter()

 for page in reader.pages:
 page.compress_content_streams(level=9)
 writer.add_page(page)

 writer.compress_identical_objects(remove_identicals=True, remove_orphans=True)

 with io.BytesIO() as buf:
 writer.write(buf)
 new_size = buf.tell()

 if new_size < file_size:
 savings = file_size - new_size
 return OptimizationResult(
 original_size=file_size,
 optimized_size=new_size,
 savings=savings,
 savings_percent=(savings / file_size) * 100,
 method="optimized_PDF"
 )
 except Exception as e:
 print(f" ❌ PDF optimization failed: {e}")
 return None


def save_optimized_image(img: Image.Image, output_path: Path, method: str) -> None:
 """Save the optimized image to disk."""
 try:
Expand All@@ -99,17 +130,71 @@ def save_optimized_image(img: Image.Image, output_path: Path, method: str) -> No
 print(f" ❌ Failed to save optimized image: {e}")


def process_image(image_path: Path, output_dir: Path) -> None:
 """Process a single image and save optimized versions."""
 print(f"\n📸 Processing: {image_path.name}")
def save_optimized_pdf(pdf_path: Path, output_path: Path) -> None:
 """Save the optimized PDF to disk."""
 try:
 reader = PdfReader(pdf_path)
 writer = PdfWriter()

 for page in reader.pages:
 page.compress_content_streams(level=9)
 writer.add_page(page)

 writer.compress_identical_objects(remove_identicals=True, remove_orphans=True)

 with open(output_path, 'wb') as f:
 writer.write(f)
 except Exception as e:
 print(f" ❌ Failed to save optimized PDF: {e}")


def process_file(file_path: Path, output_dir: Path) -> None:
 """Process a single file (image or PDF) and save optimized versions."""
 print(f"\n📄 Processing: {file_path.name}")

 try:
 file_size = image_path.stat().st_size
 file_size = file_path.stat().st_size
 print(f" 📊 Original size: {format_size(file_size)}")

 with Image.open(image_path) as img:
 file_ext = file_path.suffix.lower()

 # Handle PDF files
 if file_ext == '.pdf':
 print(f" 🏷️ Format: PDF")
 results: List[OptimizationResult] = []

 if result := test_pdf_optimization(file_path, file_size):
 results.append(result)

 if not results:
 print(" ℹ️ No optimization opportunities found")
 return

 # Show results
 print(" 💡 Optimization opportunities:")
 for i, result in enumerate(results, 1):
 print(f" {i}. {result.method}: "
 f"{format_size(result.savings)} saved "
 f"({result.savings_percent:.1f}%) "
 f"→ {format_size(result.optimized_size)}")

 # Save optimized PDF
 best_result = results[0]
 if best_result.savings >= 4096: # 4KB threshold
 output_path = output_dir / f"{file_path.stem}_optimized.pdf"
 save_optimized_pdf(file_path, output_path)
 print(f" ✅ Saved optimized version: {output_path.name}")
 print(f" 🎯 Savings: {format_size(best_result.savings)} "
 f"({best_result.savings_percent:.1f}%)")
 else:
 print(f" ⚠️ Savings ({format_size(best_result.savings)}) "
 f"below 4KB threshold")
 return

 # Handle image files
 with Image.open(file_path) as img:
 img.load() # type: ignore
 fmt = (img.format or image_path.suffix[1:]).lower()
 fmt = (img.format or file_path.suffix[1:]).lower()
 print(f" 🏷️ Format: {fmt.upper()}, Mode: {img.mode}, Size: {img.size}")

 results: List[OptimizationResult] = []
Expand DownExpand Up@@ -145,13 +230,13 @@ def process_image(image_path: Path, output_dir: Path) -> None:
 # Save the best optimization
 best_result = max(results, key=lambda r: r.savings)
 if best_result.savings >= 4096: # 4KB threshold
 stem = image_path.stem
 stem = file_path.stem
 if best_result.method == "HEIC":
 output_path = output_dir / f"{stem}_optimized.heic"
 elif best_result.method.startswith("minified_"):
 output_path = output_dir / f"{stem}_optimized{image_path.suffix}"
 output_path = output_dir / f"{stem}_optimized{file_path.suffix}"
 else:
 output_path = output_dir / f"{stem}_optimized{image_path.suffix}"
 output_path = output_dir / f"{stem}_optimized{file_path.suffix}"

 save_optimized_image(img, output_path, best_result.method)
 print(f" ✅ Saved optimized version: {output_path.name}")
Expand All@@ -162,18 +247,18 @@ def process_image(image_path: Path, output_dir: Path) -> None:
 f"below 4KB threshold")

 except Exception as e:
 print(f" ❌ Failed to process image: {e}")
 print(f" ❌ Failed to process file: {e}")


def main():
 """Main function."""
 if len(sys.argv) != 2:
 print("Usage: python test_image_optimization.py <directory_or_image_path>")
 print("Usage: python test_image_optimization.py <directory_or_file_path>")
 print("\nThis script will:")
 print("- Analyze images for optimization opportunities")
 print("- Analyze images and PDFs for optimization opportunities")
 print("- Save optimized versions with '_optimized' suffix")
 print("- Show before/after file sizes and savings")
 print("- Allow you to visually compare original vs optimized")
 print("- Allow you to compare original vs optimized files")
 sys.exit(1)

 input_path = Path(sys.argv[1])
Expand All@@ -183,35 +268,35 @@ def main():
 sys.exit(1)

 # Collect image files
 image_extensions = {'.png', '.jpg', '.jpeg', '.heif', '.heic'}
 image_extensions = {'.png', '.jpg', '.jpeg', '.heif', '.heic', '.pdf'}

 if input_path.is_file():
 if input_path.suffix.lower() not in image_extensions:
 print(f"❌ Not a supported image file: {input_path}")
 print(f"❌ Not a supported file: {input_path}")
 sys.exit(1)
image_files = [input_path]
files = [input_path]
 output_dir = input_path.parent
 else:
image_files: List[Path] = []
files: List[Path] = []
 for ext in image_extensions:
image_files.extend(input_path.glob(f"*{ext}"))
image_files.extend(input_path.glob(f"*{ext.upper()}"))
files.extend(input_path.glob(f"*{ext}"))
files.extend(input_path.glob(f"*{ext.upper()}"))

 if not image_files:
 print(f"❌ No supported image files found in: {input_path}")
 if not files:
 print(f"❌ No supported files found in: {input_path}")
 sys.exit(1)
 output_dir = input_path

 print(f"🔍 Found {len(image_files)} image(s) to process")
 print(f"🔍 Found {len(files)} file(s) to process")
 print(f"📁 Output directory: {output_dir}")

 # Process each image
 for image_file in sorted(image_files):
process_image(image_file, output_dir)
 # Process each file
 for file in sorted(files):
process_file(file, output_dir)

 print(f"\n✨ Processing complete!")
 print(f"📂 Check {output_dir} for optimized images with '_optimized' suffix")
 print("👀 Open original and optimized images side-by-side to compare quality")
 print(f"📂 Check {output_dir} for optimized files with '_optimized' suffix")
 print("👀 Open original and optimized files side-by-side to compare quality")


if __name__ == "__main__":
Expand Down

35 changes: 32 additions & 3 deletions
src/launchpad/size/insights/apple/image_optimization.py

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -11,6 +11,7 @@
import pillow_heif # type: ignore

from PIL import Image
from pypdf import PdfReader, PdfWriter

from launchpad.size.insights.insight import Insight, InsightsInput
from launchpad.size.models.common import FileInfo
Expand DownExpand Up@@ -38,7 +39,7 @@ class _OptimizationResult:
class ImageOptimizationInsight(Insight[ImageOptimizationInsightResult]):
 """Analyse image optimisation opportunities in iOS apps."""

 OPTIMIZABLE_FORMATS = {"png", "jpg", "jpeg", "heif", "heic"}
 OPTIMIZABLE_FORMATS = {"png", "jpg", "jpeg", "heif", "heic", "pdf"}
 MIN_SAVINGS_THRESHOLD = 4096
 TARGET_JPEG_QUALITY = 85
 TARGET_HEIC_QUALITY = 85
Expand DownExpand Up@@ -104,8 +105,16 @@ def _analyze_image_optimization(
 if res := self._check_heic_minification(img, file_size):
 minify_savings, minified_size = res.savings, res.optimized_size
 except Exception as exc:
 logger.error("Failed to process %s: %s", display_path, exc)
 return None
 if file_type.lower() == "pdf":
 try:
 if res := self._check_pdf_optimization(full_path, file_size):
 minify_savings, minified_size = res.savings, res.optimized_size
 except Exception as pdf_exc:
 logger.error("Failed to process PDF %s: %s", display_path, pdf_exc)
 return None
 else:
 logger.error("Failed to process %s: %s", display_path, exc)
 return None

 if max(minify_savings, conversion_savings) < self.MIN_SAVINGS_THRESHOLD:
 return None
Expand DownExpand Up@@ -154,6 +163,26 @@ def _check_heic_minification(self, img: Image.Image, file_size: int) -> _Optimiz
 logger.error("HEIC minification check failed: %s", exc)
 return None

 def _check_pdf_optimization(self, file_path: Path, file_size: int) -> _OptimizationResult | None:
 try:
 reader = PdfReader(file_path)
 writer = PdfWriter()

 for page in reader.pages:
 page.compress_content_streams(level=9)
 writer.add_page(page)

 writer.compress_identical_objects(remove_identicals=True, remove_orphans=True)

 with io.BytesIO() as buf:
 writer.write(buf)
 new_size = buf.tell()

 return _OptimizationResult(file_size - new_size, new_size) if new_size < file_size else None
 except Exception as exc:
 logger.error("PDF optimization check failed: %s", exc)
 return None

 def _iter_optimizable_files(self, files: Sequence[FileInfo]) -> Iterable[FileInfo]:
 for fi in files:
 if fi.file_type == "car":
Expand Down
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Force GitHub README to respect dark mode
(function() {
var style = document.createElement('style');
style.textContent = '
.markdown-body {
color-scheme: dark light;
}
.markdown-body pre { background: #161b22 !important; }
.markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }
.markdown-body table th, .markdown-body table td { border-color: #30363d !important; }
.markdown-body img { background: #0d1117; }
.markdown-body blockquote { border-left-color: #8b949e; }
.markdown-body hr { border-color: #30363d; }
';
document.head.appendChild(style);
})();
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
Add PDF image optimization#229

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Open

trevor-e
wants to merge
2
commits into

base:main
Choose a base branch

from

 Open


Add PDF image optimization
#229
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


2 commits


Select commit
Hold shift + click to select a range
c66a7e4

Add PDF image optimization


trevor-e Jul 29, 2025
13e815c

update


trevor-e Jul 29, 2025

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


1 change: 1 addition & 0 deletions
requirements.txt

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -28,3 +28,4 @@ asn1crypto>=1.5.0
cryptography>=41.0.0
datadog==0.51.*
lzfse>=0.4.2
pypdf>=5.0.0

139 changes: 112 additions & 27 deletions
scripts/test_image_optimization.py

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -11,6 +11,7 @@
from typing import List, NamedTuple

import pillow_heif # type: ignore
from pypdf import PdfReader, PdfWriter
from PIL import Image

# Register HEIF support
Expand DownExpand Up@@ -85,6 +86,36 @@ def test_heic_conversion(img: Image.Image, file_size: int) -> OptimizationResult
 return None


def test_pdf_optimization(pdf_path: Path, file_size: int) -> OptimizationResult | None:
 """Test PDF optimization."""
 try:
 reader = PdfReader(pdf_path)
 writer = PdfWriter()

 for page in reader.pages:
 page.compress_content_streams(level=9)
 writer.add_page(page)

 writer.compress_identical_objects(remove_identicals=True, remove_orphans=True)

 with io.BytesIO() as buf:
 writer.write(buf)
 new_size = buf.tell()

 if new_size < file_size:
 savings = file_size - new_size
 return OptimizationResult(
 original_size=file_size,
 optimized_size=new_size,
 savings=savings,
 savings_percent=(savings / file_size) * 100,
 method="optimized_PDF"
 )
 except Exception as e:
 print(f" ❌ PDF optimization failed: {e}")
 return None


def save_optimized_image(img: Image.Image, output_path: Path, method: str) -> None:
 """Save the optimized image to disk."""
 try:
Expand All@@ -99,17 +130,71 @@ def save_optimized_image(img: Image.Image, output_path: Path, method: str) -> No
 print(f" ❌ Failed to save optimized image: {e}")


def process_image(image_path: Path, output_dir: Path) -> None:
 """Process a single image and save optimized versions."""
 print(f"\n📸 Processing: {image_path.name}")
def save_optimized_pdf(pdf_path: Path, output_path: Path) -> None:
 """Save the optimized PDF to disk."""
 try:
 reader = PdfReader(pdf_path)
 writer = PdfWriter()

 for page in reader.pages:
 page.compress_content_streams(level=9)
 writer.add_page(page)

 writer.compress_identical_objects(remove_identicals=True, remove_orphans=True)

 with open(output_path, 'wb') as f:
 writer.write(f)
 except Exception as e:
 print(f" ❌ Failed to save optimized PDF: {e}")


def process_file(file_path: Path, output_dir: Path) -> None:
 """Process a single file (image or PDF) and save optimized versions."""
 print(f"\n📄 Processing: {file_path.name}")

 try:
 file_size = image_path.stat().st_size
 file_size = file_path.stat().st_size
 print(f" 📊 Original size: {format_size(file_size)}")

 with Image.open(image_path) as img:
 file_ext = file_path.suffix.lower()

 # Handle PDF files
 if file_ext == '.pdf':
 print(f" 🏷️ Format: PDF")
 results: List[OptimizationResult] = []

 if result := test_pdf_optimization(file_path, file_size):
 results.append(result)

 if not results:
 print(" ℹ️ No optimization opportunities found")
 return

 # Show results
 print(" 💡 Optimization opportunities:")
 for i, result in enumerate(results, 1):
 print(f" {i}. {result.method}: "
 f"{format_size(result.savings)} saved "
 f"({result.savings_percent:.1f}%) "
 f"→ {format_size(result.optimized_size)}")

 # Save optimized PDF
 best_result = results[0]
 if best_result.savings >= 4096: # 4KB threshold
 output_path = output_dir / f"{file_path.stem}_optimized.pdf"
 save_optimized_pdf(file_path, output_path)
 print(f" ✅ Saved optimized version: {output_path.name}")
 print(f" 🎯 Savings: {format_size(best_result.savings)} "
 f"({best_result.savings_percent:.1f}%)")
 else:
 print(f" ⚠️ Savings ({format_size(best_result.savings)}) "
 f"below 4KB threshold")
 return

 # Handle image files
 with Image.open(file_path) as img:
 img.load() # type: ignore
 fmt = (img.format or image_path.suffix[1:]).lower()
 fmt = (img.format or file_path.suffix[1:]).lower()
 print(f" 🏷️ Format: {fmt.upper()}, Mode: {img.mode}, Size: {img.size}")

 results: List[OptimizationResult] = []
Expand DownExpand Up@@ -145,13 +230,13 @@ def process_image(image_path: Path, output_dir: Path) -> None:
 # Save the best optimization
 best_result = max(results, key=lambda r: r.savings)
 if best_result.savings >= 4096: # 4KB threshold
 stem = image_path.stem
 stem = file_path.stem
 if best_result.method == "HEIC":
 output_path = output_dir / f"{stem}_optimized.heic"
 elif best_result.method.startswith("minified_"):
 output_path = output_dir / f"{stem}_optimized{image_path.suffix}"
 output_path = output_dir / f"{stem}_optimized{file_path.suffix}"
 else:
 output_path = output_dir / f"{stem}_optimized{image_path.suffix}"
 output_path = output_dir / f"{stem}_optimized{file_path.suffix}"

 save_optimized_image(img, output_path, best_result.method)
 print(f" ✅ Saved optimized version: {output_path.name}")
Expand All@@ -162,18 +247,18 @@ def process_image(image_path: Path, output_dir: Path) -> None:
 f"below 4KB threshold")

 except Exception as e:
 print(f" ❌ Failed to process image: {e}")
 print(f" ❌ Failed to process file: {e}")


def main():
 """Main function."""
 if len(sys.argv) != 2:
 print("Usage: python test_image_optimization.py <directory_or_image_path>")
 print("Usage: python test_image_optimization.py <directory_or_file_path>")
 print("\nThis script will:")
 print("- Analyze images for optimization opportunities")
 print("- Analyze images and PDFs for optimization opportunities")
 print("- Save optimized versions with '_optimized' suffix")
 print("- Show before/after file sizes and savings")
 print("- Allow you to visually compare original vs optimized")
 print("- Allow you to compare original vs optimized files")
 sys.exit(1)

 input_path = Path(sys.argv[1])
Expand All@@ -183,35 +268,35 @@ def main():
 sys.exit(1)

 # Collect image files
 image_extensions = {'.png', '.jpg', '.jpeg', '.heif', '.heic'}
 image_extensions = {'.png', '.jpg', '.jpeg', '.heif', '.heic', '.pdf'}

 if input_path.is_file():
 if input_path.suffix.lower() not in image_extensions:
 print(f"❌ Not a supported image file: {input_path}")
 print(f"❌ Not a supported file: {input_path}")
 sys.exit(1)
image_files = [input_path]
files = [input_path]
 output_dir = input_path.parent
 else:
image_files: List[Path] = []
files: List[Path] = []
 for ext in image_extensions:
image_files.extend(input_path.glob(f"*{ext}"))
image_files.extend(input_path.glob(f"*{ext.upper()}"))
files.extend(input_path.glob(f"*{ext}"))
files.extend(input_path.glob(f"*{ext.upper()}"))

 if not image_files:
 print(f"❌ No supported image files found in: {input_path}")
 if not files:
 print(f"❌ No supported files found in: {input_path}")
 sys.exit(1)
 output_dir = input_path

 print(f"🔍 Found {len(image_files)} image(s) to process")
 print(f"🔍 Found {len(files)} file(s) to process")
 print(f"📁 Output directory: {output_dir}")

 # Process each image
 for image_file in sorted(image_files):
process_image(image_file, output_dir)
 # Process each file
 for file in sorted(files):
process_file(file, output_dir)

 print(f"\n✨ Processing complete!")
 print(f"📂 Check {output_dir} for optimized images with '_optimized' suffix")
 print("👀 Open original and optimized images side-by-side to compare quality")
 print(f"📂 Check {output_dir} for optimized files with '_optimized' suffix")
 print("👀 Open original and optimized files side-by-side to compare quality")


if __name__ == "__main__":
Expand Down

35 changes: 32 additions & 3 deletions
src/launchpad/size/insights/apple/image_optimization.py

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -11,6 +11,7 @@
import pillow_heif # type: ignore

from PIL import Image
from pypdf import PdfReader, PdfWriter

from launchpad.size.insights.insight import Insight, InsightsInput
from launchpad.size.models.common import FileInfo
Expand DownExpand Up@@ -38,7 +39,7 @@ class _OptimizationResult:
class ImageOptimizationInsight(Insight[ImageOptimizationInsightResult]):
 """Analyse image optimisation opportunities in iOS apps."""

 OPTIMIZABLE_FORMATS = {"png", "jpg", "jpeg", "heif", "heic"}
 OPTIMIZABLE_FORMATS = {"png", "jpg", "jpeg", "heif", "heic", "pdf"}
 MIN_SAVINGS_THRESHOLD = 4096
 TARGET_JPEG_QUALITY = 85
 TARGET_HEIC_QUALITY = 85
Expand DownExpand Up@@ -104,8 +105,16 @@ def _analyze_image_optimization(
 if res := self._check_heic_minification(img, file_size):
 minify_savings, minified_size = res.savings, res.optimized_size
 except Exception as exc:
 logger.error("Failed to process %s: %s", display_path, exc)
 return None
 if file_type.lower() == "pdf":
 try:
 if res := self._check_pdf_optimization(full_path, file_size):
 minify_savings, minified_size = res.savings, res.optimized_size
 except Exception as pdf_exc:
 logger.error("Failed to process PDF %s: %s", display_path, pdf_exc)
 return None
 else:
 logger.error("Failed to process %s: %s", display_path, exc)
 return None

 if max(minify_savings, conversion_savings) < self.MIN_SAVINGS_THRESHOLD:
 return None
Expand DownExpand Up@@ -154,6 +163,26 @@ def _check_heic_minification(self, img: Image.Image, file_size: int) -> _Optimiz
 logger.error("HEIC minification check failed: %s", exc)
 return None

 def _check_pdf_optimization(self, file_path: Path, file_size: int) -> _OptimizationResult | None:
 try:
 reader = PdfReader(file_path)
 writer = PdfWriter()

 for page in reader.pages:
 page.compress_content_streams(level=9)
 writer.add_page(page)

 writer.compress_identical_objects(remove_identicals=True, remove_orphans=True)

 with io.BytesIO() as buf:
 writer.write(buf)
 new_size = buf.tell()

 return _OptimizationResult(file_size - new_size, new_size) if new_size < file_size else None
 except Exception as exc:
 logger.error("PDF optimization check failed: %s", exc)
 return None

 def _iter_optimizable_files(self, files: Sequence[FileInfo]) -> Iterable[FileInfo]:
 for fi in files:
 if fi.file_type == "car":
Expand Down
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Highlight search terms from Google/DuckDuckGo/Bing referrer
(function() {
var ref = document.referrer;
var terms = [];
if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {
var url = new URL(ref);
var q = url.searchParams.get('q') || url.searchParams.get('p');
if (q) {
terms = q.split(/\s+/).filter(function(t) { return t.length > 2; });
}
}
if (terms.length === 0) return;
var style = document.createElement('style');
style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';
document.head.appendChild(style);
function highlight(node) {
if (node.nodeType === 3) { // text node
var text = node.textContent;
var found = false;
terms.forEach(function(term) {
var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\]\\]/g, '\\') + ')', 'gi');
if (regex.test(text)) {
found = true;
var frag = document.createDocumentFragment();
var parts = text.split(regex);
parts.forEach(function(part, i) {
if (i % 2 === 0) {
frag.appendChild(document.createTextNode(part));
} else {
var span = document.createElement('span');
span.className = 'userscript-highlight';
span.textContent = part;
frag.appendChild(span);
}
});
node.parentNode.replaceChild(frag, node);
}
});
} else if (node.nodeType === 1 && node.childNodes) { // element
var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];
if (!skipTags.includes(node.tagName)) {
Array.from(node.childNodes).forEach(highlight);
}
}
}
highlight(document.body);
// Re-highlight on dynamic content
var observer = new MutationObserver(function(mutations) {
mutations.forEach(function(m) {
m.addedNodes.forEach(function(node) {
if (node.nodeType === 1 || node.nodeType === 3) highlight(node);
});
});
});
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
Add PDF image optimization#229

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Open

trevor-e
wants to merge
2
commits into

base:main
Choose a base branch

from

 Open


Add PDF image optimization
#229
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


2 commits


Select commit
Hold shift + click to select a range
c66a7e4

Add PDF image optimization


trevor-e Jul 29, 2025
13e815c

update


trevor-e Jul 29, 2025

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


1 change: 1 addition & 0 deletions
requirements.txt

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -28,3 +28,4 @@ asn1crypto>=1.5.0
cryptography>=41.0.0
datadog==0.51.*
lzfse>=0.4.2
pypdf>=5.0.0

139 changes: 112 additions & 27 deletions
scripts/test_image_optimization.py

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -11,6 +11,7 @@
from typing import List, NamedTuple

import pillow_heif # type: ignore
from pypdf import PdfReader, PdfWriter
from PIL import Image

# Register HEIF support
Expand DownExpand Up@@ -85,6 +86,36 @@ def test_heic_conversion(img: Image.Image, file_size: int) -> OptimizationResult
 return None


def test_pdf_optimization(pdf_path: Path, file_size: int) -> OptimizationResult | None:
 """Test PDF optimization."""
 try:
 reader = PdfReader(pdf_path)
 writer = PdfWriter()

 for page in reader.pages:
 page.compress_content_streams(level=9)
 writer.add_page(page)

 writer.compress_identical_objects(remove_identicals=True, remove_orphans=True)

 with io.BytesIO() as buf:
 writer.write(buf)
 new_size = buf.tell()

 if new_size < file_size:
 savings = file_size - new_size
 return OptimizationResult(
 original_size=file_size,
 optimized_size=new_size,
 savings=savings,
 savings_percent=(savings / file_size) * 100,
 method="optimized_PDF"
 )
 except Exception as e:
 print(f" ❌ PDF optimization failed: {e}")
 return None


def save_optimized_image(img: Image.Image, output_path: Path, method: str) -> None:
 """Save the optimized image to disk."""
 try:
Expand All@@ -99,17 +130,71 @@ def save_optimized_image(img: Image.Image, output_path: Path, method: str) -> No
 print(f" ❌ Failed to save optimized image: {e}")


def process_image(image_path: Path, output_dir: Path) -> None:
 """Process a single image and save optimized versions."""
 print(f"\n📸 Processing: {image_path.name}")
def save_optimized_pdf(pdf_path: Path, output_path: Path) -> None:
 """Save the optimized PDF to disk."""
 try:
 reader = PdfReader(pdf_path)
 writer = PdfWriter()

 for page in reader.pages:
 page.compress_content_streams(level=9)
 writer.add_page(page)

 writer.compress_identical_objects(remove_identicals=True, remove_orphans=True)

 with open(output_path, 'wb') as f:
 writer.write(f)
 except Exception as e:
 print(f" ❌ Failed to save optimized PDF: {e}")


def process_file(file_path: Path, output_dir: Path) -> None:
 """Process a single file (image or PDF) and save optimized versions."""
 print(f"\n📄 Processing: {file_path.name}")

 try:
 file_size = image_path.stat().st_size
 file_size = file_path.stat().st_size
 print(f" 📊 Original size: {format_size(file_size)}")

 with Image.open(image_path) as img:
 file_ext = file_path.suffix.lower()

 # Handle PDF files
 if file_ext == '.pdf':
 print(f" 🏷️ Format: PDF")
 results: List[OptimizationResult] = []

 if result := test_pdf_optimization(file_path, file_size):
 results.append(result)

 if not results:
 print(" ℹ️ No optimization opportunities found")
 return

 # Show results
 print(" 💡 Optimization opportunities:")
 for i, result in enumerate(results, 1):
 print(f" {i}. {result.method}: "
 f"{format_size(result.savings)} saved "
 f"({result.savings_percent:.1f}%) "
 f"→ {format_size(result.optimized_size)}")

 # Save optimized PDF
 best_result = results[0]
 if best_result.savings >= 4096: # 4KB threshold
 output_path = output_dir / f"{file_path.stem}_optimized.pdf"
 save_optimized_pdf(file_path, output_path)
 print(f" ✅ Saved optimized version: {output_path.name}")
 print(f" 🎯 Savings: {format_size(best_result.savings)} "
 f"({best_result.savings_percent:.1f}%)")
 else:
 print(f" ⚠️ Savings ({format_size(best_result.savings)}) "
 f"below 4KB threshold")
 return

 # Handle image files
 with Image.open(file_path) as img:
 img.load() # type: ignore
 fmt = (img.format or image_path.suffix[1:]).lower()
 fmt = (img.format or file_path.suffix[1:]).lower()
 print(f" 🏷️ Format: {fmt.upper()}, Mode: {img.mode}, Size: {img.size}")

 results: List[OptimizationResult] = []
Expand DownExpand Up@@ -145,13 +230,13 @@ def process_image(image_path: Path, output_dir: Path) -> None:
 # Save the best optimization
 best_result = max(results, key=lambda r: r.savings)
 if best_result.savings >= 4096: # 4KB threshold
 stem = image_path.stem
 stem = file_path.stem
 if best_result.method == "HEIC":
 output_path = output_dir / f"{stem}_optimized.heic"
 elif best_result.method.startswith("minified_"):
 output_path = output_dir / f"{stem}_optimized{image_path.suffix}"
 output_path = output_dir / f"{stem}_optimized{file_path.suffix}"
 else:
 output_path = output_dir / f"{stem}_optimized{image_path.suffix}"
 output_path = output_dir / f"{stem}_optimized{file_path.suffix}"

 save_optimized_image(img, output_path, best_result.method)
 print(f" ✅ Saved optimized version: {output_path.name}")
Expand All@@ -162,18 +247,18 @@ def process_image(image_path: Path, output_dir: Path) -> None:
 f"below 4KB threshold")

 except Exception as e:
 print(f" ❌ Failed to process image: {e}")
 print(f" ❌ Failed to process file: {e}")


def main():
 """Main function."""
 if len(sys.argv) != 2:
 print("Usage: python test_image_optimization.py <directory_or_image_path>")
 print("Usage: python test_image_optimization.py <directory_or_file_path>")
 print("\nThis script will:")
 print("- Analyze images for optimization opportunities")
 print("- Analyze images and PDFs for optimization opportunities")
 print("- Save optimized versions with '_optimized' suffix")
 print("- Show before/after file sizes and savings")
 print("- Allow you to visually compare original vs optimized")
 print("- Allow you to compare original vs optimized files")
 sys.exit(1)

 input_path = Path(sys.argv[1])
Expand All@@ -183,35 +268,35 @@ def main():
 sys.exit(1)

 # Collect image files
 image_extensions = {'.png', '.jpg', '.jpeg', '.heif', '.heic'}
 image_extensions = {'.png', '.jpg', '.jpeg', '.heif', '.heic', '.pdf'}

 if input_path.is_file():
 if input_path.suffix.lower() not in image_extensions:
 print(f"❌ Not a supported image file: {input_path}")
 print(f"❌ Not a supported file: {input_path}")
 sys.exit(1)
image_files = [input_path]
files = [input_path]
 output_dir = input_path.parent
 else:
image_files: List[Path] = []
files: List[Path] = []
 for ext in image_extensions:
image_files.extend(input_path.glob(f"*{ext}"))
image_files.extend(input_path.glob(f"*{ext.upper()}"))
files.extend(input_path.glob(f"*{ext}"))
files.extend(input_path.glob(f"*{ext.upper()}"))

 if not image_files:
 print(f"❌ No supported image files found in: {input_path}")
 if not files:
 print(f"❌ No supported files found in: {input_path}")
 sys.exit(1)
 output_dir = input_path

 print(f"🔍 Found {len(image_files)} image(s) to process")
 print(f"🔍 Found {len(files)} file(s) to process")
 print(f"📁 Output directory: {output_dir}")

 # Process each image
 for image_file in sorted(image_files):
process_image(image_file, output_dir)
 # Process each file
 for file in sorted(files):
process_file(file, output_dir)

 print(f"\n✨ Processing complete!")
 print(f"📂 Check {output_dir} for optimized images with '_optimized' suffix")
 print("👀 Open original and optimized images side-by-side to compare quality")
 print(f"📂 Check {output_dir} for optimized files with '_optimized' suffix")
 print("👀 Open original and optimized files side-by-side to compare quality")


if __name__ == "__main__":
Expand Down

35 changes: 32 additions & 3 deletions
src/launchpad/size/insights/apple/image_optimization.py

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -11,6 +11,7 @@
import pillow_heif # type: ignore

from PIL import Image
from pypdf import PdfReader, PdfWriter

from launchpad.size.insights.insight import Insight, InsightsInput
from launchpad.size.models.common import FileInfo
Expand DownExpand Up@@ -38,7 +39,7 @@ class _OptimizationResult:
class ImageOptimizationInsight(Insight[ImageOptimizationInsightResult]):
 """Analyse image optimisation opportunities in iOS apps."""

 OPTIMIZABLE_FORMATS = {"png", "jpg", "jpeg", "heif", "heic"}
 OPTIMIZABLE_FORMATS = {"png", "jpg", "jpeg", "heif", "heic", "pdf"}
 MIN_SAVINGS_THRESHOLD = 4096
 TARGET_JPEG_QUALITY = 85
 TARGET_HEIC_QUALITY = 85
Expand DownExpand Up@@ -104,8 +105,16 @@ def _analyze_image_optimization(
 if res := self._check_heic_minification(img, file_size):
 minify_savings, minified_size = res.savings, res.optimized_size
 except Exception as exc:
 logger.error("Failed to process %s: %s", display_path, exc)
 return None
 if file_type.lower() == "pdf":
 try:
 if res := self._check_pdf_optimization(full_path, file_size):
 minify_savings, minified_size = res.savings, res.optimized_size
 except Exception as pdf_exc:
 logger.error("Failed to process PDF %s: %s", display_path, pdf_exc)
 return None
 else:
 logger.error("Failed to process %s: %s", display_path, exc)
 return None

 if max(minify_savings, conversion_savings) < self.MIN_SAVINGS_THRESHOLD:
 return None
Expand DownExpand Up@@ -154,6 +163,26 @@ def _check_heic_minification(self, img: Image.Image, file_size: int) -> _Optimiz
 logger.error("HEIC minification check failed: %s", exc)
 return None

 def _check_pdf_optimization(self, file_path: Path, file_size: int) -> _OptimizationResult | None:
 try:
 reader = PdfReader(file_path)
 writer = PdfWriter()

 for page in reader.pages:
 page.compress_content_streams(level=9)
 writer.add_page(page)

 writer.compress_identical_objects(remove_identicals=True, remove_orphans=True)

 with io.BytesIO() as buf:
 writer.write(buf)
 new_size = buf.tell()

 return _OptimizationResult(file_size - new_size, new_size) if new_size < file_size else None
 except Exception as exc:
 logger.error("PDF optimization check failed: %s", exc)
 return None

 def _iter_optimizable_files(self, files: Sequence[FileInfo]) -> Iterable[FileInfo]:
 for fi in files:
 if fi.file_type == "car":
Expand Down
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Strip utm_, fbclid, gclid, etc. from all links on page
(function() {
var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',
'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',
'ref', 'ref_src', 'source', 'medium', 'campaign'];
function cleanUrl(url) {
try {
var u = new URL(url, window.location.origin);
var changed = false;
trackingParams.forEach(function(p) {
if (u.searchParams.has(p)) {
u.searchParams.delete(p);
changed = true;
}
});
return changed ? u.toString() : url;
} catch (e) {
return url;
}
}
function cleanLinks() {
document.querySelectorAll('a[href]').forEach(function(a) {
var clean = cleanUrl(a.href);
if (clean !== a.href) a.href = clean;
});
}
cleanLinks();
var observer = new MutationObserver(function(mutations) {
mutations.forEach(function(m) {
m.addedNodes.forEach(function(node) {
if (node.nodeType === 1) {
if (node.tagName === 'A') cleanLinks();
node.querySelectorAll('a[href]').forEach(function(a) {
var clean = cleanUrl(a.href);
if (clean !== a.href) a.href = clean;
});
}
});
});
});
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '

Skip to content
Add PDF image optimization#229

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Open

trevor-e
wants to merge
2
commits into

base:main
Choose a base branch

from

 Open


Add PDF image optimization
#229
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


2 commits


Select commit
Hold shift + click to select a range
c66a7e4

Add PDF image optimization


trevor-e Jul 29, 2025
13e815c

update


trevor-e Jul 29, 2025

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


1 change: 1 addition & 0 deletions
requirements.txt

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -28,3 +28,4 @@ asn1crypto>=1.5.0
cryptography>=41.0.0
datadog==0.51.*
lzfse>=0.4.2
pypdf>=5.0.0

139 changes: 112 additions & 27 deletions
scripts/test_image_optimization.py

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -11,6 +11,7 @@
from typing import List, NamedTuple

import pillow_heif # type: ignore
from pypdf import PdfReader, PdfWriter
from PIL import Image

# Register HEIF support
Expand DownExpand Up@@ -85,6 +86,36 @@ def test_heic_conversion(img: Image.Image, file_size: int) -> OptimizationResult
 return None


def test_pdf_optimization(pdf_path: Path, file_size: int) -> OptimizationResult | None:
 """Test PDF optimization."""
 try:
 reader = PdfReader(pdf_path)
 writer = PdfWriter()

 for page in reader.pages:
 page.compress_content_streams(level=9)
 writer.add_page(page)

 writer.compress_identical_objects(remove_identicals=True, remove_orphans=True)

 with io.BytesIO() as buf:
 writer.write(buf)
 new_size = buf.tell()

 if new_size < file_size:
 savings = file_size - new_size
 return OptimizationResult(
 original_size=file_size,
 optimized_size=new_size,
 savings=savings,
 savings_percent=(savings / file_size) * 100,
 method="optimized_PDF"
 )
 except Exception as e:
 print(f" ❌ PDF optimization failed: {e}")
 return None


def save_optimized_image(img: Image.Image, output_path: Path, method: str) -> None:
 """Save the optimized image to disk."""
 try:
Expand All@@ -99,17 +130,71 @@ def save_optimized_image(img: Image.Image, output_path: Path, method: str) -> No
 print(f" ❌ Failed to save optimized image: {e}")


def process_image(image_path: Path, output_dir: Path) -> None:
 """Process a single image and save optimized versions."""
 print(f"\n📸 Processing: {image_path.name}")
def save_optimized_pdf(pdf_path: Path, output_path: Path) -> None:
 """Save the optimized PDF to disk."""
 try:
 reader = PdfReader(pdf_path)
 writer = PdfWriter()

 for page in reader.pages:
 page.compress_content_streams(level=9)
 writer.add_page(page)

 writer.compress_identical_objects(remove_identicals=True, remove_orphans=True)

 with open(output_path, 'wb') as f:
 writer.write(f)
 except Exception as e:
 print(f" ❌ Failed to save optimized PDF: {e}")


def process_file(file_path: Path, output_dir: Path) -> None:
 """Process a single file (image or PDF) and save optimized versions."""
 print(f"\n📄 Processing: {file_path.name}")

 try:
 file_size = image_path.stat().st_size
 file_size = file_path.stat().st_size
 print(f" 📊 Original size: {format_size(file_size)}")

 with Image.open(image_path) as img:
 file_ext = file_path.suffix.lower()

 # Handle PDF files
 if file_ext == '.pdf':
 print(f" 🏷️ Format: PDF")
 results: List[OptimizationResult] = []

 if result := test_pdf_optimization(file_path, file_size):
 results.append(result)

 if not results:
 print(" ℹ️ No optimization opportunities found")
 return

 # Show results
 print(" 💡 Optimization opportunities:")
 for i, result in enumerate(results, 1):
 print(f" {i}. {result.method}: "
 f"{format_size(result.savings)} saved "
 f"({result.savings_percent:.1f}%) "
 f"→ {format_size(result.optimized_size)}")

 # Save optimized PDF
 best_result = results[0]
 if best_result.savings >= 4096: # 4KB threshold
 output_path = output_dir / f"{file_path.stem}_optimized.pdf"
 save_optimized_pdf(file_path, output_path)
 print(f" ✅ Saved optimized version: {output_path.name}")
 print(f" 🎯 Savings: {format_size(best_result.savings)} "
 f"({best_result.savings_percent:.1f}%)")
 else:
 print(f" ⚠️ Savings ({format_size(best_result.savings)}) "
 f"below 4KB threshold")
 return

 # Handle image files
 with Image.open(file_path) as img:
 img.load() # type: ignore
 fmt = (img.format or image_path.suffix[1:]).lower()
 fmt = (img.format or file_path.suffix[1:]).lower()
 print(f" 🏷️ Format: {fmt.upper()}, Mode: {img.mode}, Size: {img.size}")

 results: List[OptimizationResult] = []
Expand DownExpand Up@@ -145,13 +230,13 @@ def process_image(image_path: Path, output_dir: Path) -> None:
 # Save the best optimization
 best_result = max(results, key=lambda r: r.savings)
 if best_result.savings >= 4096: # 4KB threshold
 stem = image_path.stem
 stem = file_path.stem
 if best_result.method == "HEIC":
 output_path = output_dir / f"{stem}_optimized.heic"
 elif best_result.method.startswith("minified_"):
 output_path = output_dir / f"{stem}_optimized{image_path.suffix}"
 output_path = output_dir / f"{stem}_optimized{file_path.suffix}"
 else:
 output_path = output_dir / f"{stem}_optimized{image_path.suffix}"
 output_path = output_dir / f"{stem}_optimized{file_path.suffix}"

 save_optimized_image(img, output_path, best_result.method)
 print(f" ✅ Saved optimized version: {output_path.name}")
Expand All@@ -162,18 +247,18 @@ def process_image(image_path: Path, output_dir: Path) -> None:
 f"below 4KB threshold")

 except Exception as e:
 print(f" ❌ Failed to process image: {e}")
 print(f" ❌ Failed to process file: {e}")


def main():
 """Main function."""
 if len(sys.argv) != 2:
 print("Usage: python test_image_optimization.py <directory_or_image_path>")
 print("Usage: python test_image_optimization.py <directory_or_file_path>")
 print("\nThis script will:")
 print("- Analyze images for optimization opportunities")
 print("- Analyze images and PDFs for optimization opportunities")
 print("- Save optimized versions with '_optimized' suffix")
 print("- Show before/after file sizes and savings")
 print("- Allow you to visually compare original vs optimized")
 print("- Allow you to compare original vs optimized files")
 sys.exit(1)

 input_path = Path(sys.argv[1])
Expand All@@ -183,35 +268,35 @@ def main():
 sys.exit(1)

 # Collect image files
 image_extensions = {'.png', '.jpg', '.jpeg', '.heif', '.heic'}
 image_extensions = {'.png', '.jpg', '.jpeg', '.heif', '.heic', '.pdf'}

 if input_path.is_file():
 if input_path.suffix.lower() not in image_extensions:
 print(f"❌ Not a supported image file: {input_path}")
 print(f"❌ Not a supported file: {input_path}")
 sys.exit(1)
image_files = [input_path]
files = [input_path]
 output_dir = input_path.parent
 else:
image_files: List[Path] = []
files: List[Path] = []
 for ext in image_extensions:
image_files.extend(input_path.glob(f"*{ext}"))
image_files.extend(input_path.glob(f"*{ext.upper()}"))
files.extend(input_path.glob(f"*{ext}"))
files.extend(input_path.glob(f"*{ext.upper()}"))

 if not image_files:
 print(f"❌ No supported image files found in: {input_path}")
 if not files:
 print(f"❌ No supported files found in: {input_path}")
 sys.exit(1)
 output_dir = input_path

 print(f"🔍 Found {len(image_files)} image(s) to process")
 print(f"🔍 Found {len(files)} file(s) to process")
 print(f"📁 Output directory: {output_dir}")

 # Process each image
 for image_file in sorted(image_files):
process_image(image_file, output_dir)
 # Process each file
 for file in sorted(files):
process_file(file, output_dir)

 print(f"\n✨ Processing complete!")
 print(f"📂 Check {output_dir} for optimized images with '_optimized' suffix")
 print("👀 Open original and optimized images side-by-side to compare quality")
 print(f"📂 Check {output_dir} for optimized files with '_optimized' suffix")
 print("👀 Open original and optimized files side-by-side to compare quality")


if __name__ == "__main__":
Expand Down

35 changes: 32 additions & 3 deletions
src/launchpad/size/insights/apple/image_optimization.py

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -11,6 +11,7 @@
import pillow_heif # type: ignore

from PIL import Image
from pypdf import PdfReader, PdfWriter

from launchpad.size.insights.insight import Insight, InsightsInput
from launchpad.size.models.common import FileInfo
Expand DownExpand Up@@ -38,7 +39,7 @@ class _OptimizationResult:
class ImageOptimizationInsight(Insight[ImageOptimizationInsightResult]):
 """Analyse image optimisation opportunities in iOS apps."""

 OPTIMIZABLE_FORMATS = {"png", "jpg", "jpeg", "heif", "heic"}
 OPTIMIZABLE_FORMATS = {"png", "jpg", "jpeg", "heif", "heic", "pdf"}
 MIN_SAVINGS_THRESHOLD = 4096
 TARGET_JPEG_QUALITY = 85
 TARGET_HEIC_QUALITY = 85
Expand DownExpand Up@@ -104,8 +105,16 @@ def _analyze_image_optimization(
 if res := self._check_heic_minification(img, file_size):
 minify_savings, minified_size = res.savings, res.optimized_size
 except Exception as exc:
 logger.error("Failed to process %s: %s", display_path, exc)
 return None
 if file_type.lower() == "pdf":
 try:
 if res := self._check_pdf_optimization(full_path, file_size):
 minify_savings, minified_size = res.savings, res.optimized_size
 except Exception as pdf_exc:
 logger.error("Failed to process PDF %s: %s", display_path, pdf_exc)
 return None
 else:
 logger.error("Failed to process %s: %s", display_path, exc)
 return None

 if max(minify_savings, conversion_savings) < self.MIN_SAVINGS_THRESHOLD:
 return None
Expand DownExpand Up@@ -154,6 +163,26 @@ def _check_heic_minification(self, img: Image.Image, file_size: int) -> _Optimiz
 logger.error("HEIC minification check failed: %s", exc)
 return None

 def _check_pdf_optimization(self, file_path: Path, file_size: int) -> _OptimizationResult | None:
 try:
 reader = PdfReader(file_path)
 writer = PdfWriter()

 for page in reader.pages:
 page.compress_content_streams(level=9)
 writer.add_page(page)

 writer.compress_identical_objects(remove_identicals=True, remove_orphans=True)

 with io.BytesIO() as buf:
 writer.write(buf)
 new_size = buf.tell()

 return _OptimizationResult(file_size - new_size, new_size) if new_size < file_size else None
 except Exception as exc:
 logger.error("PDF optimization check failed: %s", exc)
 return None

 def _iter_optimizable_files(self, files: Sequence[FileInfo]) -> Iterable[FileInfo]:
 for fi in files:
 if fi.file_type == "car":
Expand Down
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Auto-enable theater mode on YouTube
(function() {
function tryTheater() {
var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]');
if (btn && !btn.classList.contains('activated')) {
btn.click();
}
}
// Try immediately
tryTheater();
// Try after navigation (SPA)
var lastUrl = location.href;
setInterval(function() {
if (location.href !== lastUrl) {
lastUrl = location.href;
setTimeout(tryTheater, 500);
}
}, 1000);
// Also try on player load
var observer = new MutationObserver(tryTheater);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
Add PDF image optimization#229

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Open

trevor-e
wants to merge
2
commits into

base:main
Choose a base branch

from

 Open


Add PDF image optimization
#229
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


2 commits


Select commit
Hold shift + click to select a range
c66a7e4

Add PDF image optimization


trevor-e Jul 29, 2025
13e815c

update


trevor-e Jul 29, 2025

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


1 change: 1 addition & 0 deletions
requirements.txt

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -28,3 +28,4 @@ asn1crypto>=1.5.0
cryptography>=41.0.0
datadog==0.51.*
lzfse>=0.4.2
pypdf>=5.0.0

139 changes: 112 additions & 27 deletions
scripts/test_image_optimization.py

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -11,6 +11,7 @@
from typing import List, NamedTuple

import pillow_heif # type: ignore
from pypdf import PdfReader, PdfWriter
from PIL import Image

# Register HEIF support
Expand DownExpand Up@@ -85,6 +86,36 @@ def test_heic_conversion(img: Image.Image, file_size: int) -> OptimizationResult
 return None


def test_pdf_optimization(pdf_path: Path, file_size: int) -> OptimizationResult | None:
 """Test PDF optimization."""
 try:
 reader = PdfReader(pdf_path)
 writer = PdfWriter()

 for page in reader.pages:
 page.compress_content_streams(level=9)
 writer.add_page(page)

 writer.compress_identical_objects(remove_identicals=True, remove_orphans=True)

 with io.BytesIO() as buf:
 writer.write(buf)
 new_size = buf.tell()

 if new_size < file_size:
 savings = file_size - new_size
 return OptimizationResult(
 original_size=file_size,
 optimized_size=new_size,
 savings=savings,
 savings_percent=(savings / file_size) * 100,
 method="optimized_PDF"
 )
 except Exception as e:
 print(f" ❌ PDF optimization failed: {e}")
 return None


def save_optimized_image(img: Image.Image, output_path: Path, method: str) -> None:
 """Save the optimized image to disk."""
 try:
Expand All@@ -99,17 +130,71 @@ def save_optimized_image(img: Image.Image, output_path: Path, method: str) -> No
 print(f" ❌ Failed to save optimized image: {e}")


def process_image(image_path: Path, output_dir: Path) -> None:
 """Process a single image and save optimized versions."""
 print(f"\n📸 Processing: {image_path.name}")
def save_optimized_pdf(pdf_path: Path, output_path: Path) -> None:
 """Save the optimized PDF to disk."""
 try:
 reader = PdfReader(pdf_path)
 writer = PdfWriter()

 for page in reader.pages:
 page.compress_content_streams(level=9)
 writer.add_page(page)

 writer.compress_identical_objects(remove_identicals=True, remove_orphans=True)

 with open(output_path, 'wb') as f:
 writer.write(f)
 except Exception as e:
 print(f" ❌ Failed to save optimized PDF: {e}")


def process_file(file_path: Path, output_dir: Path) -> None:
 """Process a single file (image or PDF) and save optimized versions."""
 print(f"\n📄 Processing: {file_path.name}")

 try:
 file_size = image_path.stat().st_size
 file_size = file_path.stat().st_size
 print(f" 📊 Original size: {format_size(file_size)}")

 with Image.open(image_path) as img:
 file_ext = file_path.suffix.lower()

 # Handle PDF files
 if file_ext == '.pdf':
 print(f" 🏷️ Format: PDF")
 results: List[OptimizationResult] = []

 if result := test_pdf_optimization(file_path, file_size):
 results.append(result)

 if not results:
 print(" ℹ️ No optimization opportunities found")
 return

 # Show results
 print(" 💡 Optimization opportunities:")
 for i, result in enumerate(results, 1):
 print(f" {i}. {result.method}: "
 f"{format_size(result.savings)} saved "
 f"({result.savings_percent:.1f}%) "
 f"→ {format_size(result.optimized_size)}")

 # Save optimized PDF
 best_result = results[0]
 if best_result.savings >= 4096: # 4KB threshold
 output_path = output_dir / f"{file_path.stem}_optimized.pdf"
 save_optimized_pdf(file_path, output_path)
 print(f" ✅ Saved optimized version: {output_path.name}")
 print(f" 🎯 Savings: {format_size(best_result.savings)} "
 f"({best_result.savings_percent:.1f}%)")
 else:
 print(f" ⚠️ Savings ({format_size(best_result.savings)}) "
 f"below 4KB threshold")
 return

 # Handle image files
 with Image.open(file_path) as img:
 img.load() # type: ignore
 fmt = (img.format or image_path.suffix[1:]).lower()
 fmt = (img.format or file_path.suffix[1:]).lower()
 print(f" 🏷️ Format: {fmt.upper()}, Mode: {img.mode}, Size: {img.size}")

 results: List[OptimizationResult] = []
Expand DownExpand Up@@ -145,13 +230,13 @@ def process_image(image_path: Path, output_dir: Path) -> None:
 # Save the best optimization
 best_result = max(results, key=lambda r: r.savings)
 if best_result.savings >= 4096: # 4KB threshold
 stem = image_path.stem
 stem = file_path.stem
 if best_result.method == "HEIC":
 output_path = output_dir / f"{stem}_optimized.heic"
 elif best_result.method.startswith("minified_"):
 output_path = output_dir / f"{stem}_optimized{image_path.suffix}"
 output_path = output_dir / f"{stem}_optimized{file_path.suffix}"
 else:
 output_path = output_dir / f"{stem}_optimized{image_path.suffix}"
 output_path = output_dir / f"{stem}_optimized{file_path.suffix}"

 save_optimized_image(img, output_path, best_result.method)
 print(f" ✅ Saved optimized version: {output_path.name}")
Expand All@@ -162,18 +247,18 @@ def process_image(image_path: Path, output_dir: Path) -> None:
 f"below 4KB threshold")

 except Exception as e:
 print(f" ❌ Failed to process image: {e}")
 print(f" ❌ Failed to process file: {e}")


def main():
 """Main function."""
 if len(sys.argv) != 2:
 print("Usage: python test_image_optimization.py <directory_or_image_path>")
 print("Usage: python test_image_optimization.py <directory_or_file_path>")
 print("\nThis script will:")
 print("- Analyze images for optimization opportunities")
 print("- Analyze images and PDFs for optimization opportunities")
 print("- Save optimized versions with '_optimized' suffix")
 print("- Show before/after file sizes and savings")
 print("- Allow you to visually compare original vs optimized")
 print("- Allow you to compare original vs optimized files")
 sys.exit(1)

 input_path = Path(sys.argv[1])
Expand All@@ -183,35 +268,35 @@ def main():
 sys.exit(1)

 # Collect image files
 image_extensions = {'.png', '.jpg', '.jpeg', '.heif', '.heic'}
 image_extensions = {'.png', '.jpg', '.jpeg', '.heif', '.heic', '.pdf'}

 if input_path.is_file():
 if input_path.suffix.lower() not in image_extensions:
 print(f"❌ Not a supported image file: {input_path}")
 print(f"❌ Not a supported file: {input_path}")
 sys.exit(1)
image_files = [input_path]
files = [input_path]
 output_dir = input_path.parent
 else:
image_files: List[Path] = []
files: List[Path] = []
 for ext in image_extensions:
image_files.extend(input_path.glob(f"*{ext}"))
image_files.extend(input_path.glob(f"*{ext.upper()}"))
files.extend(input_path.glob(f"*{ext}"))
files.extend(input_path.glob(f"*{ext.upper()}"))

 if not image_files:
 print(f"❌ No supported image files found in: {input_path}")
 if not files:
 print(f"❌ No supported files found in: {input_path}")
 sys.exit(1)
 output_dir = input_path

 print(f"🔍 Found {len(image_files)} image(s) to process")
 print(f"🔍 Found {len(files)} file(s) to process")
 print(f"📁 Output directory: {output_dir}")

 # Process each image
 for image_file in sorted(image_files):
process_image(image_file, output_dir)
 # Process each file
 for file in sorted(files):
process_file(file, output_dir)

 print(f"\n✨ Processing complete!")
 print(f"📂 Check {output_dir} for optimized images with '_optimized' suffix")
 print("👀 Open original and optimized images side-by-side to compare quality")
 print(f"📂 Check {output_dir} for optimized files with '_optimized' suffix")
 print("👀 Open original and optimized files side-by-side to compare quality")


if __name__ == "__main__":
Expand Down

35 changes: 32 additions & 3 deletions
src/launchpad/size/insights/apple/image_optimization.py

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -11,6 +11,7 @@
import pillow_heif # type: ignore

from PIL import Image
from pypdf import PdfReader, PdfWriter

from launchpad.size.insights.insight import Insight, InsightsInput
from launchpad.size.models.common import FileInfo
Expand DownExpand Up@@ -38,7 +39,7 @@ class _OptimizationResult:
class ImageOptimizationInsight(Insight[ImageOptimizationInsightResult]):
 """Analyse image optimisation opportunities in iOS apps."""

 OPTIMIZABLE_FORMATS = {"png", "jpg", "jpeg", "heif", "heic"}
 OPTIMIZABLE_FORMATS = {"png", "jpg", "jpeg", "heif", "heic", "pdf"}
 MIN_SAVINGS_THRESHOLD = 4096
 TARGET_JPEG_QUALITY = 85
 TARGET_HEIC_QUALITY = 85
Expand DownExpand Up@@ -104,8 +105,16 @@ def _analyze_image_optimization(
 if res := self._check_heic_minification(img, file_size):
 minify_savings, minified_size = res.savings, res.optimized_size
 except Exception as exc:
 logger.error("Failed to process %s: %s", display_path, exc)
 return None
 if file_type.lower() == "pdf":
 try:
 if res := self._check_pdf_optimization(full_path, file_size):
 minify_savings, minified_size = res.savings, res.optimized_size
 except Exception as pdf_exc:
 logger.error("Failed to process PDF %s: %s", display_path, pdf_exc)
 return None
 else:
 logger.error("Failed to process %s: %s", display_path, exc)
 return None

 if max(minify_savings, conversion_savings) < self.MIN_SAVINGS_THRESHOLD:
 return None
Expand DownExpand Up@@ -154,6 +163,26 @@ def _check_heic_minification(self, img: Image.Image, file_size: int) -> _Optimiz
 logger.error("HEIC minification check failed: %s", exc)
 return None

 def _check_pdf_optimization(self, file_path: Path, file_size: int) -> _OptimizationResult | None:
 try:
 reader = PdfReader(file_path)
 writer = PdfWriter()

 for page in reader.pages:
 page.compress_content_streams(level=9)
 writer.add_page(page)

 writer.compress_identical_objects(remove_identicals=True, remove_orphans=True)

 with io.BytesIO() as buf:
 writer.write(buf)
 new_size = buf.tell()

 return _OptimizationResult(file_size - new_size, new_size) if new_size < file_size else None
 except Exception as exc:
 logger.error("PDF optimization check failed: %s", exc)
 return None

 def _iter_optimizable_files(self, files: Sequence[FileInfo]) -> Iterable[FileInfo]:
 for fi in files:
 if fi.file_type == "car":
Expand Down
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Remove or un-stick sticky/fixed headers that block content
(function() {
function unstick() {
document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) {
if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {
el.style.position = 'static';
el.style.top = 'auto';
el.style.zIndex = 'auto';
}
});
}
unstick();
var observer = new MutationObserver(unstick);
observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });
})();
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
Add PDF image optimization#229

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Open

trevor-e
wants to merge
2
commits into

base:main
Choose a base branch

from

 Open


Add PDF image optimization
#229
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


2 commits


Select commit
Hold shift + click to select a range
c66a7e4

Add PDF image optimization


trevor-e Jul 29, 2025
13e815c

update


trevor-e Jul 29, 2025

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


1 change: 1 addition & 0 deletions
requirements.txt

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -28,3 +28,4 @@ asn1crypto>=1.5.0
cryptography>=41.0.0
datadog==0.51.*
lzfse>=0.4.2
pypdf>=5.0.0

139 changes: 112 additions & 27 deletions
scripts/test_image_optimization.py

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -11,6 +11,7 @@
from typing import List, NamedTuple

import pillow_heif # type: ignore
from pypdf import PdfReader, PdfWriter
from PIL import Image

# Register HEIF support
Expand DownExpand Up@@ -85,6 +86,36 @@ def test_heic_conversion(img: Image.Image, file_size: int) -> OptimizationResult
 return None


def test_pdf_optimization(pdf_path: Path, file_size: int) -> OptimizationResult | None:
 """Test PDF optimization."""
 try:
 reader = PdfReader(pdf_path)
 writer = PdfWriter()

 for page in reader.pages:
 page.compress_content_streams(level=9)
 writer.add_page(page)

 writer.compress_identical_objects(remove_identicals=True, remove_orphans=True)

 with io.BytesIO() as buf:
 writer.write(buf)
 new_size = buf.tell()

 if new_size < file_size:
 savings = file_size - new_size
 return OptimizationResult(
 original_size=file_size,
 optimized_size=new_size,
 savings=savings,
 savings_percent=(savings / file_size) * 100,
 method="optimized_PDF"
 )
 except Exception as e:
 print(f" ❌ PDF optimization failed: {e}")
 return None


def save_optimized_image(img: Image.Image, output_path: Path, method: str) -> None:
 """Save the optimized image to disk."""
 try:
Expand All@@ -99,17 +130,71 @@ def save_optimized_image(img: Image.Image, output_path: Path, method: str) -> No
 print(f" ❌ Failed to save optimized image: {e}")


def process_image(image_path: Path, output_dir: Path) -> None:
 """Process a single image and save optimized versions."""
 print(f"\n📸 Processing: {image_path.name}")
def save_optimized_pdf(pdf_path: Path, output_path: Path) -> None:
 """Save the optimized PDF to disk."""
 try:
 reader = PdfReader(pdf_path)
 writer = PdfWriter()

 for page in reader.pages:
 page.compress_content_streams(level=9)
 writer.add_page(page)

 writer.compress_identical_objects(remove_identicals=True, remove_orphans=True)

 with open(output_path, 'wb') as f:
 writer.write(f)
 except Exception as e:
 print(f" ❌ Failed to save optimized PDF: {e}")


def process_file(file_path: Path, output_dir: Path) -> None:
 """Process a single file (image or PDF) and save optimized versions."""
 print(f"\n📄 Processing: {file_path.name}")

 try:
 file_size = image_path.stat().st_size
 file_size = file_path.stat().st_size
 print(f" 📊 Original size: {format_size(file_size)}")

 with Image.open(image_path) as img:
 file_ext = file_path.suffix.lower()

 # Handle PDF files
 if file_ext == '.pdf':
 print(f" 🏷️ Format: PDF")
 results: List[OptimizationResult] = []

 if result := test_pdf_optimization(file_path, file_size):
 results.append(result)

 if not results:
 print(" ℹ️ No optimization opportunities found")
 return

 # Show results
 print(" 💡 Optimization opportunities:")
 for i, result in enumerate(results, 1):
 print(f" {i}. {result.method}: "
 f"{format_size(result.savings)} saved "
 f"({result.savings_percent:.1f}%) "
 f"→ {format_size(result.optimized_size)}")

 # Save optimized PDF
 best_result = results[0]
 if best_result.savings >= 4096: # 4KB threshold
 output_path = output_dir / f"{file_path.stem}_optimized.pdf"
 save_optimized_pdf(file_path, output_path)
 print(f" ✅ Saved optimized version: {output_path.name}")
 print(f" 🎯 Savings: {format_size(best_result.savings)} "
 f"({best_result.savings_percent:.1f}%)")
 else:
 print(f" ⚠️ Savings ({format_size(best_result.savings)}) "
 f"below 4KB threshold")
 return

 # Handle image files
 with Image.open(file_path) as img:
 img.load() # type: ignore
 fmt = (img.format or image_path.suffix[1:]).lower()
 fmt = (img.format or file_path.suffix[1:]).lower()
 print(f" 🏷️ Format: {fmt.upper()}, Mode: {img.mode}, Size: {img.size}")

 results: List[OptimizationResult] = []
Expand DownExpand Up@@ -145,13 +230,13 @@ def process_image(image_path: Path, output_dir: Path) -> None:
 # Save the best optimization
 best_result = max(results, key=lambda r: r.savings)
 if best_result.savings >= 4096: # 4KB threshold
 stem = image_path.stem
 stem = file_path.stem
 if best_result.method == "HEIC":
 output_path = output_dir / f"{stem}_optimized.heic"
 elif best_result.method.startswith("minified_"):
 output_path = output_dir / f"{stem}_optimized{image_path.suffix}"
 output_path = output_dir / f"{stem}_optimized{file_path.suffix}"
 else:
 output_path = output_dir / f"{stem}_optimized{image_path.suffix}"
 output_path = output_dir / f"{stem}_optimized{file_path.suffix}"

 save_optimized_image(img, output_path, best_result.method)
 print(f" ✅ Saved optimized version: {output_path.name}")
Expand All@@ -162,18 +247,18 @@ def process_image(image_path: Path, output_dir: Path) -> None:
 f"below 4KB threshold")

 except Exception as e:
 print(f" ❌ Failed to process image: {e}")
 print(f" ❌ Failed to process file: {e}")


def main():
 """Main function."""
 if len(sys.argv) != 2:
 print("Usage: python test_image_optimization.py <directory_or_image_path>")
 print("Usage: python test_image_optimization.py <directory_or_file_path>")
 print("\nThis script will:")
 print("- Analyze images for optimization opportunities")
 print("- Analyze images and PDFs for optimization opportunities")
 print("- Save optimized versions with '_optimized' suffix")
 print("- Show before/after file sizes and savings")
 print("- Allow you to visually compare original vs optimized")
 print("- Allow you to compare original vs optimized files")
 sys.exit(1)

 input_path = Path(sys.argv[1])
Expand All@@ -183,35 +268,35 @@ def main():
 sys.exit(1)

 # Collect image files
 image_extensions = {'.png', '.jpg', '.jpeg', '.heif', '.heic'}
 image_extensions = {'.png', '.jpg', '.jpeg', '.heif', '.heic', '.pdf'}

 if input_path.is_file():
 if input_path.suffix.lower() not in image_extensions:
 print(f"❌ Not a supported image file: {input_path}")
 print(f"❌ Not a supported file: {input_path}")
 sys.exit(1)
image_files = [input_path]
files = [input_path]
 output_dir = input_path.parent
 else:
image_files: List[Path] = []
files: List[Path] = []
 for ext in image_extensions:
image_files.extend(input_path.glob(f"*{ext}"))
image_files.extend(input_path.glob(f"*{ext.upper()}"))
files.extend(input_path.glob(f"*{ext}"))
files.extend(input_path.glob(f"*{ext.upper()}"))

 if not image_files:
 print(f"❌ No supported image files found in: {input_path}")
 if not files:
 print(f"❌ No supported files found in: {input_path}")
 sys.exit(1)
 output_dir = input_path

 print(f"🔍 Found {len(image_files)} image(s) to process")
 print(f"🔍 Found {len(files)} file(s) to process")
 print(f"📁 Output directory: {output_dir}")

 # Process each image
 for image_file in sorted(image_files):
process_image(image_file, output_dir)
 # Process each file
 for file in sorted(files):
process_file(file, output_dir)

 print(f"\n✨ Processing complete!")
 print(f"📂 Check {output_dir} for optimized images with '_optimized' suffix")
 print("👀 Open original and optimized images side-by-side to compare quality")
 print(f"📂 Check {output_dir} for optimized files with '_optimized' suffix")
 print("👀 Open original and optimized files side-by-side to compare quality")


if __name__ == "__main__":
Expand Down

35 changes: 32 additions & 3 deletions
src/launchpad/size/insights/apple/image_optimization.py

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -11,6 +11,7 @@
import pillow_heif # type: ignore

from PIL import Image
from pypdf import PdfReader, PdfWriter

from launchpad.size.insights.insight import Insight, InsightsInput
from launchpad.size.models.common import FileInfo
Expand DownExpand Up@@ -38,7 +39,7 @@ class _OptimizationResult:
class ImageOptimizationInsight(Insight[ImageOptimizationInsightResult]):
 """Analyse image optimisation opportunities in iOS apps."""

 OPTIMIZABLE_FORMATS = {"png", "jpg", "jpeg", "heif", "heic"}
 OPTIMIZABLE_FORMATS = {"png", "jpg", "jpeg", "heif", "heic", "pdf"}
 MIN_SAVINGS_THRESHOLD = 4096
 TARGET_JPEG_QUALITY = 85
 TARGET_HEIC_QUALITY = 85
Expand DownExpand Up@@ -104,8 +105,16 @@ def _analyze_image_optimization(
 if res := self._check_heic_minification(img, file_size):
 minify_savings, minified_size = res.savings, res.optimized_size
 except Exception as exc:
 logger.error("Failed to process %s: %s", display_path, exc)
 return None
 if file_type.lower() == "pdf":
 try:
 if res := self._check_pdf_optimization(full_path, file_size):
 minify_savings, minified_size = res.savings, res.optimized_size
 except Exception as pdf_exc:
 logger.error("Failed to process PDF %s: %s", display_path, pdf_exc)
 return None
 else:
 logger.error("Failed to process %s: %s", display_path, exc)
 return None

 if max(minify_savings, conversion_savings) < self.MIN_SAVINGS_THRESHOLD:
 return None
Expand DownExpand Up@@ -154,6 +163,26 @@ def _check_heic_minification(self, img: Image.Image, file_size: int) -> _Optimiz
 logger.error("HEIC minification check failed: %s", exc)
 return None

 def _check_pdf_optimization(self, file_path: Path, file_size: int) -> _OptimizationResult | None:
 try:
 reader = PdfReader(file_path)
 writer = PdfWriter()

 for page in reader.pages:
 page.compress_content_streams(level=9)
 writer.add_page(page)

 writer.compress_identical_objects(remove_identicals=True, remove_orphans=True)

 with io.BytesIO() as buf:
 writer.write(buf)
 new_size = buf.tell()

 return _OptimizationResult(file_size - new_size, new_size) if new_size < file_size else None
 except Exception as exc:
 logger.error("PDF optimization check failed: %s", exc)
 return None

 def _iter_optimizable_files(self, files: Sequence[FileInfo]) -> Iterable[FileInfo]:
 for fi in files:
 if fi.file_type == "car":
Expand Down
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Universal Dark Mode - works on any site
(function() {
var enabled = true;
function applyDarkMode() {
if (!enabled) return;
// Create style element if it doesn't exist
var style = document.getElementById('universal-dark-mode-style');
if (!style) {
style = document.createElement('style');
style.id = 'universal-dark-mode-style';
document.head.appendChild(style);
}
// Dark mode CSS - inverts colors but preserves images/video
style.textContent = '
/* Invert everything except media */
html {
filter: invert(1) hue-rotate(180deg) !important;
background: #1a1a2e !important;
}
/* Restore images, videos, iframes, canvas */
img, video, iframe, canvas, svg, picture, [style*="background-image"] {
filter: invert(1) hue-rotate(180deg) !important;
}
/* Preserve specific elements that should not be inverted */
.no-dark-mode, .no-dark-mode *,
[data-theme="light"], [data-theme="light"],
.ace_editor, .ace_editor *,
.CodeMirror, .CodeMirror *,
.monaco-editor, .monaco-editor *,
.markdown-body pre, .markdown-body pre *,
.highlight, .highlight *,
pre code, pre code * {
filter: none !important;
}
/* Fix common UI elements */
.modal, .popup, .dropdown-menu, .tooltip, .popover {
filter: invert(1) hue-rotate(180deg) !important;
background: #2d2d44 !important;
border-color: #444 !important;
}
/* Scrollbars */
::-webkit-scrollbar { background: #1a1a2e !important; }
::-webkit-scrollbar-thumb { background: #444 !important; }
::-webkit-scrollbar-thumb:hover { background: #555 !important; }
/* Selection */
::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }
::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }
';
}
function removeDarkMode() {
var style = document.getElementById('universal-dark-mode-style');
if (style) style.remove();
}
// Toggle with Alt+Shift+D
document.addEventListener('keydown', function(e) {
if (e.altKey && e.shiftKey && e.key === 'D') {
e.preventDefault();
enabled = !enabled;
if (enabled) {
applyDarkMode();
console.log('[Universal Dark Mode] Enabled');
} else {
removeDarkMode();
console.log('[Universal Dark Mode] Disabled');
}
}
});
// Apply on load
applyDarkMode();
// Re-apply on dynamic content
var observer = new MutationObserver(function(mutations) {
if (enabled && !document.getElementById('universal-dark-mode-style')) {
applyDarkMode();
}
});
observer.observe(document.head, { childList: true });
console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');
})();
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();

Skip to content
Add PDF image optimization#229

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Open

trevor-e
wants to merge
2
commits into

base:main
Choose a base branch

from

 Open


Add PDF image optimization
#229
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


2 commits


Select commit
Hold shift + click to select a range
c66a7e4

Add PDF image optimization


trevor-e Jul 29, 2025
13e815c

update


trevor-e Jul 29, 2025

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


1 change: 1 addition & 0 deletions
requirements.txt

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -28,3 +28,4 @@ asn1crypto>=1.5.0
cryptography>=41.0.0
datadog==0.51.*
lzfse>=0.4.2
pypdf>=5.0.0

139 changes: 112 additions & 27 deletions
scripts/test_image_optimization.py

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -11,6 +11,7 @@
from typing import List, NamedTuple

import pillow_heif # type: ignore
from pypdf import PdfReader, PdfWriter
from PIL import Image

# Register HEIF support
Expand DownExpand Up@@ -85,6 +86,36 @@ def test_heic_conversion(img: Image.Image, file_size: int) -> OptimizationResult
 return None


def test_pdf_optimization(pdf_path: Path, file_size: int) -> OptimizationResult | None:
 """Test PDF optimization."""
 try:
 reader = PdfReader(pdf_path)
 writer = PdfWriter()

 for page in reader.pages:
 page.compress_content_streams(level=9)
 writer.add_page(page)

 writer.compress_identical_objects(remove_identicals=True, remove_orphans=True)

 with io.BytesIO() as buf:
 writer.write(buf)
 new_size = buf.tell()

 if new_size < file_size:
 savings = file_size - new_size
 return OptimizationResult(
 original_size=file_size,
 optimized_size=new_size,
 savings=savings,
 savings_percent=(savings / file_size) * 100,
 method="optimized_PDF"
 )
 except Exception as e:
 print(f" ❌ PDF optimization failed: {e}")
 return None


def save_optimized_image(img: Image.Image, output_path: Path, method: str) -> None:
 """Save the optimized image to disk."""
 try:
Expand All@@ -99,17 +130,71 @@ def save_optimized_image(img: Image.Image, output_path: Path, method: str) -> No
 print(f" ❌ Failed to save optimized image: {e}")


def process_image(image_path: Path, output_dir: Path) -> None:
 """Process a single image and save optimized versions."""
 print(f"\n📸 Processing: {image_path.name}")
def save_optimized_pdf(pdf_path: Path, output_path: Path) -> None:
 """Save the optimized PDF to disk."""
 try:
 reader = PdfReader(pdf_path)
 writer = PdfWriter()

 for page in reader.pages:
 page.compress_content_streams(level=9)
 writer.add_page(page)

 writer.compress_identical_objects(remove_identicals=True, remove_orphans=True)

 with open(output_path, 'wb') as f:
 writer.write(f)
 except Exception as e:
 print(f" ❌ Failed to save optimized PDF: {e}")


def process_file(file_path: Path, output_dir: Path) -> None:
 """Process a single file (image or PDF) and save optimized versions."""
 print(f"\n📄 Processing: {file_path.name}")

 try:
 file_size = image_path.stat().st_size
 file_size = file_path.stat().st_size
 print(f" 📊 Original size: {format_size(file_size)}")

 with Image.open(image_path) as img:
 file_ext = file_path.suffix.lower()

 # Handle PDF files
 if file_ext == '.pdf':
 print(f" 🏷️ Format: PDF")
 results: List[OptimizationResult] = []

 if result := test_pdf_optimization(file_path, file_size):
 results.append(result)

 if not results:
 print(" ℹ️ No optimization opportunities found")
 return

 # Show results
 print(" 💡 Optimization opportunities:")
 for i, result in enumerate(results, 1):
 print(f" {i}. {result.method}: "
 f"{format_size(result.savings)} saved "
 f"({result.savings_percent:.1f}%) "
 f"→ {format_size(result.optimized_size)}")

 # Save optimized PDF
 best_result = results[0]
 if best_result.savings >= 4096: # 4KB threshold
 output_path = output_dir / f"{file_path.stem}_optimized.pdf"
 save_optimized_pdf(file_path, output_path)
 print(f" ✅ Saved optimized version: {output_path.name}")
 print(f" 🎯 Savings: {format_size(best_result.savings)} "
 f"({best_result.savings_percent:.1f}%)")
 else:
 print(f" ⚠️ Savings ({format_size(best_result.savings)}) "
 f"below 4KB threshold")
 return

 # Handle image files
 with Image.open(file_path) as img:
 img.load() # type: ignore
 fmt = (img.format or image_path.suffix[1:]).lower()
 fmt = (img.format or file_path.suffix[1:]).lower()
 print(f" 🏷️ Format: {fmt.upper()}, Mode: {img.mode}, Size: {img.size}")

 results: List[OptimizationResult] = []
Expand DownExpand Up@@ -145,13 +230,13 @@ def process_image(image_path: Path, output_dir: Path) -> None:
 # Save the best optimization
 best_result = max(results, key=lambda r: r.savings)
 if best_result.savings >= 4096: # 4KB threshold
 stem = image_path.stem
 stem = file_path.stem
 if best_result.method == "HEIC":
 output_path = output_dir / f"{stem}_optimized.heic"
 elif best_result.method.startswith("minified_"):
 output_path = output_dir / f"{stem}_optimized{image_path.suffix}"
 output_path = output_dir / f"{stem}_optimized{file_path.suffix}"
 else:
 output_path = output_dir / f"{stem}_optimized{image_path.suffix}"
 output_path = output_dir / f"{stem}_optimized{file_path.suffix}"

 save_optimized_image(img, output_path, best_result.method)
 print(f" ✅ Saved optimized version: {output_path.name}")
Expand All@@ -162,18 +247,18 @@ def process_image(image_path: Path, output_dir: Path) -> None:
 f"below 4KB threshold")

 except Exception as e:
 print(f" ❌ Failed to process image: {e}")
 print(f" ❌ Failed to process file: {e}")


def main():
 """Main function."""
 if len(sys.argv) != 2:
 print("Usage: python test_image_optimization.py <directory_or_image_path>")
 print("Usage: python test_image_optimization.py <directory_or_file_path>")
 print("\nThis script will:")
 print("- Analyze images for optimization opportunities")
 print("- Analyze images and PDFs for optimization opportunities")
 print("- Save optimized versions with '_optimized' suffix")
 print("- Show before/after file sizes and savings")
 print("- Allow you to visually compare original vs optimized")
 print("- Allow you to compare original vs optimized files")
 sys.exit(1)

 input_path = Path(sys.argv[1])
Expand All@@ -183,35 +268,35 @@ def main():
 sys.exit(1)

 # Collect image files
 image_extensions = {'.png', '.jpg', '.jpeg', '.heif', '.heic'}
 image_extensions = {'.png', '.jpg', '.jpeg', '.heif', '.heic', '.pdf'}

 if input_path.is_file():
 if input_path.suffix.lower() not in image_extensions:
 print(f"❌ Not a supported image file: {input_path}")
 print(f"❌ Not a supported file: {input_path}")
 sys.exit(1)
image_files = [input_path]
files = [input_path]
 output_dir = input_path.parent
 else:
image_files: List[Path] = []
files: List[Path] = []
 for ext in image_extensions:
image_files.extend(input_path.glob(f"*{ext}"))
image_files.extend(input_path.glob(f"*{ext.upper()}"))
files.extend(input_path.glob(f"*{ext}"))
files.extend(input_path.glob(f"*{ext.upper()}"))

 if not image_files:
 print(f"❌ No supported image files found in: {input_path}")
 if not files:
 print(f"❌ No supported files found in: {input_path}")
 sys.exit(1)
 output_dir = input_path

 print(f"🔍 Found {len(image_files)} image(s) to process")
 print(f"🔍 Found {len(files)} file(s) to process")
 print(f"📁 Output directory: {output_dir}")

 # Process each image
 for image_file in sorted(image_files):
process_image(image_file, output_dir)
 # Process each file
 for file in sorted(files):
process_file(file, output_dir)

 print(f"\n✨ Processing complete!")
 print(f"📂 Check {output_dir} for optimized images with '_optimized' suffix")
 print("👀 Open original and optimized images side-by-side to compare quality")
 print(f"📂 Check {output_dir} for optimized files with '_optimized' suffix")
 print("👀 Open original and optimized files side-by-side to compare quality")


if __name__ == "__main__":
Expand Down

35 changes: 32 additions & 3 deletions
src/launchpad/size/insights/apple/image_optimization.py

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -11,6 +11,7 @@
import pillow_heif # type: ignore

from PIL import Image
from pypdf import PdfReader, PdfWriter

from launchpad.size.insights.insight import Insight, InsightsInput
from launchpad.size.models.common import FileInfo
Expand DownExpand Up@@ -38,7 +39,7 @@ class _OptimizationResult:
class ImageOptimizationInsight(Insight[ImageOptimizationInsightResult]):
 """Analyse image optimisation opportunities in iOS apps."""

 OPTIMIZABLE_FORMATS = {"png", "jpg", "jpeg", "heif", "heic"}
 OPTIMIZABLE_FORMATS = {"png", "jpg", "jpeg", "heif", "heic", "pdf"}
 MIN_SAVINGS_THRESHOLD = 4096
 TARGET_JPEG_QUALITY = 85
 TARGET_HEIC_QUALITY = 85
Expand DownExpand Up@@ -104,8 +105,16 @@ def _analyze_image_optimization(
 if res := self._check_heic_minification(img, file_size):
 minify_savings, minified_size = res.savings, res.optimized_size
 except Exception as exc:
 logger.error("Failed to process %s: %s", display_path, exc)
 return None
 if file_type.lower() == "pdf":
 try:
 if res := self._check_pdf_optimization(full_path, file_size):
 minify_savings, minified_size = res.savings, res.optimized_size
 except Exception as pdf_exc:
 logger.error("Failed to process PDF %s: %s", display_path, pdf_exc)
 return None
 else:
 logger.error("Failed to process %s: %s", display_path, exc)
 return None

 if max(minify_savings, conversion_savings) < self.MIN_SAVINGS_THRESHOLD:
 return None
Expand DownExpand Up@@ -154,6 +163,26 @@ def _check_heic_minification(self, img: Image.Image, file_size: int) -> _Optimiz
 logger.error("HEIC minification check failed: %s", exc)
 return None

 def _check_pdf_optimization(self, file_path: Path, file_size: int) -> _OptimizationResult | None:
 try:
 reader = PdfReader(file_path)
 writer = PdfWriter()

 for page in reader.pages:
 page.compress_content_streams(level=9)
 writer.add_page(page)

 writer.compress_identical_objects(remove_identicals=True, remove_orphans=True)

 with io.BytesIO() as buf:
 writer.write(buf)
 new_size = buf.tell()

 return _OptimizationResult(file_size - new_size, new_size) if new_size < file_size else None
 except Exception as exc:
 logger.error("PDF optimization check failed: %s", exc)
 return None

 def _iter_optimizable_files(self, files: Sequence[FileInfo]) -> Iterable[FileInfo]:
 for fi in files:
 if fi.file_type == "car":
Expand Down
Loading