Skip to main content

eps2svg

Python 3.10+ License: MIT PyPI Dependencies: 0 PRs Welcome

Convert Adobe Illustrator EPS files to SVG with real, native gradients — no rasterisation, correct CMYK colours, and clean clip structures.

eps2svg is built for the practical, repeatable task of turning print-ready logo EPS files into future-proof SVG assets for web and app use.

Goal: small, readable SVG code with exact linearGradient definitions and colour values you can trust.

Deutsch / German version


Why this tool exists

Existing converters like pstoedit, pdf2svg, or the built-in SVG export from many graphics programs are unreliable precisely where it matters most. The three recurring failure points are:

  1. Clipping masks vs. gradients
    Many tools lose the correct nesting order or produce placement errors for masks. eps2svg faithfully reproduces the logical hierarchy in SVG.

  2. Gradient stops lie
    Adobe generates gradients with flat areas and non-linear ramps (stitching functions). Many converters incorrectly collapse these to just two stops or raster the gradient entirely. eps2svg uses a robust reduction (Douglas-Peucker) that respects flat zones and sharp knees.

  3. CMYK→RGB conversion is wrong
    Brand colours are often defined in CMYK, but converting them correctly requires colour management. A naive formula distorts them visibly. eps2svg asks Ghostscript itself for the conversion, matching what Acrobat and professional tools display.

This was not designed as a universal EPS parser, but as a practical, predictable tool that gets the common real-world case right.

What is supported

  • Adobe Illustrator EPS (Language Level 2) converted via Ghostscript PDF output
  • Basic vector structures:
    • Paths, fill colours (RGB, Greyscale, CMYK approximation)
    • Native linearGradient (direct mapping in SVG)
    • Clipping masks and path clipping
  • Bounding box via HiResBoundingBox → SVG viewBox

What is not (clearly and honestly)

  • Not a universal EPS solution: unusual compression schemes, special postscript functions, or printer-specific operations may be outside the supported subset.
  • Radial gradients are not currently generated.
  • Heavily nested transparency effects, font substitution (fonts must be converted to outlines), or complex object patterns are not fully supported at this stage.
  • The workflow relies on Ghostscript’s PDF conversion as an intermediate step. This is more stable than direct EPS parsing, but it is not infallible.

Requirements

Python packages: None. eps2svg uses only the standard library.

External system tools (must be installed separately via your OS package manager):

  • Ghostscript (gs) – for EPS → PDF conversion and colour management

Installation:

# Debian/Ubuntu
sudo apt install ghostscript

# macOS (Homebrew)
brew install ghostscript

You can verify the tool is found with eps2svg --check-tools.

Installation

# Ubuntu 24.04+
sudo apt install pipx
pipx ensurepath  # restart shell afterwards

pipx install eps2svg

Into a virtual environment

python3 -m venv .venv
source .venv/bin/activate
pip install eps2svg

From the source repository

git clone https://github.com/JUNGHERZ/eps2svg.git
cd eps2svg
pip install -e .

Quick start

eps2svg input.eps output.svg

Example:

eps2svg logo.eps logo.svg

Expected results:

  • Output contains proper <linearGradient> definitions
  • Colour values are stable (no flicker between renderers)
  • Clip structure is logically layered

Example (real world)

A typical company logo uses CMYK-defined brand colours with a blended gradient. Instead of flattening to two stops and shifting the colours, eps2svg produces clean colour stops, correct masks, and a compact, future-proof SVG.

Current status

  • Small but actively maintained script core.
  • Corrected for key pain points: clipping, gradient retention, CMYK colour fidelity.
  • The aim is to remain practical and reliable rather than broadly compatible with every possible EPS variant.

License

MIT – see LICENSE.

Contributing

Issues, test cases, and small improvements are very welcome. Good pull requests should include one or more real-world EPS samples to demonstrate the fix and ensure it stays locked in.

Metadata

Release files for eps2svg 0.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for eps2svg 0.1.2
File Size Uploaded Provenance Actions
eps2svg-0.1.2.tar.gz 13.7 kB With provenance Details for eps2svg-0.1.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for eps2svg 0.1.2
File Interpreter ABI Platform Actions
eps2svg-0.1.2-py3-none-any.whl Python 3 none any Details for eps2svg-0.1.2-py3-none-any.whl

Total release size: 27.5 kB

Release files / eps2svg-0.1.2.tar.gz

Download URL eps2svg-0.1.2.tar.gz
Size 13.7 kB
Tags Source
SHA-256 checksum
How to use checksums
1980ad09223ff1a99a06ad4dbd6e2a6630167f2ee0c35666d532f7470d4508f1
BLAKE2b-256 checksum
How to use checksums
cdf0cdbffb2d5291b96edee222d7fb352756e640448f3ab57134a1a2f6711cb8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 2, 2026.

Transparency log

Release files / eps2svg-0.1.2-py3-none-any.whl

Download URL eps2svg-0.1.2-py3-none-any.whl
Size 13.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a307d9e99b86cfb6eef613c77a04b604b80db598e30b64593ba70c8d45bc2937
BLAKE2b-256 checksum
How to use checksums
377ca4ea828f6374db80936c831a6f313aa7c08e33fc58e37dec4500cc5e6283
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 2, 2026.

Transparency log

Security for eps2svg 0.1.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for eps2svg-0.1.2.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 2, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.2 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page