{"id":13515043,"url":"https://github.com/cbrgm/go-t","last_synced_at":"2025-03-31T04:36:22.920Z","repository":{"id":57568688,"uuid":"163443629","full_name":"cbrgm/go-t","owner":"cbrgm","description":"A blazing-fast, simple and easy to use command-line client for Twitter written in Go. 🚀📨","archived":true,"fork":false,"pushed_at":"2018-12-30T21:15:10.000Z","size":3967,"stargazers_count":70,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-28T20:41:31.039Z","etag":null,"topics":["cli","command-line","go","golang","twitter","twitter-api","twitter-client"],"latest_commit_sha":null,"homepage":"https://cbrgm.net","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cbrgm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-12-28T19:37:30.000Z","updated_at":"2024-04-23T14:31:24.000Z","dependencies_parsed_at":"2022-08-30T05:50:24.730Z","dependency_job_id":null,"html_url":"https://github.com/cbrgm/go-t","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cbrgm%2Fgo-t","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cbrgm%2Fgo-t/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cbrgm%2Fgo-t/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cbrgm%2Fgo-t/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cbrgm","download_url":"https://codeload.github.com/cbrgm/go-t/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246418658,"owners_count":20773934,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","command-line","go","golang","twitter","twitter-api","twitter-client"],"created_at":"2024-08-01T05:01:05.627Z","updated_at":"2025-03-31T04:36:19.953Z","avatar_url":"https://github.com/cbrgm.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# go-`t`\n\n\u003cimg src=\".img/go_t_logo_312x156.png\" alt=\"go-t logo\" title=\"go-t logo\" /\u003e\n\n[![GoDoc](https://godoc.org/github.com/cbrgm/go-t?status.svg)](https://godoc.org/github.com/cbrgm/go-t)\n[![Build Status](https://drone.cbrgm.net/api/badges/cbrgm/go-t/status.svg)](https://drone.cbrgm.net/cbrgm/go-t)\n[![Go Report Card](https://goreportcard.com/badge/github.com/cbrgm/go-t)](https://goreportcard.com/report/github.com/cbrgm/go-t)\n[![](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](https://github.com/cbrgm/go-t/blob/master/LICENSE)\n[![](https://img.shields.io/github/release/cbrgm/go-t.svg)](https://github.com/cbrgm/go-t/releases)\n\n **A blazing-fast, simple and easy to use command-line client for [Twitter](https://twitter.com) written in [Go](https://golang.org/).**\n🚀📨\n\n## Overview\n\n1.  [Demo](#demo)\n2.  [Features](#features-\u0026-roadmap)\n3.  [Installation](#installation)\n4.  [Configuration](#configuration)\n5.  [Usage Examples](#usage-examples)\n6.  [Credit \u0026 License](#credit-\u0026-license)\n7.  [Contributing](#contributing)\n8.  [Acknowledgements](#acknowledgements)\n\n## Demo\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\".img/demo.gif\" alt=\"go-t demo\" title=\"go-t demo\" /\u003e\n\u003c/p\u003e\n\n## Features \u0026 Roadmap\n\nPlease have a look at [docs/features.md](https://github.com/cbrgm/go-t/blob/master/docs/features.md) for an extensive list of all features along with several usage examples.\n\n| **Feature**           | **Status**   | **Description**                                                                                   |\n| --------------------- | ------------ | ------------------------------------------------------------------------------------------------- |\n| Multi-account support | ✔ [beta]     | Manage multiple twitter accounts                                                                  |\n| Tweets                | ✔ [beta]     | Post, (un)retweet tweets, list retweets from command line or stdin                                |\n| Favorites             | ✔ [beta]     | (Dis)like tweets from the command line or stdin                                                   |\n| Friendships           | ✔ [beta]     | (Un)follow users, show friendship satus from command line or stdin from the command line or stdin |\n| Timelines             | ✔ [beta]     | List tweets of your personal-, mentions- and retweets- timeline                                   |\n| Users                 | ✔  [beta]    | Retrieve user information, Mute users, search users from command line or stdin                    |\n| Followers             | ✔  [alpha]   | List friends, groupies and leaders                                                                |\n| Ouput formats         | ✔ [alpha]    | Support different output formats for commands such as JSON, YAML, lists or CSV                    |\n| Sorting               | ✔ [alpha]    | Support sorting for output                                                                        |\n| Trends                | 🚧 [planned] | Retrieve trend information from different countries                                               |\n| Searching             | ✔  [alpha]  | Search for specifific tweet content , hashtags, links, ... keywords via regex                     |\n| Direct Messages       | 🚧 [planned] | List, send and delete direct messages from command line or stdin                                  |\n| List support          | 🚧 [planned] | Create/Delete from command line or stdin                                                          |\n| Auto-Completion       | 🚧 [planned] | Auto-completion different shells like bash, zsh, fish, ...                                        |\n\n-   🚧 [planned] = Feature is planned, a concept is still being worked on or not yet started.\n-   ✔ [alpha] = Commands / Flags / Arguments can change incompatibly with a new release.\n-   ✔ [beta] = Commands / Flags / Arguments are considered to be mostly stable and backwards compatible to an earlier released version.\n-   ✔ [stable] = Commands / Flags / Arguments are stable and will not change with a new release.\n\n## Installation\n\nIn case you have [Go](https://golang.org/) 1.11+ installed:\n\n```bash\ngo get github.com/cbrgm/go-t\n```\n\nYou can also download precompiled binaries. See [Releases](https://github.com/cbrgm/go-t/releases).\n\n## Configuration\n\nCreate a configuration directory with a default configuration for go-`t`.\n\n    t init\n\nThe configuration file can be found at `~/.trc/config.json`.\n\n[go-`t`](https://github.com/cbrgm/go-t) communicates with the Twitter API v1.1 to retrieve information. You will need to create an account on the Twitter developer website and credentials to use the Twitter API. Twitters API requires OAuth for all of its functionality, so you'll need a registered Twitter application.\n\nCreating a developer account is quickly done.\n\n1.  Go to \u003chttps://dev.twitter.com/user/login\u003e and log in with your Twitter username and password. If you don't have a Twitter account yet, click on the Sign up link below the Username field.\n\n2.  Go to the Twitter application page at \u003chttps://dev.twitter.com/apps\u003e and click `Create a new application`. Follow the instructions on the screen. Enter an application name, description and website.\n\n3.  Click the `Key and Access Tokens` tab to collect the credentials for your Twitter developer account. Click `Create my access token` at the bottom of the page. The following values are needed to add your Twitter account to go-`t`:\n\n-   `Consumer Key`\n-   `Consumer Secret`\n-   `Access Key`\n-   `Access Secret`\n\nWith the following command you add an account with the alias `foo` to be used by go-`t` (Important: `foo` is **not** your Twitter account name, but just an alias used by go-`t` to identify your credentials).\n\nFollow the setup instructions and add your account:\n\n    t accounts add foo\n\n## Usage Examples\n\nHere you will find some examples as an introduction how to use go-`t`. You can find more examples at [docs/examples](github.com/chttps://github.com/cbrgm/go-t/blob/master/docs/examples) .\n\nDo you have any other examples of using go-`t`? Please share them with others! See the [Contributing Guide](https://github.com/cbrgm/go-t/blob/master/CONTRIBUTING.md).\n\n**Send a tweet**\n\n    t status update \"First tweet with go-`t`! Whoop!\"\n\n**Send a tweet from stdin**\n\n    echo \"First tweet with go-`t` from stdin! Whoop!\" | t status update -f -\n\n**Send a tweet and like it after beeing published**\n\n    echo \"Instant like!\" | t status update -v -l -y -f - | awk '{print $1}' | t fav like -y -f -\n\n**Delete a tweet**\n\n    t status rm \u003ctweet id\u003e\n\n**Retweet a tweet**\n\n    t status retweet \u003ctweet id\u003e\n\n**Show all retweets of a tweet**\n\n    t status retweets \u003ctweet id\u003e\n\n**like a tweet**\n\n    t favorites like \u003ctweet id\u003e\n\n**dislike a tweet**\n\n    t favorites dislike \u003ctweet id\u003e\n\n**follow users**\n\n    t friendships follow @foo\n\n**Show all likes of user `foo` as a list**\n\n    t favorites list @foo\n\n**Like the last 4 tweets liked by user `foo`**\n\n     t favorites list @foo -l -c 4 | awk '{print $1}' | xargs -I tweet t favorites like -y tweet\n\n**Show your latest timeline**\n\n    t timeline\n\n**Show your latest timeline as list, sorted by favorites count, descending**\n\n    t timeline -l --sort likes,asc\n\n**Show your latest mentions**\n\n    t timeline mentions\n\n**Favorite the last 10 tweets that mention you**\n\n    t timeline mentions -c 10 -l | awk '{print $1}' | xargs -I tweet t fav like tweet\n\n**Show latest retweets**\n\n    t timeline retweets\n\n**Show the 50 latest tweets of user `foo`'s timeline as list**\n\n    t timeline user @foo -l -c 50\n\n**Search for term `foo` in your timeline**\n\n    t timeline -l | grep @foo\n\n**Get detailed user information**\n\n    t users whois foo\n\n**Search for users with name `golang` and output json**\n\n    t users search \"golang\" -o json\n\n**list all followers of user `foo`**\n\n    t followers @foo\n\n**list all followers of user `foo` as list, sorted by follower's recent tweet activity**\n\n    t followers @foo -l --sort tweeted\n\n**Unfollow the last 10 persons you are following, who tweeted less then all your other followers**\n\n    t followers @foo -l --sort tweeted | awk '{print $1}' | xargs -I user t users unfollow user -y\n\n**list all followers of user `foo` as list, sorted by follower's registration date**\n\n    t followers @foo -l --sort tweeted\n\n## Credit \u0026 License\n\ngo-`t` is open-source and is developed under the terms of the [Apache 2.0 License](https://github.com/cbrgm/go-t/blob/master/LICENSE).\n\nMaintainer of this repository is:\n\n-   [@cbrgm](https://github.com/cbrgm) | Christian Bargmann \u003cmailto:chris@cbrgm.net\u003e\n\nPlease refer to the git commit log for a complete list of contributors.\n\n## Contributing\n\nSee the [Contributing Guide](https://github.com/cbrgm/go-t/blob/master/CONTRIBUTING.md).\n\n## Acknowledgements\n\ngo-`t` was initially started by Christian Bargmann.\n\nThis project is inspired by [sferik/t](https://github.com/sferik/t), a command-line power tool for Twitter. go-`t` uses the [dghubble/go-twitter](https://github.com/dghubble/go-twitter) library to communicate with the Twitter API. Many thanks to both projects, you are doing a great job!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcbrgm%2Fgo-t","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcbrgm%2Fgo-t","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcbrgm%2Fgo-t/lists"}