marchdown/clio

Clio — better Friendfeed backup tool

In Russian (look for English below)

Что это?

Бакапилка вашего френдфида.

Как пользоваться (новый способ!)

Распакуйте куда-нибудь содержимое архива и перейдите в эту папку.

В командной строке:

ruby bin/clio.rb -u (юзернейм) -k (remote key) -f (список фидов для загрузки)

(remote key) — это штука, которую можно получить здесь: http://friendfeed.com/remotekey

Если не указать -f, будет загружаться ваш собственный фид.

Опции (можно посмотреть в справке: ruby bin/clio.rb -h):

-u, --user           Ваш юзернейм
-k, --key            Remote key для логина, берётся с http://friendfeed.com/remotekey
-f, --feeds          Фид(ы) для загрузки, список через запятую: user1,group2,user3 (по умолчанию ваш собственный фид)
-p, --path           Путь для сохранения фидов, по умолчанию папка result, каждый фид будет лежать в <path>/<feed>
-l, --log            Путь для записи логов (по умолчанию STDOUT)
-d, --dates          Флаг для добавления текущей даты в имя папки: <path>/<feed>/<YYYY-MM-DD> (для бакапов по расписанию)
-i, --indexonly      Только проиндексировать (данные уже загружены)
    --depth          Глубина загрузки (количество новых записей); по умолчанию — максимально возможное
    --zip            Упаковать в архив <path>/<feed>-<YYYY-MM-DD>.zip
-h, --help           Display this help message.

Результат.

Всё!

Теперь в папках result/(имя фида) есть файл index.html — просто откройте его в браузере.

• В Firefox работает без проблем.
• Чтобы работало в Opera: поставьте галку opera:config#UserPrefs|AllowFileXMLHttpRequest.
• Чтобы работало в Chrome: нужно запустить браузер с дополнительным параметром командной строки --allow-file-access-from-files.

Другой вариант просмотра архива в Chrome:

ruby bin/server.rb (юзернейм)

Эта команда запустит сервер, на который можно будет зайти по адресу http://localhost:65261/index.html

In English

What is it

Backup tool for your FriendFeed.

How to use it

You will need Ruby v1.9 or newer.

Clone repository or download it to some folder.

Then, in command line (or Terminal):

ruby bin/clio-en.rb -u (username) -k (remote key) -f (list of feeds to load)

(remote key) can be received here: http://friendfeed.com/remotekey

If you'll ommit -f, it will download your own feed.

Options (you can also see them with: ruby bin/clio-en.rb -h):

-u, --user           Your username
-k, --key            Your remote key from http://friendfeed.com/remotekey
-f, --feeds          Feeds to load, comma-separated: user1,group2,user3 (your own feed by default)
-p, --path           Path to store feeds, by default its `result`, with each feed at <path>/<feed>
-l, --log            Path to write logs (STDOUT by default)
-d, --dates          If this flag provided, adds current date to folder name: <path>/<feed>/<YYYY-MM-DD> (useful for scheduled backups)
-i, --indexonly      Index only (data already loaded)
    --depth          Depth of download (how many new entries to download); maximum possible (~10'000) by default
    --zip            Pack into archive <path>/<feed>-<YYYY-MM-DD>.zip
-h, --help           Display this help message.

Result

That's it!

Now in folders like result/(feed name) you'll have index.html — just open it in browser.

• It works seemlessly in Firefox.
• To see it with Opera: check an option opera:config#UserPrefs|AllowFileXMLHttpRequest.
• To see it with Chrome: you should run your browser with --allow-file-access-from-files.

Or, you can run:

ruby bin/server.rb (юзернейм)

And it will start simple server at http://localhost:65261/index.html, available from any browser.

Or, if you'll upload everything on some server, you'll be able to see it (all browser hacks are only for "local" files).

FYI, all your entries are stored in separate JSON files in your feed folder, so, if you are programmer, you can do something useful about it.