tweethog

README

TweetHog - Stream, filter and react to Twitter status updates

This tool provides an easy way to stream, filter and optionally react to tweets based on topic, language and user profile. It is similar to commercial SaaS offerings such as TweetFull, RoboLike or Twitfox. However...

• TweetHog is free, fast and doesn't require setting up a server
• You stay in control of your data and don't need to give access to your Twitter account
• You can improve your Go skills if you choose to adapt it to your specific needs

Installation

Make sure you got the latest version of Go installed on your computer. It can be downloaded for free at https://golang.org/dl/. You might need to install Xcode and agree to its license first on OS X.

Then open a terminal and enter:

go get github.com/lastzero/tweethog/cmd/tweethog

To update it afterwards:

go get -u github.com/lastzero/tweethog/cmd/tweethog

Note: Your PATH, GOPATH and GOROOT environment variables need to be set correctly for go get to work as expected.

Configuration

In order to stream status updates, TweetHog needs access to the Twitter API:

1. Copy config.example.yml to config.yml in the directory you wish to execute the command
2. Create your own Twitter API keys & tokens on https://apps.twitter.com/app/new
3. Put them in config.yml by replacing the placeholders

Hint: You can use the --config-file flag to use a different config file.

Note: Due to an issue with the go-twitter library, you won't see any error when using invalid credentials. We're working on it.

Example Usage

# tweethog -t cat -l en --like
Started streaming Twitter status updates on 2017-10-26 11:51:58...
Topics       : cat
Languages    : en
URLs         : false
Retweets     : false
Replies      : false
Via          : false
Max mentions : 1
Max tags     : 2
Like tweets  : true

ID: 921269579980115969  User: @onthelooseliam  Following: 563  Followers: 825  Likes: 9248
>>> My cat is playing with my bun and I'm terrified
Liked ❤️

Flags

Name	Description
--consumer-key value	Twitter API consumer key
--consumer-secret value	Twitter API consumer secret
--access-token value	Twitter API access token
--access-secret value	Twitter API access token secret
--topic value, -t value	Stream filter topic e.g. cat, dog, fish
--lang value, -l value	Stream filter language e.g. en, de, fr
--min-followers value	User min followers (default: 0)
--max-followers value	User max followers, 0 for unlimited (default: 0)
--min-following value	User min following (default: 0)
--max-following value	User max following, 0 for unlimited (default: 0)
--max-tags value	Max number of hash #tags (default: 0)
--max-mentions value	Max number of @mentions (default: 0)
--retweets	Include tweets starting with RT
--replies	Include tweets starting with @
--via	Include tweets containing via @
--urls	Include tweets containing URLs
--like	Like all matching tweets
--smart-like	Likes tweets with GetRandomInt delay and rate limit
--config-file value, -c value	YAML config filename (default: "config.yml")

All of the flags above (except config-file of course) can be set in the config file as a default. Example:

max-mentions: 1
max-tags: 2
lang: en
urls: true
retweets: false
replies: false
via: false

About

This tool was created by Michael Mayer in an attempt to learn Go the agile way: Start with something small that works and then refactor and improve. You can use it for free and at your own risk under the terms of the MIT license.

Please feel free to send an e-mail if you have any questions or just want to say hello. Contributions are most welcome, even if it's just a bug report or a tiny pull-request to fix a typo.

Documentation

Index

• Constants
• func GetRandomInt(min, max int) int
• type Config
  • func NewConfig() *Config
  • func (config *Config) SetValuesFromCliContext(c *cli.Context) error
  • func (config *Config) SetValuesFromFile(fileName string) error
• type LastAction
• type Status
  • func NewStatus(tweet *twitter.Tweet, stream *Stream) *Status
  • func (status *Status) ContainsUrl() bool
  • func (status *Status) GetCreatedAt() *time.Time
  • func (status *Status) GetFavouritesCount() int
  • func (status *Status) GetFollowersCount() int
  • func (status *Status) GetFriendsCount() int
  • func (status *Status) GetID() int64
  • func (status *Status) GetScreenName() string
  • func (status *Status) GetText() string
  • func (status *Status) Handle()
  • func (status *Status) IsReply() bool
  • func (status *Status) IsRetweet() bool
  • func (status *Status) Like()
  • func (status *Status) SmartLike()
• type Stream
  • func NewStream(config *Config) *Stream
  • func (stream *Stream) GetConfig() *Config
  • func (stream *Stream) Start() error

Constants

const (
	CompactTime = "2006-01-02 15:04:05"
)

Functions

func GetRandomInt

func GetRandomInt(min, max int) int

Types

type Config

type Config struct {
	// API credentials
	ConsumerKey    string
	ConsumerSecret string
	AccessToken    string
	AccessSecret   string

	// YAML config file name
	ConfigFile string

	// Filters
	Topics       []string
	Languages    []string
	MinFollowers int
	MaxFollowers int
	MinFollowing int
	MaxFollowing int
	MaxTags      int
	MaxMentions  int
	Retweets     bool
	Replies      bool
	Via          bool
	URLs         bool

	// Actions
	Like      bool
	SmartLike bool
}

func NewConfig

func NewConfig() *Config

func (*Config) SetValuesFromCliContext

func (config *Config) SetValuesFromCliContext(c *cli.Context) error

func (*Config) SetValuesFromFile

func (config *Config) SetValuesFromFile(fileName string) error

type LastAction

type LastAction struct {
	sync.Mutex
	// contains filtered or unexported fields
}

type Status

type Status struct {
	// contains filtered or unexported fields
}

func NewStatus

func NewStatus(tweet *twitter.Tweet, stream *Stream) *Status

func (*Status) ContainsUrl

func (status *Status) ContainsUrl() bool

func (*Status) GetCreatedAt

func (status *Status) GetCreatedAt() *time.Time

func (*Status) GetFavouritesCount

func (status *Status) GetFavouritesCount() int

func (*Status) GetFollowersCount

func (status *Status) GetFollowersCount() int

func (*Status) GetFriendsCount

func (status *Status) GetFriendsCount() int

func (*Status) GetID

func (status *Status) GetID() int64

func (*Status) GetScreenName

func (status *Status) GetScreenName() string

func (*Status) GetText

func (status *Status) GetText() string

func (*Status) Handle

func (status *Status) Handle()

func (*Status) IsReply

func (status *Status) IsReply() bool

func (*Status) IsRetweet

func (status *Status) IsRetweet() bool

func (*Status) Like

func (status *Status) Like()

func (*Status) SmartLike

func (status *Status) SmartLike()

type Stream

type Stream struct {
	// contains filtered or unexported fields
}

func NewStream

func NewStream(config *Config) *Stream

func (*Stream) GetConfig

func (stream *Stream) GetConfig() *Config

func (*Stream) Start

func (stream *Stream) Start() error