Giter Club home page Giter Club logo

safari-reading-list-recipe's Introduction

Safari Reading List Recipe

Safari is Apple's browser for Mac OS X. The current version includes a feature called Reading List which "lets you save web pages to read or browse later." It is essentially a special set of bookmarks representing a queue of articles you intend to read. Via iCloud, your Reading List can optionally be synced across multiple computers and iOS devices.

Calibre is a free and open source ebook library management application. It features an extensible system "for downloading news from the Internet and converting it into an ebook." The scripts Calibre uses to retrieve and format news are known as recipes. Custom recipes can be written using Calibre's Python recipe API.

This recipe generates an ebook from the Unread items in your Reading List.

Requirements

This recipe will only work on Mac OS X, for the reason that it loads its list of articles from Safari's bookmarks file (~/Library/Safari/Bookmarks.plist) with the help of plutil. It was developed with Safari 5.1.3 on Mac OS X 10.7.3.

Limitations

  • Reading List items are not removed or marked as read. In other words, articles will remain in your Reading List until you manually remove them. (This recipe does not edit or modify your bookmarks file.)
  • Since your Reading List may point to articles on any site, there is no way to anticipate exactly what content to extract. This recipe therefore relies on Calibre's auto_cleanup function, which is derived from Readability. It works pretty OK.
  • Sometimes Safari cannot determine the article title and will just provide the name of the site. This is reflected in the recipe output.
  • Minimal testing has been performed.
  • No error checking is performed.

Installation

In Calibre, select Add a custom news source from the Fetch news toolbar button or menu. Click Load recipe from file and select the SafariReadingList.recipe file downloaded from this repository.

Use

To add items to your Reading List in Safari, select Add to Reading List from the Bookmarks menu. To view and manage your reading list, select Show Reading List from Safari's View menu. Alternatively, click the Reading List button in Safari's toolbar.

To run this recipe and create an ebook from your Unread Reading List items, go to Calibre and select Schedule news download from the Fetch news toolbar button or menu. Locate the Safari Reading List recipe and click Download now. Alternatively, set a schedule for Calibre to automatically update your Safari Reading List ebook.

Remember that this recipe does not remove items from your Reading List, so you'll have to do so yourself. The oldest unread item in your Reading List appears first in the output ebook.

safari-reading-list-recipe's People

Contributors

anoved avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.