https://github.com/willbchang/chrome-read-later
A temporary bookmark focused on reading later, rather than closing and removing, with several Vim keybindings!
https://github.com/willbchang/chrome-read-later
bookmark chrome-extension painless productivity read-it-later read-later temprorary-bookmark
Last synced: about 2 months ago
JSON representation
A temporary bookmark focused on reading later, rather than closing and removing, with several Vim keybindings!
- Host: GitHub
- URL: https://github.com/willbchang/chrome-read-later
- Owner: willbchang
- License: agpl-3.0
- Created: 2018-10-21T05:26:38.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2025-03-06T01:49:17.000Z (3 months ago)
- Last Synced: 2025-03-06T02:36:36.482Z (3 months ago)
- Topics: bookmark, chrome-extension, painless, productivity, read-it-later, read-later, temprorary-bookmark
- Language: JavaScript
- Homepage: https://chrome.google.com/webstore/detail/fbmfcfkokefgbmfcjahdmomlifclekib/
- Size: 10.9 MB
- Stars: 69
- Watchers: 4
- Forks: 4
- Open Issues: 7
-
Metadata Files:
- Readme: .github/README.md
- License: LICENSE
Awesome Lists containing this project
README
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](https://chrome.google.com/webstore/detail/fbmfcfkokefgbmfcjahdmomlifclekib/) 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](https://github.com/willbchang/chrome-read-later/releases/latest).
2. Unzip it and move it to the safe path(you won't delete it accidentally).
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 History**: Save the reading list history locally.
### Status Bar
- **Row Number : Total Count**
- **History Icon**: Click to toggle(on/off) history mode.
- **Options Icon**: Click to open options page.
- **Question Icon**: Click to open the documentation & feedback page.
## 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 |
| On/Off history mode | Click History icon | \ | H |
| Open settings page | Click Settings icon | \ | , |
| Open documentation & feedback site | Click Question icon | \ | ? |
| Show full title and link | `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**.
- The maximum reading list in cloud is up to 250 items, due to google's limits.
- It may be slow if the reading list in history is near 10,000 items.
## 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](https://github.com/Yasujizr).
- Delete icon is made by [Freepik](https://www.flaticon.com/authors/freepik)
- Icons in status bar are [Octicons](https://primer.style/octicons/).
- I use [RubyMine](https://www.jetbrains.com/ruby/) 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](LICENSE)