Taggability is a tool that allows you to assign multiple tags to multiple articles from your Readability reading list. It helps you maintain a clean and organized article collection.
Check out taggability.io to see it in action. All you need is a Readability account.
You need Node.js installed. Clone/Download this repository. Open your console and go to the directory.
Install with:
$ npm install
API keys
Create a config.json
file and enter your Readability API credentials as follow. (get yours here)
{
"key" : "MY_API_KEY_HERE",
"secret" : "MY_API_SECRET_HERE"
}
(Optional) If you want to run the app on a remote server, you need to add a line in your config.json
as follow (without http://
nor the trailing /
):
"url" : "www.myawesomeurl.com"
Run with:
$ node app
Once the server is running, go to http://localhost:3000
.
- Refactor app.js to separate routes, server, etc.
- Add auto-loading pagination for bookmarks.
- Display notifications for user actions (success/failure).
- Responsive layout for tablets.
I'm Sam, a web designer & front-end developer from Paris, France.
I'm an intense user of Readability, where I like to keep important articles to refer to someday.
After a couple of years using the (great) service, I had more than 1,500 articles in my reading list. None of them was tagged. Manually editing all those bookmarks with the regular Readability interface wasn't an option, so I decided to create a tool that would help me do that.
This was also an excuse to create an app as a side project and play with Node.js.
You are strongly encouraged to make Taggability better. Dig into the code, report a bug, suggest something, share the love... Contact me on Twitter or by email at hello@taggability.io!
I’m not a real back-end developer :) so please forgive me for any mistakes or bad practice in the code.
Fonts by Typekit & icons by Entypo.
Taggability is built on Node.js using the following open-source resources:
-
passport-readability by Jared Hanson
-
node-readability-client by Robin Murphy (forked)
-
jQuery-Tags-Input by XOXCO
And, of course, the Readability Reader API.
Thank you Guillaume C. & Guillaume C. for your precious advice!
This project is published under the MIT License (MIT).
2014 - Created by Samuel Lemaresquier.