From 058025cc58aecffdde12d53003b9f4ca7fc526ce Mon Sep 17 00:00:00 2001 From: arnaucode Date: Fri, 12 May 2017 13:59:02 +0200 Subject: [PATCH] readme updated --- README.md | 41 ++++++++++++++++------------------------- 1 file changed, 16 insertions(+), 25 deletions(-) diff --git a/README.md b/README.md index 825aff0..05581a9 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,5 @@ +http://arnaucode.com/echo-botnet/ + # echo-botnet [![Go Report Card](https://goreportcard.com/badge/github.com/arnaucode/echo-botnet)](https://goreportcard.com/report/github.com/arnaucode/echo-botnet) A twitter botnet with autonomous bots replying tweets with pre-configured replies @@ -5,6 +7,13 @@ A twitter botnet with autonomous bots replying tweets with pre-configured replie Echo (Ēkhō): https://en.wikipedia.org/wiki/Echo_(mythology)# +# How it works +- each bot is launched every 35 seconds, so the bot1 is launched at time 0, the bot2 is launched at time 35s, the bot3 is launched at time 1:10 minutes, etc +- the bots are running in parallel +- each bot streams the Twitter API getting the tweets containing one or more keywords configured in the file keywordsConfig.json +- then, the bot randomly gets a reply from the file repliesConfig.json +- after a bot replies a tweet, the bot 'sleeps' 1 minute, to avoid the Twitter API limitation + Needs the files: ``` botsConfig.json --> contains the tokens of the bots @@ -12,34 +21,16 @@ keywordsConfig.json --> contains the keywords to track from Twitter API repliesConfig.json --> contains the replies ``` -Just need to configure: +Just need to configure (deleting the word 'DEMO' from the filenames): ![echo-botnet](https://raw.githubusercontent.com/arnaucode/echo-botnet/master/configurationScreenshot.png "configurationScreenshot") -configuration file example (botsConfig.json): +To run, on the /build directory: ``` -[{ - "title": "account1", - "consumer_key": "xxxxxxxxxxxxx", - "consumer_secret": "xxxxxxxxxxxxx", - "access_token_key": "xxxxxxxxxxxxx", - "access_token_secret": "xxxxxxxxxxxxx" - }, - { - "title": "account2", - "consumer_key": "xxxxxxxxxxxxx", - "consumer_secret": "xxxxxxxxxxxxx", - "access_token_key": "xxxxxxxxxxxxx", - "access_token_secret": "xxxxxxxxxxxxx" - }, - { - "title": "account3", - "consumer_key": "xxxxxxxxxxxxx", - "consumer_secret": "xxxxxxxxxxxxx", - "access_token_key": "xxxxxxxxxxxxx", - "access_token_secret": "xxxxxxxxxxxxx" - } -] - +./echo-botnet +``` +Also, can run from the sources, with the Go compiler installed. On the .go files directory: +``` +go run *.go ```