Integrating the Podlove Subscribe Button

A while ago we have released the Podlove Subscribe Button. Hundreds of podcasts and some podcast directories have integrated the button in their web site and reception has been generally good.

We have done some improvements under the hood but as the button in centrally hosted, each button out there automatically gets upgraded to the latest list of apps and cloud services.

If you find something that does not work, please report it to us so we can fix it.

New PSB plugin for WordPress

Integrating the button in your web site is easy, but it can never get easy enough. In Podlove Publisher, we have included a WordPress widget called “Podlove Publisher Subscribe Button” that you can use to put a PSB in your sidebar announcing your podcast. Using a WordPress shortcode you can put a button in pages and articles too.

But what if you are using WordPress but not the Podlove Publisher? Or what if you want to provide a list of buttons for other or related podcasts? Well, we have you covered too as we have just released a separate WordPress plugin where you can set up your own buttons as easy.

If you install the plugin, you can set up your buttons in settings and then use a separate WordPress widget (or shortcode) to place your buttons whereever you want. So no need for HTML wizardry or Podlove Publisher to simply include the button.

Advanced activation schemes

People have also asked how they can activate the button using a simple link. It is possible too. Just refer to our technical document too see how to create proper links and also how to customise the colors of the button if you wish to do so.

Future versions of the button will make customization much easier and all those options will of course be rolled into the plugin too.

Podlove Analytics

With little fanfare we released Podlove Publisher 2 a few weeks ago. While major version numbers usually bring a lot to brag about we kept it quiet because we wanted to be ready to adjust bugs that could have stemmed from a huge new feature: Podlove Analytics.

But it all worked so we should talk about it. Podlove Analytics brings you statistics about your podcast you always wanted. There is still work to be done so we have just started with what everybody was desperately looking for in the first place: download statistics.

Actually, we have brought tracking of download to Podlove Publisher a while ago. It silently sneaked in your Expert Settings and those who found it and enabled it have already started to collect information. With Podlove Publisher 2 you can now visualise the data in your blog.


How to activate Analytics

In your admin interface, go to “Podlove -> Expert Settings -> Tracking” and enable the “Tracking URL Parameters & Analytics” setting. The day you switch that on, Podlove will start collecting information about downloads.

When tracking is enabled, you get a new menu called “Podlove -> Analytics”. After a day or so, you will get the first results and can start exploring how your podcast is downloaded.

Download Intents

What we actually track is something we call “Download Intents”. Podlove Publisher does not manage media file delivery so we do not have access to actual download log files. But when tracking is enabled, download links are routed via a redirect mechanism that starts counting when a client wants to access the file. This mechanism seems to work much better than we expected.

So while the user interface simply calls it “downloads”, it’s actually “download intents”. But our tests show that this seems to be in line with reality.

Interactive Visualizer

Right now, you can dive into download statistics for each episode. You look at the total downloads over time but you can also break it down by operating system, client used, download source (download via feed, web player or direct download), download context (which feed, which page etc.) or episode asset.

Please play around with the options and let us know what you find useful and interesting an in what way you want this to evolve.

Future Development

In the future, we will add geo information (which already gets collected) and we will further enhance the way you can break down numbers, compare averages, detect exceptions and how clients will be detected.

In addition to download statistics we will also tackle feed subscription statistics. This still needs some work as we need to research realities with feed proxys and statistics services (like FeedBurner or FeedPress) but it’s definitely on our list.

The Podlove Community and support

At Podlove, we use GitHub issue pages for bug reports and in the last years there have been a lot of helpful feedback. We have also received a lot of support questions which was fine.

But in order to get to a more sustainable model for support we have recently opened the Podlove Community web site. This is the place where you can not only get in touch with developers but with all the other Podlove users too. So it should be your first address for posting questions, finding answers, sharing solutions, workflows and templates too.


There are categories for all major Podlove projects and we are also posting information about major releases there too so you can discuss and ask questions about it right there.

We hope you all join the Podlove Community and make it an ever better place to share your experiences. We closely follow the discussions and use the feedback to further improve our software and standards.

Get ready for Podlove Publisher 2.1

After having spent many releases in the 1.x version branch we are changing the way we release features since version 2 of the Podlove Publisher.

In the future, we will release in a more focused way, adding new features only in 2.x releases and let 2.x.x versions provide bug fixes only. It should have been like this all the time but that’s just how life works, right?

So now version 2.1 is around the corner and one of the big news is that it’s coming with extensive support for WordPress Networks (also called multisite installations). We add some new stuff but we are also going to move some existing features to the network level making them more useful in the future.

Necessary incompatible changes for templates

The first and most obvious candidate for networks are Podlove Templates: Publisher 2.1 allows you to install site-wide templates and use them in every single podcast within the same WordPress Network. This should make it much easier to maintain a general feature set and/or look.

But be prepared: we needed to make a backward incompatible change to how Podlove Templates integrate with WordPress’ shortcode system.

If you call templates via [podlove-template template="my-template" arg1="foo" arg2="bar"] then the system passed the arguments as twig variables arg1 and arg2 to the called template.

However, with Publisher 2.1 these variables will be renamed to option.arg1 and option.arg2 respectively so you will need to change your own templates as they might stop working properly once updated to the new version of the Publisher.

All internal templates are of course automatically adjusted so you need to be aware only if you have created your own templates with parameters. If you don’t yet use these, nothing will haunt your sleep. If you do, please make sure to apply proper changes right after having updated.

Template name changes

In order to be compatible and side-effect free when you also install the new Podlove Subscribe Button plugin, we have renamed the shortcodes for displaying the Subscribe Button within Podlove Publisher.

What used to be called [podlove-subscribe-button] is now [podlove-podcast-subscribe-button] for consistency. The dashboard will tell you that but we thought it might be worth noting up front.

We apologise for the inconveniences. We hope the new release will otherwise entertain you and make you happy.

Introducing the Podlove Subscribe Button

The Podlove Subscribe Button — One button to subscribe them all

Podcasts are becoming more and more popular for many reasons – the subscription model being one of the more important ones. Automatic downloads make podcast content easy to access and flexible to use and create an important bond between creators and the audience.

However, to actually subscribe to a podcast has proven to be a confusing and error prone task. No more: because today, we are going to change all this with the introduction of the Podlove Subscribe Button.

The idea is simple: present one simple button that makes selecting a podcast feed and passing it along to your favourite podcast app (either on your computer, mobile phone or in the cloud) a no-brainer. To subscribe, your audience just clicks the Podlove Subscribe Button, selects an app and there is (usually) no step three.

One button to subscribe them all

Okay, so we say it’s simple. Let us walk you through this to prove our point.

On the podcast website, you see the Podlove Subscribe Button somewhere. We use the established term “subscribe” and the well-known generic Podcast logo (once popularised by Apple) to make clear this button is all about subscribing to a podcast and not to be confused with blog subscription which is a totally different thing for the user (although being technically similar).

That’s how the button looks up-close. Please note, the button comes in various sizes to be able to fit various contexts in web sites. We like the big smashy version that combines with podcast cover best:


Once you activate the button by clicking it, it displays a summary of what you are about to do. We do this to ensure you know what you are going to subscribe to. This is how this looks on an iPhone 5:


When you select “choose app” the button automatically detects the OS you are using and presents a list of well-known apps for that particular platform.


In this example, we choose to open the podcast in the Castro app for iOS which brings up the app’s subscription dialog window. Here you can review your decision once more and proceed to actually subscribe to the podcast (or cancel the process). Please note that some apps just go straight to subscribing to the podcast without asking. This depends on the App and can’t be influenced by us.


What if launching failed or if the app is not yet installed? Well, then you get some strange OS-dependent error, but the Podlove Subscribe Button still has you covered: you can retry or just proceed to the primary location to download/install/buy these chosen app (or go back and choose a different one).


Alternatively, you can change to the “Cloud” tab and get a list of web-based services where you can log in with your account and subscribe to the podcast there. This means you can actually subscribe to a podcast even if you are not using your or your primary podcast device.


In the rare case that you use an app that is not yet supported by the Subscribe Button, you can also choose “other app” and copy the usual feed URL that you can then manually transfer to the application. This is somehow still the tedious old way of doing it but at least there is a defined way how to present the URL to the user.


The button has been translated in many languages already and we will provide as many translations as the community is willing to contribute.

The button is hosted by Podlove and will silently be updated to accommodate for new or updated apps and services. Podcasters simply have to set up the button once and they’re set. When new podcasts app surface: we will include it. If new platforms become important: we will support it. When things break and change: we will take care of it.

Supported apps

As of today, the following apps and cloud backends are actively supported by the Podlove Subscribe Button (with more to follow):

Working with the developers

Behind the scenes we have been reaching out to almost every podcast app developer on every popular computing platform. We have pushed for simple changes to their apps (while many have been compatible from the start) and we have seen many small updates in the recent months to prepare for the launch of the Podlove Subscribe Button.

While we cover most of the current podcast app ecosphere, we are going to add new apps and services as long as they are compatible with the Podlove Subscribe Button. If you are a developer and your app is missing, please review our technical guidelines and contact us.

We provide extensive documentation on how to properly integrate with the Subscribe Button and there is also a fancy testing page to make sure your integration works the way it should.

Loose ends and future plans

Currently, the Podlove Subscribe Button only supports audio podcasts but we will extend it so that you can actually subscribe to video (and even ebook) podcasts as well soon.

We are also thinking about how to support explicit selection of specific formats (like MPEG-4 AAC, MP3, Vorbis, Opus) or feed variants (high and low quality versions etc.). Right now, we automatically choose the right format for you which should serve most customers properly.

There are some issues with new podcast websites that (understandably) go https-only as many podcast apps have problems dealing with podcast feeds via https properly and/or have just trouble subscribing to them once the Subscribe Button presents an actual https URL to them.

We are also working on a solution to make the button blend in more friendly in your web site design so that colours can be easily customised.

Podlove Publisher 2: phasing out PHP 5.3

As of today, PHP 5.3 has reached “end of life” status with the release of version 5.3.29 which means that the PHP community will no longer bring out any updates and wants everybody to move to either version 5.4 or – even better – 5.5. This also means no more bugs and/or security issues will get fixed.

Therefore we have decided to move on with Podlove Publisher and require PHP 5.4 starting with the next major release (2.0) which might be ready in a few weeks from now. This also allows us to use some nice new language features in 5.4 for upcoming features of the Publisher.

We know that there are quite a few web hosters out there who neither care much about security nor regular feature upgrades. Locked in a “legacy world”, these companies do not provide timely updates and are unable to provide you with a modern foundation for your web applications. Just to be clear: PHP 5.3 is now FIVE YEARS OLD. On the Internet, this means ancient. If your hosting company can’t help you, leave them asap as they are not worthy of the name “host”.

Even the initial release of PHP 5.4 is now two and a half years ago and that version will be phased out in a year from now (as it stands today, March 2015). Expect us to require PHP 5.5 then and we will probably continue to dump outdated versions quickly in the future.

Podlove Publisher 2 will also be a change in how we orchestrate and choose version numbers. Don’t expect version 2 to be a huge change: it’s going to be as incremental as recent releases in the 1.x chain have been. But we are going to drop the “alpha” in the version string once and for all as for sure have left the alpha stage and are even beyond beta right now.

Major release number will then increase more often than before, denoting significant feature upgrades while “x.y” releases will be more about a reorganisation of these features and “x.y.z” releases mostly about bug fixes.

Finally, we’d like to encourage you to upgrade often. We know we didn’t manage to make the upgrade process flawless in all cases but we have always responded as fast as we can when things were messed up. We think everyone who has asked for help using GitHub issues can tell that we care a lot about system stability and compatibility and try to be as responsive as possible. Please use this path for any bug reports and feature requests. It really helps.

Podlove @ re:publica 2014

At re:publica 2014, project founder Tim Pritlove gave a talk on Podlove, the project’s recent achievements and future directions. It’s a good summary of how we think about Podcasting and what we think the podcasting infrastructure should evolve into: The Podlove Matrix.

We get by with a little help from our friends

Podlove is an open source project and is creating truly free software (under the MIT license) to be used by anybody. And in the last two years we have come a long way.

The team has grown step by step and the software has been improving steadily. The most recent release of the Podlove Publisher has delivered a ton of enhancements and we are still not running out of ideas on how to improve and solidify the system to be even more versatile.

Last year we started our first round of crowd funding to get the financial support we need to keep our core developer Eric away from boring jobs (he spent around two days a week on Podlove and wants to continue to do so this year) and to fund the infrastructure, other expenses and travel costs needed for the rest of the team.

This has worked out really great: in the last year we collected around 10.000 EUR which was more or less exactly what we needed. But now the funds are mostly used up so we’d like to ask you for your continued financial support of our project to be able to proceed with our quest and deliver even more cool stuff during 2014.

Our Agenda

Release 1.10 of the Podlove Publisher has already brought a long list of improvements and bug fixes featuring the amazing new programmable templates that will make setup and customisation of your podcast site much, much easier than before.

So what’s next? It’s always difficult to make promises and define roadmaps but we have a good grasp of what kind of problems we’d like to tackle. So here is what we like to do in the near future.

Top of the list is the need for viable statistics. We are planning to come up with a complete tracking framework with beautiful download statistics in the admin interface. And we also want to provide the necessary glue for detailed statistics on the server side by third-party scripts like Pentastats (or other log file consuming monsters) by associating URLs with episodes. We have thought about this a lot and we think we have an approach that can workand that you will all like.

Another top priority is the Podlove Web Player. This baby hasn’t been upgraded a lot recently but we are now making good progress as we have spent a lot of time on mockups, UI scenarios, discussing timeline metadata and refactoring the code. We are planning big changes to the player to make it more flexible, more reliable, much nicer to look at and enriched with great metadata that will once more redefine how podcasts are published and consumed on the web.

We also have plans to make the overall system much easier to set up (adding some initial wizardry for first time users), make migration from other podcast installations easier (including migrating by reading a podcast feed), track internal errors and configuration mixups and to improve both the user experience and the documentation significantly. We are also planning to translate the user interface to many other languages once we feel we have stabilised the overall UI.

And that’s just the work we’d like to put into the Podlove Publisher and the Podlove Web Player. There are some other ambitious experiments in preparation that we’re going to talk in the future (“when it’s ready”) and that even address areas beyond podcasting.

Until then, thanks for your support. The podcasting community has supported us in a way an open source project can only dream of. We hope you will be pleased with our results.

Donate to Podlove

Podlove Publisher 1.10

After a series of significant but officially “minor” releases in the 1.9.x branch we are proud to announce that version 1.10 of the Podlove Publisher has seen the light of day and while the release notes might not strike you as particular revolutionary, it has been one of the most effortful and sophisticated updates yet.

Let us introduce you to the new features we have baked for you.

New template system

At the center of this release is a completely reworked template system. Podlove Templates are made to create well-defined automated appearances for episode postings and pages but their capabilities have been limited so far as they were just static blocks of code that were able to insert information here and there.

No more: we have now integrated the Twig template engine into the Publisher. This enables much more complex templates than before as we are also exposing the podcast’s metadata via an internal API to the template system. You can iterate over internal data structures and optionally include or exclude information depending on other values! It is really, really flexible.

We have also replaced all internal code for generating lists and other things invoked by our internal shortcodes with the new template language. So we are eating our own dog food here to make sure the new API makes sense to everyone.

Advanced users should be able to come up with new styles of lists and overviews for their podcast content to accommodate their needs. Templates can be shared with other users so we are expecting a vivid exchange of nice templates among podcasters. Let us know if you have made a nice template that others might be interested in!

Along with the new template system come a lot new shortcodes that you can you use to create overview pages. [podlove-feed-list] creates a list of all your podcast feeds and [podlove-episode-list] generates an archive page of all episodes for you. Similarly [podlove-podcast-contributor-list] lists all the people behind a podcast. There is more to explore. Read more about it in the template documentation.

Other changes

One of the more visible changes is the new input method for social media accounts and donation buttons. You can now create a list of accounts and change the order among them. We have significantly extended the list of supported social networks, contact addresses and creative platforms and you can even add multiple accounts per network (if you like).

Social media accounts and donation information can also be applied at podcast level in addition to contributors alone. This allows a more logical specification of meta data and together with the new templates, you can make more parts of the website auto-generated including team and donation pages. It’s a treasure hunt.

Turn to the release notes for the full monty. There are a ton of small fixes regarding better usability, clarification of texts, slightly tweaked UI behaviour and other niceties that are usually not worth talking about individually but that make for a much better overall user experience. We like it cosy.

Our Roadmap

We have spent quite a lot of time thinking about our roadmap for the Podlove Publisher. Nothing is set in stone, but we have a plan. For the next releases we have taken aim at few “big” features that many people have been asking for (including ourselves).

A big focus is the Podlove Web Player. It hasn’t seen much love since version 2 but we want to take it to the next level very soon. We are working on a thorough technical and visual redesign that enables fancy stuff like embedding and displaying sophisticated timeline-based metadata. We think some minds will end up being blown.

Then there are statistics. We are going to put a sophisticated statistics framework into the Publisher that will enable both internal and external collection and evaluation of download statistics. More on this once we have made significant progress here. It’s complicated and we don’t know how good our progress will be.

Another huge target is a fancy conflict system that will change how the Publisher will deal with all kinds of errors and external failure to ensure a proper state of the system and a decent way of notifying the administrator of necessary actions. It’s basically voodoo but you will be pleasantly surprised.

Last but not least we want to extend the help system, documentation and the out-of-the-box user experience (with wizards and other magically sparkling thingies) including translating the UI to other languages than English. We feel the overall UI will have stabilized significantly soon so that it might be time to finally do this.

You might think these are worthwhile goals. We tend to agree. However, this all depends on getting our next funding round to work. More on this in the next blog post. Up to this point we want to thank everybody who has contributed financially to this project.


Our core developer Eric has been behind the new template system including all the nice API work. Eric is also in charge of the releases incorporating all the changes brought in by other developers which can be a tedious task sometimes.

Alex has done a lot of housekeeping, bug fixing and enhancing of the system, especially the nice new way of adding social media accounts and donation information, better Bitlove integration and the new feed widget.

Others have helped a lot by sending in bug reports, feature request and actual code too. It’s good to see a community grow. Thanks to everybody who cares about this project. It really helps.