Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

A Python RFC2397 ("data url") implementation

Project Description

Quick implementation of RFC2397 in Python, MIT Licenced. RFC2397 is also known as the ‘data url’ format used to embed image data directly into CSS stylesheets among other things.

The rationale behind this package is described in this blogpost.


Python 2.6 and 2.7, not tested on Python 3+ (yet).


The latest version can be found on PyPI. The recommended way to install is via pip:

$ pip install rfc2397

An executable named rfc2397 is then placed in the python environment that pip installs to.

As an alternate method, it’s also possible to copy the file to any location and run the script stand-alone.


Just give rfc2397 a path to an image file. rfc2397 uses Python’s mimetypes module to determine what MIME-type a file has (N.B: the program won’t stop you from encoding something too large/an unsupported mime-type).

$ rfc2397 dot.png # <- your image path data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAIAAACQd1PeAAAADElEQVQImWP4o8oAAANCASIYayeeAAAAAElFTkSuQmCC


1.0b2 (2012-01-03)

  • Uses mimetypes module instead of primitive ad-hoc file name extension guessing.
  • rfc2397 is now a single-file module, simplifies package and makes it possible to just copy the file to an arbitrary location as an alternate installation method.
  • Better QA by using tox.

1.0b1 (2011-06-16)

Concept and initial coding.

Release History

This version
History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(2.9 kB) Copy SHA256 Hash SHA256
Source None Jan 3, 2012

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers DreamHost DreamHost Log Hosting