Merge and compress PDFs in the browser with pdf-lib and PDF.js (no server, no upload)

iLovePDFe — Sat, 31 Oct 2026 23:46:22 +0000

Most "free PDF tools" upload your file to a server, process it, and send it back. For a contract, a bank statement or a scanned ID, that is a real privacy cost, and it isn't necessary. Modern browsers can do most everyday PDF jobs locally.

In this post I'll show the two operations people ask for most, merge and compress, using two libraries:

pdf-lib to create and modify PDF documents.
PDF.js (Mozilla) to render pages to a canvas.

No backend, no build step. Plain <script> tags work.

Setup

<input type="file" id="files" accept="application/pdf" multiple>
<button id="merge">Merge</button>

<script src="https://unpkg.com/pdf-lib@1.17.1/dist/pdf-lib.min.js"></script>

1. Merging PDFs

Merging is the easy one. You load each file, copy its pages into a new document, and save.

const { PDFDocument } = PDFLib;

async function mergePdfs(files) {
  const out = await PDFDocument.create();

  for (const file of files) {
    const bytes = await file.arrayBuffer();
    const src = await PDFDocument.load(bytes, { ignoreEncryption: false });
    const pages = await out.copyPages(src, src.getPageIndices());
    pages.forEach((p) => out.addPage(p));
  }

  // Object streams pack many small objects together and often save 5–15%.
  return out.save({ useObjectStreams: true });
}

document.getElementById('merge').onclick = async () => {
  const files = [...document.getElementById('files').files];
  const bytes = await mergePdfs(files);
  download(bytes, 'merged.pdf');
};

function download(bytes, name) {
  const url = URL.createObjectURL(new Blob([bytes], { type: 'application/pdf' }));
  const a = Object.assign(document.createElement('a'), { href: url, download: name });
  a.click();
  setTimeout(() => URL.revokeObjectURL(url), 1000);
}

A few things that bite in production:

Encrypted PDFs. PDFDocument.load throws on password-protected files. Catch the error and tell the user which file failed. Don't silently skip it.
Order. input.files keeps selection order on most browsers, but users expect drag-to-reorder. Keep your own array and let them sort it.
Memory. Every file is held in memory as an ArrayBuffer. A few hundred MB is fine on desktop, but on low-end phones you should cap the total size and say so up front.
Forms and bookmarks. copyPages copies page content and annotations, but not the document outline (bookmarks). If users need bookmarks preserved, that's extra work.

2. "Compressing" a PDF: what's actually possible

This is where most tools oversell. A PDF is mostly two things:

Vector content and text. It's already compact, and re-saving barely changes it.
Embedded images, usually scans or photos. This is where the megabytes live.

pdf-lib can re-save a document with object streams (the useObjectStreams flag above). That's lossless, and on text-heavy files it typically saves a few percent. It cannot re-encode images.

To really shrink a scanned PDF you have to rasterize. You render each page to a canvas, encode it as JPEG at a lower quality, and build a new PDF from those images. That is lossy, and it turns selectable text into pixels, so only offer it when the input is image-heavy.

<script src="https://unpkg.com/pdfjs-dist@3.11.174/build/pdf.min.js"></script>
<script>
  pdfjsLib.GlobalWorkerOptions.workerSrc =
    'https://unpkg.com/pdfjs-dist@3.11.174/build/pdf.worker.min.js';
</script>

async function compressByRaster(file, { scale = 1.5, quality = 0.6 } = {}) {
  const data = new Uint8Array(await file.arrayBuffer());
  const src = await pdfjsLib.getDocument({ data }).promise;
  const out = await PDFLib.PDFDocument.create();

  for (let i = 1; i <= src.numPages; i++) {
    const page = await src.getPage(i);
    const viewport = page.getViewport({ scale });

    const canvas = document.createElement('canvas');
    canvas.width = Math.ceil(viewport.width);
    canvas.height = Math.ceil(viewport.height);
    await page.render({ canvasContext: canvas.getContext('2d'), viewport }).promise;

    const blob = await new Promise((r) => canvas.toBlob(r, 'image/jpeg', quality));
    const jpg = await out.embedJpg(await blob.arrayBuffer());

    // Keep the original page size in PDF points, so it prints the same.
    const { width, height } = page.getViewport({ scale: 1 });
    const p = out.addPage([width, height]);
    p.drawImage(jpg, { x: 0, y: 0, width, height });

    page.cleanup();
    canvas.width = canvas.height = 0; // free GPU memory on mobile
  }
  return out.save({ useObjectStreams: true });
}

The two knobs that matter:

Setting	Effect
`scale`	Render resolution. 1.0 ≈ 72 dpi (blurry), 1.5 ≈ 108 dpi (readable), 2.0 ≈ 144 dpi (sharp)
`quality`	JPEG quality 0–1. 0.6 is a good default for scans; below 0.4 text edges get muddy

Always check the result is smaller

Rasterizing a text-only PDF can make it bigger, because a page of vector text is tiny while a JPEG of it isn't. So compare sizes and fall back to the original:

const compressed = await compressByRaster(file);
const result = compressed.byteLength < file.size ? compressed : new Uint8Array(await file.arrayBuffer());

Show the user both sizes ("2.4 MB → 610 KB") so they can decide. A tool that silently returns a larger file loses trust fast.

Performance notes

Render pages one at a time, as above, rather than all at once with Promise.all. Parallel canvases blow up memory on phones.
PDF.js runs parsing in a Web Worker, so the UI stays responsive. Still, show a progress indicator per page.
For 100+ page documents, give users a lower scale preset. Most people compressing a scan want "small enough to email", not archival quality.

Why do it client-side at all?

Privacy: the file never leaves the device, which is the main reason users care.
Cost: no servers processing gigabytes of PDFs.
Speed: there's no upload or download wait, which matters on slow mobile connections.

The trade-off is that heavy jobs like OCR or Office conversion are harder in the browser. For merge, split, rotate, reorder and image-based compression, though, the browser is more than enough.

We use this approach for the merge and compress tools at iLovePDFe, a set of free PDF tools that run in the browser. If you build something similar, I'd love to hear how you handle encrypted files and very large scans.

This article was written with AI assistance.

Why Heat Pumps Are Becoming the Future of Home Heating and Cooling

iLovePDFe — Tue, 30 Jun 2026 15:23:45 +0000

Heat Pumps: A Smarter Way to Heat and Cool Your Home

As homeowners look for more efficient and environmentally friendly ways to manage indoor comfort, heat pumps have become one of the most popular solutions. Unlike traditional heating systems that generate heat by burning fuel or using electric resistance, heat pumps transfer heat from one place to another. This process makes them highly energy-efficient and suitable for both heating and cooling throughout the year.

## How Heat Pumps Work

A heat pump operates by extracting heat from the outside air, ground, or water and moving it indoors during colder months. In warmer months, the system reverses the process, removing heat from inside the home and releasing it outdoors. This dual functionality allows a single system to provide year-round climate control.

Modern heat pumps can continue operating efficiently even in cold climates thanks to advancements in compressor technology and refrigerant management. Many newer models are specifically designed to perform well in sub-zero temperatures.

Main Types of Heat Pumps

Air-Source Heat Pumps

Air-source heat pumps are the most common option for residential properties. They absorb heat from the outdoor air and transfer it inside during winter while functioning like an air conditioner during summer. They are relatively affordable, easy to install, and suitable for many homes.

Ground-Source (Geothermal) Heat Pumps

Ground-source heat pumps use the stable temperature below the earth's surface to provide heating and cooling. Although installation costs are higher because underground loops must be installed, these systems often deliver exceptional energy efficiency and lower operating costs over time.

Water-Source Heat Pumps

Water-source systems extract heat from a nearby lake, pond, or other water source. They can be extremely efficient when an appropriate water source is available, though they are less common than air-source or geothermal systems.

Benefits of Installing a Heat Pump

One of the biggest advantages of heat pumps is their energy efficiency. Since they move heat instead of generating it directly, they can deliver several units of heat for every unit of electricity consumed.

Additional benefits include:

Lower heating and cooling costs.
Reduced greenhouse gas emissions.
Quiet operation.
Improved indoor comfort throughout the year.
Heating and cooling from a single system.
Better humidity control during summer.

Factors to Consider Before Buying

Before selecting a heat pump, homeowners should evaluate several important factors:

Local climate.
Home insulation quality.
Proper system sizing.
Installation quality.
Energy efficiency ratings.
Long-term maintenance requirements.

Professional sizing is particularly important because an oversized or undersized system may reduce efficiency and comfort.

Maintenance Tips

Routine maintenance helps maximize performance and extend the lifespan of a heat pump. Basic maintenance includes cleaning or replacing air filters, keeping outdoor units free of leaves and debris, checking airflow around vents, and scheduling professional inspections annually.

Well-maintained systems typically operate more efficiently and experience fewer unexpected breakdowns.

Is a Heat Pump Right for Your Home?

Heat pumps are an excellent choice for many households seeking lower energy consumption and year-round comfort. While the initial investment may be higher than some conventional heating systems, long-term energy savings and reduced environmental impact often make them a worthwhile investment.

As technology continues to improve, heat pumps are becoming an increasingly practical solution for homeowners in a wide range of climates. Whether replacing an aging heating system or building a new home, a properly selected and professionally installed heat pump can provide reliable, efficient comfort for many years.

DEV Community: iLovePDFe