❤️ aime

aime is a terminal dashboard that lets you search & manage your Twitter likes.

📜 features

You can:

• Organize your liked tweets into categories.
• Mark a tweet as read/unread.
• Search your liked tweets by query, user, read/unread, or category.

All from the comfort of your terminal. ❤️

💡 future improvements

• More efficient fetching, e.g. only fetch for the x most recent tweets.
• Search of tweets containing links

😩 limitations

• Twitter API doesn't offer ways to query liked tweets based on timestamp, so when fetching tweets, it's not possible to specify whether we only want to fetch liked tweets that were tweeted this week, etc.

💭 contribute

If you're interested to work in improving the points above/have any idea, feel free to make a pull request/let me know and contribute! 🙏

☁️ installation

npm install aime

⚙ configuration

aime needs your Twitter account's API keys to work.

1. Find out how to get your access token here & do all the steps necessary.
2. Export the following variables

export CONSUMER_KEY = '[ your consumer_key here ]'
export CONSUMER_SECRET= '[ your consumer_secret here ]'
export ACCESS_TOKEN = '[ your access_token here ]'
export ACCESS_TOKEN_SECRET = '[your access_token_secret here]'

You only need to do this once.

🎉 running

To run, just type

aime

on your terminal and then you're all set.

To exit, just press esc, q, or CTRL + q.