Google Reader: Mark some as read

By Crend King Last update Nov 7, 2009 — Installed 1,683 times. Daily Installs: 6, 7, 6, 5, 3, 5, 5, 8, 3, 3, 7, 13, 6, 5, 6, 4, 5, 16, 20, 16, 13, 7, 13, 12, 6, 6, 7, 4, 8, 4, 9, 4
Script Summary:
Mark the entries below, above or between certain entries as read in Google Reader.
Version: 1.3.9
Recently Updated TopicsPosts
Doesn't work for https1
Can't write the letter "W" ...4
Stuck at 47.5%9
"Mark all above/below as re...3

this script has 4 topics, 17 posts

Review Summary
5 stars
1 reviews (1)
4 stars
0 reviews (0)
3 stars
0 reviews (0)
2 stars
0 reviews (0)
1 star
0 reviews (0)

this script has 1 review

Google Reader's "Mark all as read" is not enough! This script marks some, but not all, of your entries in Google Reader as read, based on criterion you can customize. When you have many entries unread, cannot read all of them at once, and still do not want to miss anything interesting, this script might be useful to you.

After installation, this script creates "Mark below as read" and "Mark above as read" buttons in Google Reader's toolbar. Before using these buttons, select an entry by clicking or keyboard shortcut if you are in the List view mode. It does not matter whether it is expanded or not. Click one of the buttons, and this script will mark entries below or above the selected entry for you.

Press the "q" key to as keyboard shortcut for marking below and "w" for marking above.

You could also mark entries by clicking! By enabling "Click Mark", the script will mark the entries between the current entry and the clicked entry as read. Click Mark will be activated only when holding the shift key. Normal clicks are not affected.

This is a remake of my same-named script Google Reader: Mark some as read (old). In the other script, I mainly simulate keyboard press and mouse click to mark entries read. In this script, I use Google Reader API to achieve the same functionalities. Because the two scripts are significantly different in their implementations, I decide to open this new page for the new script.

The major benefit of this new implementation is, it will NOT scroll the reader panel as marking entries read. Performance is noticeably improved if a large number of unread entries exist. Same as the old script, no refresh is needed in marking. Also, a lot of "stop condition" related variables are not necessary anymore. "Mark below" definitely marks EVERY entry below, even it is not loaded in the reader panel. Marking progress and error messages will be shown in Google Reader's native message area.

This script uses Firefox native JSON object, which is introduced in Firefox 3.5, to speed up marking process noticeably. Please use Firefox 3.5 and later versions.

Options

Below are the customizable options:

  • show_buttons: show or hide "Mark" buttons. (default show)
  • keypress_mark: enable or disable the keyboard shortcuts. (default enabled)
  • click_mark: enable or disable the "Click Mark" feature. (default enabled)
  • reload_after_mark: reload the page after marking. (default disabled)

Please open the script file to change the options.

The "Mark below as read" and "Mark above as read" buttons

The additional buttons appear in the toolbar as follows:

Known issue

The visual marking in the reader panel may be incorrect while only showing the new items. Fortunately the marking on the server side is correct, meaning you can observe the true marking result after reloading the page.

Reference

Although the Google Reader API is available to use, it seems the APIs are still unofficially supported. A good reference to the Google Reader API is available in http://code.google.com/p/pyrfeed/wiki/GoogleReaderAPI. Unfortunately, there are still many useful undocumented interfaces.

Version history

1.3.9 on 08/27/2009:
- Fix visual marking bug when only new items are shown.

1.3.8 on 06/30/2009:
- Use Firefox native JSON object, which is introduced in Firefox 3.5.

1.3.7 on 05/20/2009:
- Optimize implementation of message display.

1.3.6 on 05/19/2009:
- Use Google Reader's native message area to show information.

1.3.5 on 05/19/2009:
- Add option to reload the page after marking.

1.3.4 on 05/18/2009:
- Write comments.

1.3.3 on 05/16/2009:
- Fix bug that marking fails when feed's URL contains HTML entities.

1.3.2 on 05/07/2009:
- Fix bug that previous from entry will be marked unread if click mark is followed by a mark below/above.
- Fix bug when clicking buttons without selecting an entry first.
- Cannot click mark on same entry.

1.3.1 on 05/05/2009:
- Support the magic sort order ("Sort by auto").
- Fix bug that sometimes the entries in the reader panel are not marked read.

1.3 on 05/04/2009:
- Allow script to be used in any view ("All items", specific feed, label or folder).
- Add information text;

1.2.1 on 04/30/2009:
- Fix bug when user has multiple feeds and labels.

1.2 on 04/30/2009:
- Implement Click Mark.
- Minimize use of XPath.

1.1 on 04/30/2009:
- Request reading list in JSON format rather than XML.
- Fix sort order problem.

1.0 on 04/29/2009:
- Initial version.