{"id":23686437,"url":"https://github.com/devhindo/x","last_synced_at":"2025-09-02T13:32:31.420Z","repository":{"id":189053686,"uuid":"679597250","full_name":"devhindo/x","owner":"devhindo","description":"post tweets from terminal ","archived":false,"fork":false,"pushed_at":"2024-04-06T22:53:34.000Z","size":2428,"stargazers_count":16,"open_issues_count":24,"forks_count":2,"subscribers_count":6,"default_branch":"main","last_synced_at":"2024-04-06T23:23:51.634Z","etag":null,"topics":["cli","go","golang","twitter","twitter-api","twitter-api-v2","twitter-app","twitter-application","twitter-cli","twitter-client","x"],"latest_commit_sha":null,"homepage":"https://x-blush.vercel.app","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/devhindo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null},"funding":{"custom":["https://www.paypal.me/devhindo"]}},"created_at":"2023-08-17T07:36:59.000Z","updated_at":"2024-04-06T23:23:53.455Z","dependencies_parsed_at":null,"dependency_job_id":"b86a8307-0d81-4cdc-89a2-eb5994bed168","html_url":"https://github.com/devhindo/x","commit_stats":null,"previous_names":["devhindo/x"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devhindo%2Fx","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devhindo%2Fx/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devhindo%2Fx/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devhindo%2Fx/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devhindo","download_url":"https://codeload.github.com/devhindo/x/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":231789456,"owners_count":18426966,"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","go","golang","twitter","twitter-api","twitter-api-v2","twitter-app","twitter-application","twitter-cli","twitter-client","x"],"created_at":"2024-12-29T21:32:14.460Z","updated_at":"2025-09-02T13:32:31.408Z","avatar_url":"https://github.com/devhindo.png","language":"Go","funding_links":["https://www.paypal.me/devhindo"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\u003ci\u003eCLI tool to post tweets on x (twitter) from terminal\u003c/i\u003e\u003c/div\u003e\n\n\u003cbr\u003e\n\n![preview](./assets/preview.gif)\n\n## Table of Contents\n\n- [Usage](#usage)\n- [Installation](#installation)\n  - [Linux](#linux)\n  - [Windows](#windows)\n  - [Mac](#mac)\n- [Authentication](#authentication)\n- [Docs](#docs)\n\n## Usage\n\n\n### Main Usage\n\n- post tweets from terminal like this\n\n```bash\nx \"first tweet from terminal!\"\n```\n\n### Full Docs\n\n```bash\n\ninteract with x (twitter) from terminal.\n\nUSAGE\n  x \u003ccommand\u003e\n\nMain usage (posting a tweet)\n  x \u003ctweet-text\u003e\n    Examples:\n      one word tweet (no spaces)  x hi\n      multiple words tweet        x \"hi from terminal\"\n      with optional arg:          x -t \"hi there\"\n      extended optional arg:      x --tweet \"hi x\"\n\nCommands\n  -h             show this help\n  auth           start authorizing your X account\n  auth --url     get auth url if it didn't open browser after running 'x auth'\n  auth -v        verify authorization after running 'x auth'\n  -t \"text\"      post a tweet\n  -v             show version\n  -c             clear authorized account\n```\n\n## Installation\n\n### Linux\n\n- download the verion that matches computer's operating system from [latest release](https://github.com/devhindo/x/releases/latest)\n- open a terminal in the directory where the file was downloaded\n- for example assume the file name is `x_Linux_x86_64.tar.gz`\n- remove any previous downloaded version of x\n\n```bash\nsudo rm -rf /usr/local/x\n```\n\n- run the following command to extract the file\n\n```bash\nsudo tar -C /usr/local -xzf x_Linux_x86_64.tar.gz\n```\n\n- Add `/usr/local/x` to the PATH environment variable\n- Do this by adding the following line to your $HOME/.profile or /etc/profile (for a system-wide installation):\n\n```bash\n# opening the file\nnano $HOME/.profile\n\n# and add this line at the end of the file\nexport PATH=$PATH:/usr/local/x\n```\n\n- run the following command to update the current session\n\n```bash\nsource $HOME/.profile \n```\n\n- verify the installation by running the following command\n\n```bash\nx version\n```\n\n- if the installation was successful, you should see the version of x that was installed\n\n### Windows\n\n- download the verion that matches your archeticture from [latest release](https://github.com/devhindo/x/releases/latest)\n- 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`\n- open a terminal and run `x --version` to verify the installation\n- if the installation was successful, you should see the version of x that was installed\n\n### Mac\n\n- idk never used it before. but I have darwin binaries in the [latest release](https://github.com/devhindo/x/releases/latest) so you can try it out\n\n## Authentication\n\n- run `x auth`\n- an auth url will be opened in your browser, if it doesn't run `x auth --url` to get the url\n- verify `X CLI` in the opened twitter page\n- after authorizing the app return to the terminal and run `x auth -v`\n\nNote: 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](https://github.com/devhindo/x/blob/b00b1a911e1e7ac364dd2d10f941e95d76bfb3ac/src/cli/lock/key.go#L13) to identify the user by a random string that's unique for your device. you can check the function [here](https://github.com/devhindo/x/blob/b00b1a911e1e7ac364dd2d10f941e95d76bfb3ac/src/cli/lock/key.go#L42C1-L42C1). so if the threat shows up, allow it and continue.\n\n- if the authorization was successful, you should see a `verified` message\n- now you can post tweets using `x -t \"tweet text\"`\n- if anything went wrong run `x -c` to clear any settings and start over\n- if the problem persists, kindly open an issue [here](https://github.com/devhindo/x/issues/new) and describe the problem and I'll be happy to help!\n\n\n## Posting tweets\n\n`x -t \"tweet text\"` or `x --tweet \"tweet text\"` or `x \"hi there!\"` or even one word tweet like `x spotifyURL`\n\n## Docs\n[Docs](https://deepwiki.com/devhindo/x)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevhindo%2Fx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevhindo%2Fx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevhindo%2Fx/lists"}