https://github.com/alok/thread-twitter

https://github.com/alok/thread-twitter

twitter twitter-api

Last synced: 4 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/alok/thread-twitter
• Owner: alok
• Created: 2019-03-22T07:10:28.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2022-12-08T04:54:06.000Z (about 2 years ago)
• Last Synced: 2024-08-13T03:06:32.910Z (6 months ago)
• Topics: twitter, twitter-api
• Language: Python
• Homepage:
• Size: 12.7 KB
• Stars: 11
• Watchers: 2
• Forks: 3
• Open Issues: 2
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
## What it does

Read a Twitter thread as a Markdown file, with indentation to indicate

which tweet is in reply to which.

See `example.md` for, well, an example.

Consecutive tweets by the same user are flattened onto the same level of

indentation since they're probably meant as continuations of a single

thought.

## Dependencies

You'll need:

-   [python-twitter](https://github.com/bear/python-twitter).

-   Twitter API keys (which requires a developer account. See

    [here](https://python-twitter.readthedocs.io/en/latest/getting_started.html).

-   Python 3.7+

You must also define these environment variables for the script to pick

up your API keys:

-   `TWITTER_KEY`

-   `TWITTER_SECRET`

-   `TWITTER_TOKEN`

-   `TWITTER_TOKEN_SECRET`

## Usage

The script takes in any amount of status URLs, which have the form

`https://twitter.com/{username}/status/{id}.`

It produces Markdown files in the same directory it's run, with the name

`twitter-{id}.md`.

Here's an example:

``` {.sh}

python3 thread_tweets.py https://twitter.com/Hillelogram/status/1107754119627001859 https://twitter.com/Hillelogram/status/1108549064239599622

```

## Caveats

Apparently the Twitter search API only works for tweets from the last 7

days. Run this script on threads you like sooner rather than later.

If you have any questions, ask me on

[Twitter](https://twitter.com/therevaloksingh) or on the issue tracker.

## TODO

Add proper threading like Mutt has. Maybe even with the fancy arrows it

draws. [This](https://www.jwz.org/doc/threading.html) looks handy.