Package: readwise-reader-cli
Reader API Command-Line InterfaceThis repository provides a command-line interface (CLI) for interacting withReadwise's Reader API. This tool allows you to interact with the API directly from your command line, making it easy toaddandlistdocuments from your Reader library.Also, you canuploaddocuments from your browser reading list, such as Chrome ReadingList.Please note that future updates will include support for additional browsers.InstallationSet up a virtual environment and then run:pipinstallreadwise-reader-cliUsageBefore using the CLI, make sure to set the READER_API_TOKEN environment variable. You can obtain your API tokenhere.exportREADER_API_TOKEN={your_api_token}The CLI provides the following commands:Usage:python-mreadercli[OPTIONS]COMMAND[ARGS]...InteractwithyourReaderLibrary

Options:--helpShowthismessageandexit.

Commands:addAddDocumentlibLibrarybreakdownlistListDocumentsuploadUploadReadingListFilevalidateValidatetokenList DocumentsUsage:python-mreaderclilist[OPTIONS]ListDocuments

Options:-l,--location[new|archive|later|feed]Document(s)location-c,--category[article|tweet|pdf|epub|email|note|video|highlight|rss]Document(s)category-a,--update-after[%Y-%m-%d|%Y-%m-%dT%H:%M:%S|%Y-%m-%d%H:%M:%S]UpdatedafterdateinISOformat.Default:last24hrs.-d,--date-rangeTEXTViewdocumentsupdatedafterchoosentime:today,week,month.-L,--layout[table|list]Displaydocumentseitherasalistortable.Default:table.-n,--num-resultsINTEGERThenumberofdocumentstoshow.-P,--pagerUsetopageoutput.--helpShowthismessageandexit.Examples:python-mreaderclilist--locationarchivepython-mreaderclilist--locationarchive--categoryarticlepython-mreaderclilist--locationarchive--categoryarticle--update-after2023-01-01python-mreaderclilist--locationarchive--categoryarticle--update-after2023-01-01--layoutlistpython-mreaderclilist--locationarchive--categoryarticle--date-rangeweekLayoutsUpload a Reading List (Google Chrome support only)THINGS TO NOTE:RATE LIMIT - Due to Reader's API rate limit of 20 requests per minute, a larger list will take a few minutes to upload.LACK OF READING LIST APIs - There is no API to pull your ReadingList from Google, but it is being looked athere.Touploadyour Chrome Reading List, you first need to download your data from your account, then follow these steps:Navigate to theData & Privacysection.Find the "Download your data" option and click on it.A list of data to export will appear. Click "Deselect all" and then locate the Chrome section.Click "All Chrome data Included" and select ONLY "ReadingList".Save the downloaded.htmlfile to your preferred directory and take note of the file path.Run theimportcommand.Usage:python-mreadercliupload[OPTIONS]INPUT_FILEUploadReadingListFile

Options:--file-type[html|csv]--helpShowthismessageandexit.Examples:python-mreadercliupload/path/to/ReadingList.htmlpython-mreadercliupload--file-typecsv/path/to/ReadingList.csvAdd DocumentUsage:python-mreadercliadd[OPTIONS]URLAddDocument

Options:--helpShowthismessageandexit.Example:python-mreadercliaddhttp://www.example.comLibrary OverviewUsage:python-mreaderclilib[OPTIONS]Librarybreakdown

Options:-V,--view[category|location|tags]--helpShowthismessageandexit.python-mreaderclilibCategoryBreakdown
┏━━━━━━━━━━━━━┳━━━━━━━┓
┃Name┃Count┃
┡━━━━━━━━━━━━━╇━━━━━━━┩
│🖍️highlight│724│
│📡️rss│391│
│✉️email│363│
│📰️article│264│
│📝️note│140│
│📄️pdf│83│
│🐦️tweet│25│
│📹️video│10│
│📖️epub│0│
└─────────────┴───────┘

python-mreaderclilib--view[location|tags]LocationBreakdown
┏━━━━━━━━━━━┳━━━━━━━┓
┃Name┃Count┃
┡━━━━━━━━━━━╇━━━━━━━┩
│🗄️archive│1124│
│🕑️later│241│
│⭐️new│10│
│📥️feed│2│
└───────────┴───────┘

python-mreaderclilib--viewtags

TagsBreakdown
┏━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━┓
┃Name┃Count┃
┡━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━┩
│python│32│
│documentation│9│
│programming│7│
│github│7│
│git│6│
│packages│6│
│design-patterns│6│
│mac│1│
└────────────────────────┴───────┘Validate TokenUsage:python-mreaderclivalidate[OPTIONS]TOKENValidatetoken

Options:--helpShowthismessageandexit.Main Third-Party LibrariesclickpydanticrequestsrichInspirationstarcliLicenseThis project is licensed under the MIT License - see theLICENSEfile for details.