VroumVroumBlog

VroumVroumBlog 0.2

VroumVroumBlog is an automatic blog software tool used to replicate content from a blog or any site with a RSS or Atom feed. This is a tool used to fight censorship and help blogs to stay online through dozens of mirrors even if they are forced offline (also known as the Streisand effect).

VroumVroumBlog 0.2.x is a complete rewrite of the VroumVroumBlog 0.1.x software from SebSauvage

Its core features are:

  • Very easy to setup: only one file to copy, and another text file to configure
  • Reads ATOM 1.0, RSS 1.0, 2.0 and RDF feeds.
  • Automatic copy of all articles from the source feed to the database
  • Automatic copy of pictures included in articles from the source feed
  • Simple and nice web interface to read the feed
  • RSS 2.0 export of the copied feed
  • Easy to make a farm with multiple source feeds
  • You can download the database and reuse it straight away for a faster spread of information
  • Full-text search inside the articles
  • Translations available and easy to translate to your language
  • Public domain license: copy it, fork it, use it!
  • Open source

It requires:

  • PHP 5.3 or more
  • SQLite3 database for PHP

And it's better than the original because:

  • Readable and modern source code using OOP
  • Only ~900 lines of code
  • No dependency: no Symfony, no Zend, no PEAR, no stupid library, only plain PHP
  • You can configure it to use rewrite-rules to have nice looking URIs
  • Manages also RSS 1.0 / RDF feeds
  • Full-text search!
  • Media search from article content (from HTML links and images) and mirror them
  • New network manager, less likely to wait forever for a dead feed or media
  • And more...

How to install and setup

  1. Download the source file: index.php
  2. Download the sample configuration file: vvb.ini
  3. Edit the vvb.ini file with a text editor and adapt it to your needs (more help on the vvb.ini file)
  4. Copy the index.php and vvb.ini files on your web site in a new empty directory.
  5. The end: you can now go visit your new autoblog.

Troubleshooting: SQLite3

If you host your website by yourself, don't forget to install the sqlite3 php extension. On Debian and Ubuntu it's easy just open a terminal and type:

sudo apt-get install php5-sqlite

Update

Just copy the index.php file from here and replace your old one with the new one.

FAQ: How to translate?

Easy, just download the config.php (this is an example file containing the french translation) file and edit it. Then put it in the same directory as the index.php file.

FAQ: How to get nice URIs?

To get nice URLs like http://autoblog.kd2.org/sebsauvage.net/Oyez-Oyez, you have to create a file named .htaccess in the directory of your autoblog with this content:

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*) /sebsauvage.net/index.php?$1 [QSA,L]

You'll have to change /sebsauvage.net/ with the directory where is located your autoblog.

Then create or edit the config.php in the autoblog directory with this content:

<?php
define('LOCAL_URI', '');
?>

That's all.

FAQ: How to do a farm with multiple feeds?

As always: very easy. Let's imagine that you have created http://bohwaz.net/streisand.me/ to put in there a lot of autoblogs. All you have to do is download the index.php file, rename it to farm.php and upload it in the root directory of your farm.

If you want to have a nice-looking list of all your mirrored blogs, download the list.php file, rename it to index.php and upload it to the same directory.

Then for each blog you'll want to mirror, you'll just have to:

  1. create a new directory in your farm directory, like sebsauvage for instance
  2. upload a vvb.ini file in this directory like for a classic autoblog
  3. in this directory upload a new file named index.php containing this line:

Other forks

There is two known forks of this software: