Skip to content

Joedmin/xExtension-readeck-button

 
 

Repository files navigation

FreshRSS Readeck Button

A FreshRSS extension which adds a Readeck sharing integration.

With this extension you can simply press the Readeck Button next to an article or a custom keyboard shortcut to share it with Readeck. Everything else happens in the background while you can continue reading articles without any further interruptions.

Download and setup

  1. Download the latest release
  2. Extract and upload it to the ./extensions folder of your FreshRSS installation
  3. Go to <readeck_intance_url>/profile/tokens
  4. Create a new API token with at least the Bookmarks : Write Only permission
  5. Enter your Readeck instance url in the Readeck Button extension settings
  6. Enter your key in the Readeck Button extension settings
  7. Press "Connect to Readeck"
  8. Optional Set a custom keyboard shortcut

Readeck API Error codes

If you get errors while trying to connect to Readeck, please check the Readeck OpenAPI specification.

Contributing

Translations

If you'd like to translate the extension to another language please file a pull request. I'd be happy to merge it!

Development

For local development pull the repository. The prerequisite is Docker installed.

Go to the repository root folder and run docker compose up that will start a local FreshRSS instance running http://localhost:8080/.

Complete it's installation and navigate to Extensions, where you have to enable Readeck Button.

All changes in the PHP files are loaded with each page refresh.

Credits

This extension is based on freshrss-pocket-button and re-branded for Readeck.

Thank you very much Christian Putzke for creating the original extension. I used it every day until migrating from Pocket to Readeck.

Original icon is used from the original Readeck repository and the outlined version is done using Online Vector Designing Apps.

About

Add FreshRSS articles to Readeck with one simple button click or a keyboard shortcut.

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

Languages

  • PHP 42.3%
  • HTML 39.1%
  • JavaScript 11.1%
  • Shell 4.5%
  • CSS 3.0%