'\" t
.\"     Title: tweeper
.\"    Author: [see the "AUTHORS" section]
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\"      Date: 04/24/2014
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "TWEEPER" "1" "04/24/2014" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
tweeper \- web scraper to convert a Twitter timeline to an RSS feed
.SH "SYNOPSIS"
.sp
\fBtweeper\fR [\fIOPTIONS\fR] \fIURL\fR
.SH "DESCRIPTION"
.sp
tweeper(1) is a web scraper which extracts the most recent public tweets of a given user from their home page on Twitter\&.com and formats them in RSS, so the information can be conveniently accessed and collected by a feed reader\&.
.sp
tweeper started as the TWitter fEEd scraPER but support for other web sites has been added\&.
.sp
The sites that tweeper is able to scrape and convert to RSS are:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Twitter\&.com
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Pump\&.io based websites, like Identi\&.ca
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Dilbert\&.com
.RE
.sp
tweeper can be used as:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
a command line tool;
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
a filter for feed readers;
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
a web based tool when PHP support is available in the web server\&.
.RE
.SH "OPTIONS"
.PP
\fB\-e\fR
.RS 4
show links to supported media files in the RSS <enclosure/> element
.RE
.PP
\fB\-h, \-\-help\fR
.RS 4
show the help message
.RE
.SH "EXAMPLE OF USE"
.sp
Getting the RSS feed of some Twitter user:
.sp
.if n \{\
.RS 4
.\}
.nf
tweeper http://twitter\&.com/NSACareers
.fi
.if n \{\
.RE
.\}
.sp
Using tweeper as a filter for the Liferea feed reader:
.sp
.if n \{\
.RS 4
.\}
.nf
liferea\-add\-feed  "|tweeper http://twitter\&.com/NSAcareers"
.fi
.if n \{\
.RE
.\}
.sp
Using tweeper via web (the symlink must be created only the very first time):
.sp
.if n \{\
.RS 4
.\}
.nf
sudo ln \-s /usr/share/php/tweeper/tweeper\&.php /var/www
xdg\-open http://localhost/tweeper\&.php?src_url=http://twitter\&.com/NSAcareers
.fi
.if n \{\
.RE
.\}
.SH "NOTES"
.sp
In order to use tweeper with a symlink with the apache \fIuserdir\fR module, the \fISymLinksIfOwnerMatch\fR option must be replaced by \fIFollowSymlink\fR in /etc/apache2/mods\-enabled/userdir\&.conf
.SH "EXIT STATUS"
.PP
\fB0\fR
.RS 4
Success
.RE
.PP
\fB!0\fR
.RS 4
Failure
.RE
.SH "AUTHORS"
.sp
Antonio Ospite
.SH "RESOURCES"
.sp
Main web site: http://git\&.ao2\&.it/tweeper\&.git
.SH "COPYING"
.sp
Copyright (C) 2013\-2014 Antonio Ospite <ao2@ao2\&.it>
.sp
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 3 of the License, or (at your option) any later version\&.