embeddify 0.4.0

Autoplay

Some providers support autoplay. You can use it with the autoplay setting:

embedder = Embedder(autoplay=True)

Normally YouTube wouldn’t support this setting, but the YouTube plugin handles it by rewriting the returned HTML code. This may break if YouTube ever changes the HTML code.

Additional parameters

Some OEmbed providers allow additional parameters. For example Vimeo allows autoplay:

>>> embedder('https://player.vimeo.com/video/6791752', params=dict(autoplay=True))
<iframe src="https://player.vimeo.com/video/6791752?autoplay=1" width="420" height="315" frameborder="0" title="Intro Presentation for the Open Platforms Panel at the Community &amp; Marketing Summit" webkitallowfullscreen mozallowfullscreen allowfullscreen></iframe>

Choosing which plugins to use

If you don’t want all the plugins to be active you can choose which ones you want to use by providing a list of plugins to use like this:

import embeddify
plugins = [embeddify.YouTube(), embeddify.Vimeo()] # only video
embedder = Embedder(plugins = plugins)

Using an oEmbed endpoint

In order to write a plugin for an oEmbed enabled service you need to know it’s endpoint. For instance the YouTube implementation simply looks like this:

from embeddify import OEmbedPlugin

class YouTube(OEmbedPlugin):
    """converts youtube links into embeds
    """

    api_url = "http://www.youtube.com/oembed"

    def test(self, parts):
        """test if the plugin is able to convert that link"""
        return "youtube.com" in parts.netloc

So you simply need to put in the URL of the endpoint and a test() method. This gets the result of the urlparse.urlparse() call as input and usually simply checks the netloc attribute for the right domain. If it returns False the next plugin will be tried, if it returns True the endpoint will be called and in case that call was successful, the embed code will be returned. Otherwise again the next plugin will be tried.

Using a plain plugin

If there is no oEmbed endpoint available or you want to create a plugin without an external call, you can derive from the Plugin class like so:

from embeddify import Plugin

class ExamplePlugin(Plugin):

    default = {
        'width' : 200,
        'height' : 300,
    }

    def __call__(self, parts, config = {}):
        if "example.org" in parts.netloc:
            return """<iframe src="something" width="%(width)s"></iframe>""" %config['width']
        return None

Again you get the results of urlparse.urlparse() passed into the plugin as well as a config dictionary. You then have to test whether your plugin knows about this service and if you do, just return a string with the embed code. If your plugin is not responsible or something else went wrong, simply return None. Then the next plugin will be tried.

In order to accept configuration, simply create a default dictionary in the class. This will be copied to your config and updated with plugin specific configuration and call by call configuration and then passed in as config parameter. So you shouldn’t have to do any modifications on it, just make sure you provide some default value.

0.4.0 (2025-06-17)

• Support Python 3.13 by using html.escape instead of deprecated cgi.escape [fschulze]

• Drop FacebookVideos from standard plugins, as it doesn’t work anymore as it is. It would require an access token and different URL. [fschulze]

• Add TikTok support [2silver]

0.3.1 (2017-08-28)

• Fix for unicode in markup for Python 2.7 [fschulze]

0.3.0 (2017-07-31)

• Support autoplay setting and add a workaround in the YouTube plugin [fschulze]

• Allow sending of additional parameters via params keyword [fschulze]

• Don’t let calling Embedder with keywords overwrite the plugin configuration [fschulze]

• The dictionary with raw OEmbed data can by accessed via the data attribute of the result if it comes from an OEmbed plugin [fschulze]

• Python 3.x compatibility [fschulze]

0.2.0 (2016-11-21)

• support youtu.be links [fschulze]

• support facebook.com videos [fschulze]

• use https endpoints for all services [fschulze]

• changed flickr oembed to return a linked image instead of just an image. [mrtopf]

• added class flickr-embed-img to flickr image for better styling [mrtopf]

• split __call__() on plugins into two methods, do_request() for performing the actual request and __call__() will do the actual processing [mrtopf]

0.1.1 (2016-10-27)

• fix tests and packaging

0.1.0.2 (2014-03-30)

• fixed tests

0.1.0.1 (2013-06-20)

• initial release