_{Dedicated to my fiancee Yang Yang}
A temporary bookmark focused on reading later, rather than closing and removing.

Installation

Click the image below to install:

Please rate it on chrome web store or star it on github if you like it. Your encouragement will help me make it better, thanks!

Manual Installation

1. Download chrome-read-later.zip.
2. Unzip it into a folder and move that folder to a safe path (you won't delete it accidentally). manifest.json is at the top of the folder.
3. Go to chrome://extensions/
4. Open Developer mode.
5. Drag the folder to chrome or Click Load unpacked and select the folder.

Features

Reading List

• Reading Progress(Orange %): It gets and sets the scroll position of current page.
• Video Progress(Blue %): It gets and sets the current time and the playback rate of the first video.
• Sync in Cloud: Sync across Chrome browsers with one google account.
• Local Archive: Keep an archive of reading list items locally.

Hybrid Storage

• When Chrome Sync is full, new items are saved on this computer instead.
• Synced and local items appear together; local items use a different text color, the status bar total turns the same color, and its tooltip shows the breakdown. Local items are included in exports.
• Local items move to Chrome Sync automatically when space becomes available. Options › Storage shows how many items are synced and how many are on this computer only.

Appearance

• Light and Dark Themes: The popup, Archive, and Options follow your system appearance with one shared palette.
• Interface Font: Choose System default, Avenir, Georgia, or Monospace in Options. The choice applies on this computer only.
• Site Icons: The popup shows Chrome's cached icon instantly, then the site's own icon once it loads.

Status Bar

• Row / Total: The selected row and the number of saved items.
• Archive Icon: Open the full-page reading list archive.
• Options Icon: Open the unified options page.
• Question Icon: Click to open the documentation & feedback page.
• Status bar icons are buttons: press Tab to reach them and Enter or Space to activate. Tooltips can be scrolled and dismissed with Esc.

Import and Export

• Export the reading list as JSON or JSONL from Options, and import either format.
• Imported items must have an absolute http, https, file, chrome, chrome-extension, or about URL. Invalid entries are skipped and counted as failed; valid entries are still imported.

Usages

Windows and Mac Keyboard Differences

Mac Key	Windows Key
Control	Ctrl
Option	Alt
Command	Windows
Delete	Backspace

Website

• Right Click a link and select Save to Read Later in context menus to save the target link info.
• Right Click current page and select Save to Read Later in context menus to save page info and close current tab.
• Click the read later icon to open the Reading List(Popup Window).
• Alt + Shift + S: Save to reading list.
• Alt + Shift + Z: Zoom In/Out reading list.

If you pressed the shortcuts and it didn't work, please enter chrome://extensions/shortcuts in your address bar. Find Read Later and set the shortcuts(resolve the keyboard shortcuts conflicts)

Popup

Actions	Mouse	Keyboard	VIM
Open reading list	Click extension icon	Alt + Shift + z	\
Close reading list	Click extension icon	Alt + Shift + z	Esc
Open in Current tab	Click	Enter	o
Open in a New tab and Stay in Current tab	Command + Click	Command + Enter	O
Open in a New tab	Alt + Click	Alt + Enter	alt + o
Delete	Hover favicon and Click	Delete	dd
Move to Next	Move Down	↓	j
Move to Previous	Move Up	↑	k
Move to Top	Scroll to Top	Command + ↑	gg
Move to Bottom	Scroll to End	Command + ↓	G
Restore a deletion	\	Command + z	u
Copy link address	Right Click and select copy link address	\	yy
Open archive	Click Archive icon	Tab to Archive, Enter	A
Open settings page	Click Options icon	Tab to Options, Enter	,
Open documentation & feedback site	Click Question icon	Tab to Help, Enter	?
Run the configured item hover behavior	Hover text	\	\

Note

• Get/Set reading progress works on most pages, it may change based on current window size.
• Only get/set the first HTML video's information.
• Removing the extension will delete the reading list in the cloud, it cannot be restored.
• Chrome Sync capacity depends on item size; items that exceed its limits remain on this computer.
• At most 10,000 reading list items are kept in the archive.
• Site icons are requested from Google's favicon service using only the site's origin (for example https://example.com).

Contribution

Suggestion & PR are welcome. Please open an issue to discussion first.

• UI
• UX
• Refactoring / Code Quality
• New Features
• Documentation

TODO

• Get/Set PDF page number(with pdf.js extension).
• Integrate with vimium(C), use s and S.
• Cache the reading list to instantly open.
• Improve the vim code logic(more dynamic).

Credits

• Logo is designed by Yasujizr.
• Delete icon is made by Freepik
• Icons in status bar are Octicons.
• I use RubyMine to make this extension, it improves my productivity a lot!
• Special thanks to my fiancee YangYang, she gave me a lot of helpful suggestions, feedback and encouragement.

Policy Privacy

[policy-privacy.md]

LICENSE

AGPL-3.0