Nimitter

Nimitter is a simple Twitter client that runs on the command line and written in Nim.

Features

• Written in Nim
• View timeline, post a tweet, favorite/retweet
• Delete a own tweet or all tweets

Install

Requires

• Nim 1.4.2 or higher
• CORDEA/oauth

build

$ nimble build

Set your information

Befor you run this program, you must set some information in src/nimitterpkg/config.nim.

• API Key
• API Secret
• Access Token Key
• Access Token Secret

These keys will be used for authorization your account.
For that reason, you must get these key from Twitter Developer at first.

And also please set your twitter account information.

• Screen name

screen name is the user id that begin @.
For example, in case of Nimitter @nimitter, "Nimitter" is username, "nimitter" is screen name.

Usage

When you run the program, your home timeline will be displayed and the program will be in the input waiting state.

Home Timeline

In this menu, you can use the following command.

• 1 or rl : reload
• 2 or t : tweet
• 3 or r : reply
• 4 or f : favorite(like)
• 5 or uf : un-favorite(un-like)
• 6 or rt : retweet
• 7 or urt : un-retweet
• 8 or p : view own profile
• 9 or up : view other user profile
• 10 or vl : view tweet on default browser

Tweet

You can tweet text including line breaks.

[What's happening?]
This is sample tweet (ENTER)
Use the Enter key to start a new line. (ENTER)
(ctrl+c)

When you have finished writing, press ctrl+c to send tweet.
And be sure to press the Enter key on the last line of the text you want to send before sending it.
If you want to cancel tweet, press ctrl+c without typing anything.

Reply

First, select the tweet you want to reply to.
In the timeline, the user name is preceded by an index number. You can select a tweet by entering that number.

[1]Nimitter@nimitter
  sample tweet 
  - date information

Which Tweet do you want to reply?
 > 1
[Tweet your reply]

Like this.
The input method is the same as for Tweet.

Favorite(Like)/Retweet

You can select a tweet by entering that number the same as for Reply.
Un-favorite(Un-like)/Un-retweet are the same.

Profile

If you select 8 or p in Home Timeline menu, you can view your own profile.
In this menu, you can use the following command.

• 1 or e : edit profile
• 2 or d : delete a tweet
• 3 or vf : view follow list
• 4 or vfw : view follower list
• 5 or b : back to Home
• destroyall or DestroyAll: Delete all you tweet

Edit profile

You can change some information of your account.

• Name(UserName)
• Bio
• Location
• URL

Select the item you want to change, and then enter the details of the change.
Pressing ctrl+C keys will cancel the changes.

Other user profile

If you select 9 or up in Home Timeline menu, you can view other user profile. In this menu, you can use the following command.

• 1 or fl : follow the user
• 2 or ufl : un-follow the user
• 3 or r : reply your message to selected tweet
• 4 or f : favorite selected tweet
• 5 or uf : un-favorite selected tweet
• 6 or rt : retweet the tweet that is already retweeted
• 7 or urt : un-retweet the tweet that is already retweeted
• 8 or vf : view follow list
• 9 or vfw : view follower list
• 10 or b : bacl to home

Exit Nimitter

You can exit by pressing ctrl+C.