Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/floriankilian/SaveToReadwiseReaderOnTwitter


https://github.com/floriankilian/SaveToReadwiseReaderOnTwitter

Last synced: 3 months ago
JSON representation

Awesome Lists containing this project

README

        

# Save Tweets to Readwise Reader with Tampermonkey
The "Save Tweets to Readwise" UserScript adds a convenient button to copy the URL tweet on Twitter without having to click through any dropdowns. Additionally provides the functionality to save to ReadwiseReader, a platform for organizing and remembering your highlights

## How to Install.
### Setup of Tampermonkey and the Userscript
1. Install [Tampermonkey](https://tampermonkey.net/).
2. Access the Script in [Raw View](https://github.com/floriankilian/SaveToReadwiseReaderOnTwitter/raw/main/SaveToReadwiseReaderFromTwitter.user.js).
3. Tampermonkey will prompt you to install the Userscript, click Install.

Install Userscript on Tampermonkey

### Get a Readwise API key
1. Get your Readwise [API key](https://readwise.io/access_token), and copy it to your clipboard.

### Configuration
1. Access any Twitter URL (x/twitter)
2. Click on the new copy icon with an alt-left-click (option on mac) to set your API key

Provide your API Key

3. Paste the API key from your clipboard.
4. Voila!

How it will be displayed

5. ON the first usage you will be requested to allow the domain. Click always allow domain.

Always allow domain

## How to use
1. Click on the clipboard. It will change to blue if it is copied to clipboard and change to a yellow icon once it was send and saved sucessfully at Readwise Reader.

Saved tweet

How to use

By following these simple installation steps, you can enhance your Twitter browsing experience by easily saving and sending tweets to Readwise.

## Possible future improvements:
- ~~Optimize API Key Handling~~
- ~~checking for the API key only when the user decides to save a tweet to reduce potential annoyance~~
- ~~update the stored API key without clearing browser data or changing Tampermonkey settings (e.g., Alt + Click on the save icon)~~
- ~~Improve Error Handling, e.g. red icon on an error~~
- Refactor and Modularize Code
- ~~Get the author of the tweet instead of "twitter.com"~~

## Known issues:
- If the selected tweet is a reply to another "thread"-tweet, the reply will be parsed by Reader instead of the "reply"-Tweet.
- Tweets can be saved multiple times as there is currently no check check if the tweet was already saved.

## Credits
- [Readwise](https://readwise.io/)
- [Tampermonkey](https://tampermonkey.net/)
- [One Click Copy Link Button for Twitter](hhttps://greasyfork.org/ckb/scripts/482477-one-click-copy-link-button-for-twitter-x/feedback)

## Find more useful tools for Readwise Reader
https://github.com/Scarvy/awesome-readwise