Category:	Reference
Price:	Free
Popularity:	Low
Version String:	2.0.103
Release Date:	2021-01-12
Architecture:	Intel
Minimum OS:	macOS 10.10.0
Vendor Name:	contributors
Homepage:	getpolarized.io

Note:

This app has been discontinued by its vendor, is now longer supported or developed and may no longer be available for download.

Description:

Polar Bookshelf

Polar Bookshelf is personal knowledge repository which supports advanced
features like incremental reading, annotation, comments, and spaced
repetition. It supports reading PDF and the web content and was created
using the Electron framework and PDF.js



FEATURES


- PDF SUPPORT We have first-class PDF support thanks to PDF.js. PDFs
work well when reading content in book format or when reading
scientific research which is often stored as PDF.

- CAPTURED WEB PAGES Download HTML content and save them as offline
documents which can be annotated.

- PAGEMARKS Easily keep track of what you’re reading and the progress
of each document.

- TEXT HIGHLIGHTS Highlight text in PDF and web pages.

- AREA HIGHLIGHTS Capture a region of the page as a highlight which
can be a chart, figure, infographic, etc.

- LOCAL STORAGE All content is stored locally. You can also use a
system like git or Dropbox to transfer your repository across
machines.

- HACKABLE The entire system is based on Electron, Node, pdf.js, React
and other web standards. If you’re a developer - welcome home!

- STANDARDS BASED All content is stored as JSON in a well documented
schema. Annotations never mutate the original content.

- PORTABLE Run across any platform. Linux, MacOS, and Windows
supported. We also product snaps which means you can install our
.deb files on Ubuntu or Debian but also any Linux distribution that
supports snaps!



SCREENSHOTS


PDF Document Polar has excellent PDF support.


Captured Web Content Polar supports fetching and storing web content
locally for annotating.


Annotations Annotating a PDF including pagemarks showing content already
read, an area highlight, and a text highlight.


Repository Polar includes a document repository manager to manage all
your documents, open up a new editor, sort them as a queue or by
priority, etc.



DOWNLOADS


Packages for Windows, MacOS, and Linux are available on the downloads
page.

We also have a CHANGELOG available if you’re interested into what went
into each release.



DISCUSSION


We have both a Discord group and Reddit group if you want to discuss
Polar.

If it’s a very technical issue it might be best to create a Github
Issue.



PERSONAL KNOWLEDGE REPOSITORY


Polar is a document manager for PDF and web content as well as a
personal knowledge repository.

Polar allows you to keep all important reading material in one place
including annotations and flashcards for spaced repetition.

It supports for features like pagemarks, text highlights, and progress
tracking by keeping track of how much you’ve read including restoring
pagemarks when you re-open documents.

Pagemarks are a new concept for tracking your reading inspired from
incremental reading. They allow suspend and resume of reading for weeks
and months in the future until you’re ready to resume, without losing
your place.

Since you can create multiple pagemarks they work even if you jump
around in a book (which is often in technical or research work).



WEB CONTENT


PDF is an excellent document format but we’ve found that many HTML pages
don’t convert to PDF well since they were not intended to be printed.

Captured pages contain HTML content stored in phz (Polar HTML zip)
files.

We fetch all resources, render the page as DOM and apply CSS, then
de-activate the page by removing all scripts.

We then store the content in the phz archive format and serve the
content directly to Electron.

This means you have long term storage for all your content. You can
annotate it and use pagemarks without risk of the content changing.

To capture a new page just select File | Capture Web Page then enter a
URL.

After that the page will be captured and then loaded.



LOCAL STORAGE


All annotations, documents, PHZ files and other data are persisted on
disk in your ~/.polar directory (different on each platform) and when
you re-open a PDF or PHZ file your pagemarks and other annotations are
restored.

Since storage is local you’re not reliant on one specific cloud
provider. You can also use tools like git or Dropbox to synchronize
across machines.



TEXT HIGHLIGHTS




Text highlights allow you to work with content like you’re using a text
highlighter in a book.


Create a text highlight.

Select text you want to highlight then hit Ctrl-Alt-T


Delete a text highlight.

Right click the highlight and select delete.


Key bindings:

- Ctrl-Alt-T - create a new text highlight from the current selected
text.



AREA HIGHLIGHTS




Area highlights allow you highlight a figure, infographic, or anything
visual in a document.


Create an area highlight.

Right click on a page and select “Create area highlight”


Delete an highlight.

Right click the highlight and select delete.



FLASHCARDS




Flashcards allow you to retain information long term by using a spaced
repetition system like Anki to continually re-train yourself on material
you want to retain.

Flashcards can be created by right clicking an annotation and selecting
“Create Flashcard”. The resulting flashcards are stored as annotations
in your repository.

To specify the Anki deck for a document, add a tag starting with deck:.
Slashes are used to specify subdecks. For instance, to set a document to
the Anki deck ML::100PageMLBook, use the Polar tag
deck:ML/100PageMLBook.


Status

This is currently a beta feature and we’re working on implementing Anki
sync to enable spaced repetition. Any flashcards created now will be
stored with Anki in the future.

Polar is very reliable to use for day to day PDF and web content
annotation.

We’re expecting to release a 1.0 in Sept 2018 with Anki sync support and
initial annotation support.



HACKABLE


Since the entire platform is based on Electron (Node + Chromium) the
platform is very easy to work with which means developers can contribute
easily.

Feel free to fork and send a pull request if there’s some interesting
feature you would like to add. Here is a list of good newcomer issues.



DATA


All data is stored on disk in JSON format. This also includes extracted
metadata from the document. For example, text highlights include the
source text that you copied as well as pointers into the original
document where they can be found.



PRINCIPLES


We believe the following design principles are core to seeing this as a
successful project.

- All the data should support long term file formats. The on disk
format we use is JSON.

- Portability to all platforms is critical. We’re initially targeting
Linux (Ubuntu), MacOS, and Windows. You shouldn’t have to pick a
tool, which you might be using for the next 5-10 years, and then get
stuck to a platform which may or may not exist in the future.


Build from source

Install NodeJS and npm for your platform.

To run:

$ git clone https://github.com/burtonator/polar-bookshelf
$ cd polar-bookshelf
$ npm install && npm start



DONATIONS


Polar is supported by community donations

All donations go to supporting Polar which include website hosting
costs, web designer costs, continual integration services, etc.


Contributors

This project exists thanks to all the people who contribute.


Backers

Thank you to all our backers! 🙏


Sponsors

Support this project by becoming a sponsor. Your logo will show up here
with a link to your website.



LICENSE


Polar is distributed under the GPL license.

PDF.js is available under Apache License. Electron is released under MIT
License. Rest of the code is MIT licensed.

Icons made by Freepik from www.flaticon.com is licensed by CC 3.0 BY