More info about In My Pocket addon

What is Pocket?
Pocket is a web service that allows you to store links in order to read them later. You can save this content from your browser or other applications, and access them later. As per Pocket's about page:
Pocket was founded in 2007 by Nate Weiner to help people save interesting articles, videos and more from the web for later enjoyment. Once saved to Pocket, the list of content is visible on any device — phone, tablet or computer. It can be viewed while waiting in line, on the couch, during commutes or travel — even offline.
What is the In My Pocket addon?
This addon provides a quick and easy way to access your Pocket list right from your browser. Instead of having to open the pocket website in a new browser tab, you can simply click the icon in your browser and get instant access to your Pocket list. It also becomes really easy to add new pages while browsing, or to mark links as read. In a word, it makes Pocket easier to use!
Who develops the In My Pocket addon?

Pierre-Adrien Buisson My name is Pierre-Adrien Buisson, I'm a French developer working mostly on web-related projects, Ruby and Javascript. I've been a Pocket user for a very long time, back when it was still called "Read It Later"... and I was really disappointed to see Pocket stop developing its own official Firefox addon, years ago. No alternative emerged over time, that's why I decided to develop this plugin.

I'm in no way related nor affiliated to pocket or Mozilla, only an independant developer trying to bring something useful to the community.

I love what you've done! How can I help?

I'm glad that you appreciate the addon, as it takes me a lot of my free time to develop it, fix bugs, answer support requests, well, everything you have to do when you work on this kind of projects! If you love it and want to help:

  1. Simply talk about the addon, share it with your contacts and your communities, help spread the word :)
  2. Write a review about In My Pocket on the Mozilla Addons website
  3. Eventually, if you really love this addon and want to repay me for the hours I spend working on it, you can buy me a cup of coffee , or a pint of beer , or even a meal if you feel like it!

I thank you guys so much for your support and hope In My Pocket will keep on being useful to all of us!

What information does the addon store about me? What about my privacy?
The addon does not store any private information about you, your behaviour or the content of your pocket list. All data displayed in the popup is only accessible to you and Pocket, nothing gets sent back to me and I can't ever access any data of yours.
Where can I find the source code?
This addon is open-source, which means that the source code is publicly available to anyone. If you're in that kind of things, you can find the source code on the In My Pocket repository on bitbucket. Pull requests are very welcome, several developers already contributed to the project (thanks a lot guys!) :)
How can I keep up with the development ?
You'll find the public roadmap of In My Pocket on Trello, I try to keep it as up to date as possible. Note that this public roadmap does not contain everything that I'm working on or intend to work on, only the most notable ones. I've got my own set of backlogs and ideas and technical tickets to work on, this is only the tip of the iceberg.
I've got ideas / issues. Where can I contact you?
I've set up a contact form that you'll find here. I receive all demands in my inbox and I'll make sure to come back to you soon. You can also contact me directly through twitter at @pabuisson.

Using the In My Pocket addon

What can I do with In My Pocket?
In My Pocket offers you a shortcut to your Pocket list. There are several components composing the In My Pocket addon:
  • A popup, that opens when you click the icon on the right of the address bar. The popup is where you'll be able to view your whole list of items, filter them, remove them, etc.
  • An icon that sits in your address bar. This icon is displayed in red if the page is already present in your pocket list, and in a light grey otherwise. You can directly click the icon to add the page to pocket.
  • A contextual menu (right-click menu) that gives you access to most common actions: add the current page to your pocket list, mark the item as archived, remove it completely.
  • Keyboard shortcuts to add the current page to your pocket, mark it as read or open the popup
When I open the popup, it just displays a big blue "Authenticate" button. What should I do?
When you open In My Pocket addon for the first time, the popup will be empty. That's because you first need to authorize the addon to access to your pocket account. When you click the "Authorize" blue button, you'll be redirected to the Pocket website. You'll then have to log in and authorize In My Pocket to access your pocket list, and you'll be good to go! Once you've done this, the popup will automatically close. Next time you open it, you should see your whole list of items in the popup.
What's the difference between "archive" and "delete" actions?
Items in your pocket list can be removed in two different ways:
  • Archive: the item is removed from your list, but can still be found in the "Archives" section of the pocket website.
  • Delete: the item is removed from your list and every trace of it will be removed. You won't be able to find it anymore, even in the "Archives" section of your pocket account.
How to access the settings page?
Settings are currently displayed at the bottom of the addon details page. The easiest way to access the settings page is to open the In My Pocket popup, and click the gear icon on the top left of the popup. This will take you straight to the addon details page.
I now see two "pocket" buttons in the address bar. Why is that? What should I do?

By default, Firefox ships with its own Pocket integration (Pocket has recently been acquired by Mozilla, the foundation behind Firefox), that also provides a button in the address bar.

Two pocket buttons in the address bar If you're confused with this and use a Firefox version >= 57, you can simply right-click the button and select "Don't show in the address bar". Note: when right-clicked, the In My Pocket button will show "Don't show in address bar" and "Manage extension", whereas the built-in button will only show "Remove from address bar".

You can also use this tip from the Mozilla knowledge base to disable the Pocket integration: Disable or re-enable Pocket for Firefox | Firefox help. This will make the default integration button disappear from your address bar.


Houston, I have a problem!

I have a lot of items and the extension hangs. What should I do ?
In its early days, In My Pocket was not designed to deal with too many items. Pagination has improved the situation and is now enabled by default. If you have lots of items and feel like the addon is slow, try and enable the pagination in the settings page.
Disconnect and reconnect
If you have issue with missing data or broken behaviour, please try and disconnect from your pocket account. This also deletes most of the data stored by the addon and will reset it to its original state. To do this, go to the settings page, click the "Disconnect" link at the bottom and answer "Yes" to the window. You can now try and reconnect, and see if things are better. Otherwise, feel free to contact me through the usual channels or open an issue in the bitbucket repository.
Debugging steps to help me
Unfortunately, this won't always be enough to solve the problem. In that case, it'd help me a lot if you could contact me and provide me with this information:
  1. First, make sure your addon is up to date. Go to the addons list, click the gear icon at the top and choose "Check for updates"
  2. If everything is up to date or if the problem persist after updating, then go to the settings page of the addon, and check "✓ Enable debug mode"
  3. While you're on the settings page, click "Disconnect" to make sure we'll reset all data stored in the addon.
  4. Then, open a browser console ("Tools > Web developer > Browser Console")
  5. Make sure "JS" and "Logging" are enabled at the top of the console window : Firefox browser console with JS and logging enabled
  6. Clear the console with the trash icon at the top left
  7. Then try and reproduce the same thing that was broken. Lots of lines should appear in the console, most of them prefixed with IMP. Once it's done, copy-paste all the content of the console (there might be a lot of lines with lots of them prefixed with "IMP |") and send it to me through one of the channels, along with your Firefox version and addon version.