devhindo/x

post tweets from terminal

CLI tool to interact with x (twitter) from terminal

Table of Contents

• Usage
• Installation
  • Linux
  • Windows
  • Mac
• Authentication

Usage

Main Usage

• post tweets from terminal like this

x -t "first tweet from terminal!"

Full Docs

interact with x (twitter) from terminal.

USAGE
  x <command>

Commands
  -h             show this help
  auth           start authorizing your X account
  auth --url     get auth url if it didn't open browser after running 'x auth'
  auth -v        verify authorization after running 'x auth'
  -t "text"      post a tweet
  -v             show version
  -c             clear authorized account

Installation

Linux

• download the verion that matches computer's operating system from latest release
• open a terminal in the directory where the file was downloaded
• for example assume the file name is x_Linux_x86_64.tar.gz
• remove any previous downloaded version of x

sudo rm -rf /usr/local/x

• run the following command to extract the file

sudo tar -C /usr/local -xzf x_Linux_x86_64.tar.gz

• Add /usr/local/x to the PATH environment variable
• Do this by adding the following line to your $HOME/.profile or /etc/profile (for a system-wide installation):

# opening the file
nano $HOME/.profile

# and add this line at the end of the file
export PATH=$PATH:/usr/local/x

• run the following command to update the current session

source $HOME/.profile 

• verify the installation by running the following command

x version

• if the installation was successful, you should see the version of x that was installed

Windows

• download the verion that matches your archeticture from latest release
• extract the file and get the x.exe file and place it in a directory that is in your PATH environment variable. a common one is C:\Windows\system32
• open a terminal and run x --version to verify the installation
• if the installation was successful, you should see the version of x that was installed

Mac

• idk never used it before. but I have darwin binaries in the latest release so you can try it out

Authentication

• run x auth
• an auth url will be opened in your browser, if it doesn't run x auth --url to get the url
• verify X CLI in the opened twitter page
• after authorizing the app return to the terminal and run x auth -v

Note: running x auth -v windows might flag the tool as a threat this is because it reads a config file that was previously generated here to identify the user by a random string that's unique for your device. you can check the function here. so if the threat shows up, allow it and continue.

• if the authorization was successful, you should see a verified message
• now you can post tweets using x -t "tweet text"
• if anything went wrong run x -c to clear any settings and start over
• if the problem persists, kindly open an issue here and describe the problem and I'll be happy to help!

Posting tweets

x -t "tweet text" or x --tweet "tweet text"

x's Issues

implement sha256 for DB auth

handle `x -t` prompt

write error handling for x -t prompt

ability to view stream of timeline (ala the old t client)

I think this would be the only feature I request for this application. It is a big ask but that is kinda why I was using t years ago. being able to see real time posts from a terminal interface. If this is a thing that exists somewhere else outside of this repo (and works), feel free to let me know.

convert to cobra template

Windows detects a virus when downloading from releases claiming it's malware

this behavior is related to Windows idk why this happens but the code is available and you can build it locally if you have Go installed (the code for the CLI lives on the src/cli dir)

resources:

• go.dev/doc/faq#virus

handle `x -t` prompt

write error handling for x -t prompt

replace every `panic()` statement with appropriate error handling

Multiple accounts

Are there plans to support multiple accounts?

multiple accounts feature

x auth -a elon -- continue authentication
x auth -a yoyo -- continue authentication
x switch -a elon >> post from elon
x switch -a yoyo >> post from yoyo

add installation with `make` file and a local build

too much letency until the tweet gets posted ~around 2000ms

add all-in-one self hosting instructions that includes database and server

maybe MySQL or SQLite. All within a docker-compose file.

Create Linux installation script

do something like this curl -fsSL https://tailscale.com/install.sh | sh & src

cleaner readme

tweet more that tweet by counter

what about tweeting more that tweet like for example x -N 12 "12 tweet with same text "
and what about taking post and reply to with x -r "comment on tweet"
also final thing what about reply with tweet i've wrote or i retweet it for example this reply with the last 12 tweet or retweet i've in this tweet x -r -N 12

Improve website (a more modern and simple layout)

`x -t "tweet text"` => `x "tweet content"`

add support for `/n` for a new line in the tweet text

input:
x -t "first \ntweet \n endl

output:

first
tweet
endl

update README with development instructions and improve documentation

add an overview of how you constructed the app to help people contribute to it

Encrypt local credentials before requesting to database

add ability to post future tweets

post tweets in future by passing a date parameter

add a constrain for tweet limit

don't send a request to the X API if the tweet character count exceeds 280 characters. instead prompt the user to shortage the tweet

x -t "long tweet"

character limit exceeded by 6 characters. make the tweet shorter.

implement this endpoint `GET /2/users/:id/tweets`

https://developer.twitter.com/en/docs/twitter-api/tweets/timelines/api-reference/get-users-id-tweets

tweet with image like `x -i <path>` or `x -i` and dropping the image in the terminal

also support x --image <path>

add a security layer to encrypt the AT in DB

create a key locally in .tempxcli and use to retrieve the AT from DB and decrypt it locally

`x thread`

I envision 2 possibilities for threads.

1. interactive mode.

$ x thread

Hello world

If you press enter it prompts you:

Press `space` to continue with 1/1 and add a new line
Press `enter` to continue with 2/2
Press `shift + enter` to send thread
Press `esc` to restart 1/1

I'd replace the -t command with this functionality and just tweet without any param like currently does but it's not documented btw.

May be feasible to implement color highlight when going above max char.

2. Reply to last tweet.
   x -r "text"

So you can:
x "Hello"
x -r "world!"

Hello tweet 1/2
world! tweet 2/2

3. Reply to id
   x -r [id] "text"

Which can be combined with
x "Hello world!" ~> outputing the ID

`x -p devhindo ls -s "https://www.open"` to list all tweets starting with the given parameter

nicer website

make the valid authentication message look better

upon x auth and checking in in the browser

add a self-hosting instructions

Tweets with images

Thank you for this project!

Will it be possible in future updates to attach images to tweets?

get the time of the machine for schedulling future tweets and based on that do the work

include all possible validations both on client and server

add `usertest` db to be suppressed from production during development

• It should have the same schema as user database.
• It should be changed to user before merging to main.

`x update`

with 2 outputs

1. no available updates
2. there's a new version <version number> do you want to update? (y/n)