Introduction | Requirements | Downloads | Instructions | Version history | License | About | Forums

Introduction

ar.icio.us is a PHP script that allows different sorting methods for your del.icio.us RSS feeds.

I was pleased to discover del.icio.us as a way to have my bookmarks accessible from anywhere through RSS feeds. Especially with Mozilla Firefox's support for Live Bookmarks.

Unfortunately, I got a little bit disappointed when I saw that del.icio.us had only one sorting method for the bookmarks (by date, most recent first).

I wrote ar.icio.us,
so I could change this...

... into this.
live bookmarks unsorted live bookmarks sorted

Instead of linking to a del.icio.us feed, you can link to ar.icio.us. The script connects to del.icio.us with your user account, fetch the bookmarks, sort them and send them to you as an RSS feed.

ar.icio.us uses a cache directory to store your bookmarks so that they are not fully downloaded from del.icio.us each time you make a request. The cache is automatically refreshed if you add a bookmark to your del.icio.us collection.

Please note that ar.icio.us is not a public service, like del.icio.us. You have to run your own copy of ar.icio.us on a web server.

Requirements

To use ar.icio.us, you need to have access to a web server supporting PHP 5.

Downloads

Download ar.icio.us here

Instructions

Installation

  • Unzip the archive
  • Edit the www/config.php5 file and set the parameters with the user name and password you use to connect to del.icio.us
  • Upload the files contained in the www folder to your web server

Using ar.icio.us

Add Live Bookmarks in Firefox using the following URL:
http://your.server.com/ar.icio.us.folder/?tag=your_tag&sort=your_sort_criteria

Replace your.server.com with your server name and ar.icio.us.folder with the folder you uploaded the files to.

Replace your_tag with the del.icio.us tag you want to list, and your_sort_criteria with the sorting method you wish.

Allowed sort criteria are:

  • description (the name of the bookmark)
  • time (the creation date of the bookmark)
  • href (the URL)
  • others (the number of users who have posted that bookmark)
  • tag
  • hash

The sort parameter is optional. The default value is description.

Version history

2005-10-12 - version 0.1

  • First public release

License

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

See the GNU General Public License for more details.

About

ar.icio.us was written in PHP 5 using SciTE editor.

It uses the del.icio.us API to get the bookmarks then an XSLT stylesheet to sort them and convert the data to an RSS feed.

The name of this script is a lame phonetic mix of "RSS" and "del.icio.us".

ar.icio.us is part of the Wistinga Projects.