tircd - En ligne dans le Cloud

PROGRAMME:

Nom

tircd - Un proxy ircd vers l'API Twitter

DESCRIPTION

tircd présente Twitter comme un canal irc. Vous pouvez vous connecter à tircd avec n'importe quel client irc,
et twitter comme si tu étais sur irc

INSTALLATION

tircd nécessite une version récente de perl, et les modules suivants :

POE

POE::Filtre::IRCD

Net ::Twitter ::Lite ::WithAPIv1_1

JSON : : Tout

Heure::Local

Fichier::Globe

IO::Fichier

LWP : UserAgent

Stockable

URI

Liste ::Util

HTML::Entités

Condensé :: SHA1

Si vous utilisez un système basé sur Redhat ou Debian, essayez d'utiliser les distributions CPAN
packages de modules, dans yum ou apt.

Pour installer tous les modules via CPAN :

cpan -i POE POE::Filtre::IRCD Réseau::Twitter::Lite JSON : : Tout Heure::Local Fichier::Globe IO::Fichier
LWP : UserAgent Stockable URI Liste ::Util HTML::Entités Condensé :: SHA1

UTILISATION

Courir tircd
./tircd.pl [/chemin/vers/tircd.cfg]

Au démarrage, tircd recherchera un fichier de configuration aux emplacements suivants :

tircd.cfg (dans le répertoire courant)

~/.tircd

/etc/tircd.cfg

Vous pouvez spécifier un chemin alternatif vers le fichier de configuration sur la ligne de commande si vous
souhaitez conserver la configuration à un autre emplacement. Il y a un exemple de configuration
fournis dans le cadre de la distribution. La façon la plus simple de commencer est de simplement renommer
ce fichier de tircd.cfg.exemple à tircd.cfg

Connecter les
Par défaut, tircd écoute sur le port localhost 6667.

La première fois que vous vous connectez avec un nouveau compte Twitter, vous devez spécifier un fatigué Mot de passe
pour ce pseudo. Ce mot de passe ne doit pas (et ne doit pas) être le même que votre twitter
le mot de passe. Ce mot de passe protégera votre compte tircd contre toute utilisation non autorisée.

La au dessus de Mot de passe is à protéger votre fatigué compte, et is pas en relation à votre twitter
compte. La fatigué entaille Mot de passe sera uniquement be sauvé une fois vous avons Connecté développement Twitter

Avec de nombreux clients irc, vous pouvez le faire en lançant la commande /SERVER localhost 6667fatigué
mot de passe>twitter nom d'utilisateur>. Vérifiez la documentation de votre client pour le
syntaxe.

Tircd lancera un défi OAuth à Twitter, et Twitter renverra un lien vers une page
où vous pouvez autoriser la connexion. Ce lien apparaîtra dans votre connexion IRC
fenêtre d'état.

Assurez-vous que vous êtes soit connecté à Twitter en tant que compte que vous prévoyez d'utiliser, soit non connecté
dans. Cliquez sur le lien d'autorisation et connectez-vous, puis cliquez sur « Autoriser ». Twitter vous présentera ensuite
avec un code PIN. À complet votre connexion à fatigué, tapez: /Statistiques épingle <PIN NUMÉRO>. Au
certains clients que vous devrez peut-être taper : / devis stats épingle <PIN NUMÉRO>.

Si le code PIN est accepté par Twitter, la connexion sera établie. Vous pouvez maintenant rejoindre
#twitter pour commencer. Si le code PIN n'est pas accepté, un autre lien d'autorisation sera
généré.

Protection par mot de passe du compte
Si votre installation tircd s'exécute dans un environnement partagé (soit en écoutant sur le
localhost sur un ordinateur partagé, ou en écoutant sur une IP publique), vous voudrez peut-être
mot de passe protégez votre compte, ou n'importe qui peut accéder à votre compte twitter connaissant le
l'adresse du serveur et votre nom d'utilisateur Twitter. Votre tircd-mot de passe do ne pas need à be (Et
devrait pas être!) le même as votre twitter mot de passe.

Tircd prend en charge la protection par mot de passe de la manière suivante.

· La première fois que vous vous connectez à tircd avec un nouveau nom d'utilisateur, aucune vérification du mot de passe n'est
terminé. L'URL OAuth vous est présentée et vous devez vous connecter à Twitter sur le
Web et saisissez le code PIN comme décrit ci-dessus.

· Lorsque le code PIN est accepté, SI votre client s'est connecté avec un mot de passe défini, ce
le mot de passe est crypté (haché) et enregistré avec vos jetons d'accès Twitter.

· La prochaine fois que vous vous connecterez, tircd vérifiera d'abord si un mot de passe est enregistré dans
votre Nom d'utilisateur.config, et comparez-le avec celui envoyé par votre client.

· S'ils correspondent, votre connexion est autorisée et tircd continue de vérifier l'OAuth
jetons avec twitter.

· S'ils ne correspondent pas, le client est déconnecté avec un message d'erreur.

· Si vous souhaitez modifier votre mot de passe, ou n'en avez pas défini lors de votre première connexion,
vous pouvez le faire après vous être connecté à tircd avec un simple "/mot de passe STATS
"

· Sachez que si vous faites cela, vous devrez également vous assurer que votre client utilise le
même mot de passe la prochaine fois que vous vous connectez à tircd.

· Si vous souhaitez supprimer le mot de passe, émettez simplement un "/mot de passe STATS" sans aucun
mot de passe défini.

Il n'y a actuellement aucun moyen de récupérer l'accès à votre compte si vous l'oubliez. À
réinitialiser votre mot de passe tircd, vous devrez supprimer votre nom d'utilisateur.config et autoriser
avec twitter en utilisant à nouveau OAuth et un code PIN.

Après de liaison
Une fois connecté "/JOIN #twitter" pour commencer. Le canal #twitter est l'endroit où vous allez
effectuer la plupart des opérations

Mettre à jour votre statut
Pour mettre à jour votre statut sur Twitter, envoyez simplement un message commençant par "!t " au
chaîne #twitter. Le serveur gardera votre mise à jour la plus récente dans le sujet du tout
fois.

Si vous souhaitez que tous les messages que vous envoyez à #twitter soient publiés sous forme de tweets, vous pouvez définir le
l'option de configuration "auto_post" à 1. Soit dans tircd.conf, soit via la commande /stats.
Les messages commençant par un point d'exclamation ("!") seront toujours traités comme
commandes, pas tweeté.

Obtenir le statut de votre ami
Lorsque les utilisateurs que vous suivez mettent à jour leur statut, il sera envoyé à la chaîne sous forme de message
d'eux. Chaque statut sera précédé d'un identifiant de 3 lettres tel que [a7f]. Cette
l'identifiant est utilisé pour retweeter et répondre aux tweets.

Les @réponses sont également envoyées au canal sous forme de messages.

Retweeter un statut
Pour retweeter un statut, utilisez la commande offerbot !retweet suivi du tweet à 3 lettres
identifiant.

!retweeter a7f

Répondre à un statut
Pour répondre à une mise à jour de statut, utilisez la commande offerbot !retweet suivi du 3
lettre tweet identifiant.

!répondre 6eb @tircdbot pas dès aujourd'hui !

Favoriser un tweet
Pour mettre un tweet en favori, utilisez la commande offerbot !favorite suivi du tweet à 3 lettres
identifiant.

!favori a44

Lister les utilisateurs que vous suivez
Chaque utilisateur que vous suivez sera dans le canal #twitter. Si vous suivez un nouvel utilisateur
en dehors de tircd, cet utilisateur rejoindra le canal la première fois qu'il mettra à jour son
statut. Les personnes qui vous suivent reçoivent une voix (+v) pour indiquer ce fait.

Messages directs
Les messages directs qui vous sont adressés apparaîtront comme un message privé de l'utilisateur.

Pour envoyer un message direct, envoyez simplement un message privé à l'utilisateur que vous souhaitez dm.

Obtenir des informations supplémentaires sur les utilisateurs
Vous pouvez /WHO ou /WHOIS un utilisateur pour afficher son emplacement / sa biographie / son site Web. leur dernier
la mise à jour du statut (et l'heure d'envoi) sera également renvoyée.

L'émission d'un /WHOIS sur votre propre nom d'utilisateur fournira également le nombre d'appels d'API qui
ont été utilisés au cours de la dernière heure.

Suivre de nouveaux utilisateurs
Pour commencer à suivre un nouvel utilisateur, il vous suffit de /INVITEZ-le à #twitter. L'utilisateur rejoindra
le canal si la requête à suivre a abouti. Si vous essayez d'inviter un utilisateur
qui protège leurs mises à jour, vous recevrez un avis que vous avez demandé de
suis les. L'utilisateur rejoindra le canal s'il accepte votre demande et met à jour
leur statut.

!inviter est la commande analogue d'offrebot.

Se désabonner/supprimer des utilisateurs
Pour arrêter de suivre un utilisateur, /KICK lui depuis #twitter.

!coup est la commande analogue d'offrebot.

Blocage des utilisateurs
Pour bloquer un utilisateur /BAN les. Il n'y a actuellement aucun moyen d'obtenir une liste des utilisateurs que vous avez
actuellement bloqué via l'API, donc la liste des interdictions dans #twitter ne renverra que les utilisateurs
vous avez bloqué dans la session en cours.

Débloquer des utilisateurs
Pour débloquer un utilisateur / UNBAN leur.

Plusieurs canaux/groupes
Si vous souhaitez créer une chaîne avec juste un sous-ensemble des personnes que vous suivez, vous pouvez
"/REJOINDRE " puis /INVITE les au canal. tircd enverra un utilisateur
mises à jour de #twitter et de tout autre canal auquel vous avez invité un utilisateur.

Rechercher
Si vous souhaitez recevoir des résultats de recherche mis à jour pour un terme spécifique, vous pouvez
"/REJOINDRE " puis définissez le /sujet de la chaîne sur votre requête de recherche.
Les résultats qui correspondent à cette requête seront envoyés à ce canal. Le /TOPIC peut être presque
tout ce qui est pris en charge par la recherche twitter (voir
http://support.twitter.com/articles/71577-how-to-use-advanced-twitter-search
<http://support.twitter.com/articles/71577-how-to-use-advanced-twitter-search> pour
exemples). L'utilisation de l'option « near » n'est actuellement pas prise en charge.

Configuration utilisateur
Certaines options sont modifiables au moment de l'exécution et définies par utilisateur. Pour voir une liste d'options
et leurs valeurs actuelles envoient simplement une commande "/STATS m" au serveur.

Ces options sont enregistrées dans un fichier portant le nom Nom d'utilisateur.config (où le nom d'utilisateur est
votre nom d'utilisateur Twitter) situé dans un répertoire défini dans le fichier de configuration global (par défaut :
/tmp/tricd)

Commandes Offerbot
Tircd prend en charge le contrôle de style Offerbot. Toutes les fonctions disponibles via l'offerbot
sont disponibles car ce sont des fonctions IRC métaphoriquement appropriées. Par conséquent,
le retweet, la réponse à un tweet spécifique et l'enregistrement de la configuration de l'utilisateur sont uniquement
disponible via l'offerbot.

![mettre à jour|up|actualiser] - Met à jour le flux #twitter immédiatement.

![tweet|t] <texte of Tweet> - Affiche le texte donné en tant que mise à jour de votre flux.

![retweeter|rt] <identifiant-tweed> - Publie un retweet. tweet-id est le code à 3 chiffres précédant le
tweet.

![répondre|re] <identifiant du tweet > - Réponses à un tweet. tweet-id est un à 3 chiffres
code précédant le tweet.

![conversation|conversion] <identifiant du tweet> - Rejouez une conversation depuis le début. Si tweet n'est pas
une réponse, affiche les tweets associés.

![ajouter|inviter|suivre] <nom d'utilisateur> - Commencez à suivre le nom d'utilisateur twitter spécifié.

![supprimer|kick|ne plus suivre] <nom d'utilisateur> - Supprimez le nom d'utilisateur de la liste des personnes que vous
compte suit.

!enregistrer - Enregistre immédiatement la configuration spécifique au nom d'utilisateur twitter.

!aider - Affiche ce message d'aide.

Utilisez tircd en ligne en utilisant les services onworks.net