Project

rbitter

0.0
No commit activity in last 3 years
No release in over 3 years
rbitternidev/rbitterHomepageDocumentationSource CodeBug TrackerWiki
Rbitter archives all tweets appeared on user streaming using ActiveRecord. XMLRPC is used to serve archived tweets and useful features
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Popularity
Downloads
26,988
Stars
2
Forks
1
Watchers
2
 Releases
Current version
0.2.4
Total releases
12
First release
2015-03-28
Latest release
2015-10-18
 Development
Primary Language
Ruby
Licenses
MIT
Average date of last 50 commits
2015-06-24
Reverse Dependencies
0

 Dependencies

Development

bundler
~> 1.6
rake
~> 10.0
rspec
~> 3.3

Runtime

activerecord
~> 4.2
json
~> 1.7
mysql2
~> 0.3
ripl
~> 0.7
sqlite3
~> 1.3
twitter
~> 5.15
 Project Readme

Rbitter

Build Status Gem Version Coverage Status

Rbitter is a Twitter streaming client specialized in tweet archiving with remote access via XMLRPC, which is written in Ruby.

You can save all tweets appeared on your home timeline and watch them later.

Requirements

Rbitter is tested under MRI, JRuby and Rubinius. So you can choose one of these implementations.

It can run under both Windows and Linux.

Gem dependencies will be installed during installation of this gem.

  • Ruby 1.9.3 or above
  • Sqlite3
  • Mysql(MariaDB)

Configuration

You can simply manipulate default configuration file by:

$ rbitter configure

Put your customized config.json to one of below locations.

  1. ./config.json (current folder)
  2. ./.rbitter/config.json (current folder)

XMLRPC handlers

To get XMLRPC handlers, visit Rbitter XMLRPC.

You can find the document to write your own XMLRPC handler.

Set up and run

With config.json,

  1. Get Twitter token and copy them properly.
  2. Choose preferred ActiveRecord backend.
  3. Modify default location where Twitter images are downloaded.
  4. Configure XMLRPC server
  5. Start by typing:
$ rbitter serve

TODO

  • Streaming Client
    • Saving JSON dump
  • XMLRPC
    • Receiving direct messages

Issue report or feature request

It's recommended to open an issue even it seemed too small. A small flaw may result in instability or bad situation. So every feature requests/bug reports are welcomed.

Please attach stack trace, Ruby version, Rbitter version, and detail description.

If you installed from RubyGems, please report with Git tag. Git tag is your gem version.

Application Versioning

Rbitter follows Sementic Versioning 2.0.

Disclaimer

Rbitter is intended for personal usage. Archived data should not be shared over Internet. Please keep them secure and safe, and protect privacy.

Using sqlite3, please set permission to 0700 so that other users can not read your database file. Using mysql2, please take care of DB access privilege.

Rbitter is not responsible for integrity of data. That is, Some tweets will be dropped accidently due to Twitter API problems or your network problems. The application does its best to recover from those problems. If you find Rbitter couldn't recover even after they're resolved, please make an issue report.