%global _empty_manifest_terminate_build 0 Name: python-r2k Version: 0.7.4 Release: 1 Summary: A tool that lets you periodically send articles received from an RSS feed to your Kindle License: MIT URL: https://github.com/mcouthon/r2k Source0: https://mirrors.nju.edu.cn/pypi/web/packages/d7/4d/7893785f01ea662a4d132ce903fcfa55e19382af29e9d83fa01cd26f1e87/r2k-0.7.4.tar.gz BuildArch: noarch Requires: python3-docker Requires: python3-feedparser Requires: python3-click Requires: python3-pyyaml Requires: python3-beautifulsoup4 Requires: python3-pick Requires: python3-dateutil Requires: python3-orjson Requires: python3-requests Requires: python3-chardet Requires: python3-lxml Requires: python3-cssselect Requires: python3-arrow %description # R2K (RSS to Kindle) `r2k` is a tool that lets you to track your favorite RSS/Atom feeds, and send cleaned-up (i.e. only text and images) articles received from them directly to your Kindle. [Installation](#installation) [Cleaning up the articles](#cleaning-up-the-articles) [Usage](#usage) ## Installation The best way to get up and running with `r2k` us to use pipx. Simply run: ```bash pipx install r2k ``` If you're not using `pipx` (you should!), `pip install r2k` will also do. If you want to add `r2k` to your Poetry project, run `poetry add r2k`. ## Cleaning up the articles There are currently 3 ways to clean up articles: 1. The default is using the `readability` Python implementation. It doesn't require any extra steps or installations, and thus is the easiest to use. It is, however, a bit less precise than the other 2 methods. 1. Using the [PushToKindle](http://pushtokindle.com/) service. The service works by attaching an email address that forwards cleaned up versions of URLs to your Kindle. It's free for a certain amount of articles, but you need to become their supporter afterward. 1. Using a dockerized version of the [Mercury-Parser](https://github.com/postlight/mercury-parser). This method requires Docker, but is marginally better than the `readability` approach. ## Usage ### Preparations #### If you're using PushToKindle (PTK) The free version of PTK only allows for 25 articles to be sent using their service. After this, you'll have to become their "sustainer" (for as low as 1$/month) on Patreon [here](https://www.patreon.com/bePatron?c=1946606). Before using `r2k` with PTK you need to: 1. Know your kindle email address (find it [here](https://www.amazon.com/mycd), under "Preferences" -> "Personal Document Settings"). 2. Add `kindle@fivefilters.org` to the list of approved email senders (in the same place in Amazon's settings). ### Set up your configuration file Most of what `r2k` does involves the configuration file, in which the feeds you're subscribed to are kept, as well as some other data. After installation, run: ```bash r2k config init [-p CONFIG_PATH] ``` The default location for the config YAML file is in `~/.r2k/config.yml`. During the init you'll be asked several questions (like your kindle email address). To see your configuration run: ```bash r2k config show [-p CONFIG_PATH] ``` #### Adding your GMail credentials Currently `r2k` relies on the fact that you have a GMail address, and it requires a [Google App Password](https://support.google.com/accounts/answer/185833?hl=en&authuser=1). These are useful in cases where you don't want to go through 2FA authentication. Go [here](https://myaccount.google.com/u/1/apppasswords) to generate an `r2k` App Password, and add it to the configuration. ### Add some RSS subscriptions #### Using an OPML file The [OPML](https://en.wikipedia.org/wiki/OPML) format is widely used in the RSS/Atom world (as well as in podcasting and other areas) to represent a collection of feeds. You can export your existing subscriptions from most feed readers into an OPML file. To load all of your subscriptions in one move run: ```bash r2k feed import PATH_TO_OPML_FILE ``` #### Manually adding feeds If you don't have an OPML export, or just want to add a single feed you can run: ```bash r2k feed add -t FEED_TITLE -u FEED_URL ``` If the `FEED_URL` is a proper RSS feed (i.e. an actual XML feed URL), it will be added as is. If the `FEED_URL` is a regular URL, `r2k` will attempt to find the RSS feed by analyzing the page source. In the case of multiple candidates (e.g. WordPress content feed and comment feed), you will be presented with a list of choices. ### Send updates to your Kindle Right now the "periodical" part of `r2k` is not yet operational. In order to send updates to your Kindle you'll have to run: ```bash r2k kindle send [-f FEED_TITLE] ``` If you don't pass the `-f/--feed-title` option, updates will be sent for all of your subscriptions. The first time that `kindle send` is run for any feed, you will be presented with a list of all the available articles in the feed (note that RSS feeds usually only keep a subset of the most recent entries), and will be asked to choose the last one you've already read. This is to avoiding sending you any article you've already consumed. %package -n python3-r2k Summary: A tool that lets you periodically send articles received from an RSS feed to your Kindle Provides: python-r2k BuildRequires: python3-devel BuildRequires: python3-setuptools BuildRequires: python3-pip %description -n python3-r2k # R2K (RSS to Kindle) `r2k` is a tool that lets you to track your favorite RSS/Atom feeds, and send cleaned-up (i.e. only text and images) articles received from them directly to your Kindle. [Installation](#installation) [Cleaning up the articles](#cleaning-up-the-articles) [Usage](#usage) ## Installation The best way to get up and running with `r2k` us to use pipx. Simply run: ```bash pipx install r2k ``` If you're not using `pipx` (you should!), `pip install r2k` will also do. If you want to add `r2k` to your Poetry project, run `poetry add r2k`. ## Cleaning up the articles There are currently 3 ways to clean up articles: 1. The default is using the `readability` Python implementation. It doesn't require any extra steps or installations, and thus is the easiest to use. It is, however, a bit less precise than the other 2 methods. 1. Using the [PushToKindle](http://pushtokindle.com/) service. The service works by attaching an email address that forwards cleaned up versions of URLs to your Kindle. It's free for a certain amount of articles, but you need to become their supporter afterward. 1. Using a dockerized version of the [Mercury-Parser](https://github.com/postlight/mercury-parser). This method requires Docker, but is marginally better than the `readability` approach. ## Usage ### Preparations #### If you're using PushToKindle (PTK) The free version of PTK only allows for 25 articles to be sent using their service. After this, you'll have to become their "sustainer" (for as low as 1$/month) on Patreon [here](https://www.patreon.com/bePatron?c=1946606). Before using `r2k` with PTK you need to: 1. Know your kindle email address (find it [here](https://www.amazon.com/mycd), under "Preferences" -> "Personal Document Settings"). 2. Add `kindle@fivefilters.org` to the list of approved email senders (in the same place in Amazon's settings). ### Set up your configuration file Most of what `r2k` does involves the configuration file, in which the feeds you're subscribed to are kept, as well as some other data. After installation, run: ```bash r2k config init [-p CONFIG_PATH] ``` The default location for the config YAML file is in `~/.r2k/config.yml`. During the init you'll be asked several questions (like your kindle email address). To see your configuration run: ```bash r2k config show [-p CONFIG_PATH] ``` #### Adding your GMail credentials Currently `r2k` relies on the fact that you have a GMail address, and it requires a [Google App Password](https://support.google.com/accounts/answer/185833?hl=en&authuser=1). These are useful in cases where you don't want to go through 2FA authentication. Go [here](https://myaccount.google.com/u/1/apppasswords) to generate an `r2k` App Password, and add it to the configuration. ### Add some RSS subscriptions #### Using an OPML file The [OPML](https://en.wikipedia.org/wiki/OPML) format is widely used in the RSS/Atom world (as well as in podcasting and other areas) to represent a collection of feeds. You can export your existing subscriptions from most feed readers into an OPML file. To load all of your subscriptions in one move run: ```bash r2k feed import PATH_TO_OPML_FILE ``` #### Manually adding feeds If you don't have an OPML export, or just want to add a single feed you can run: ```bash r2k feed add -t FEED_TITLE -u FEED_URL ``` If the `FEED_URL` is a proper RSS feed (i.e. an actual XML feed URL), it will be added as is. If the `FEED_URL` is a regular URL, `r2k` will attempt to find the RSS feed by analyzing the page source. In the case of multiple candidates (e.g. WordPress content feed and comment feed), you will be presented with a list of choices. ### Send updates to your Kindle Right now the "periodical" part of `r2k` is not yet operational. In order to send updates to your Kindle you'll have to run: ```bash r2k kindle send [-f FEED_TITLE] ``` If you don't pass the `-f/--feed-title` option, updates will be sent for all of your subscriptions. The first time that `kindle send` is run for any feed, you will be presented with a list of all the available articles in the feed (note that RSS feeds usually only keep a subset of the most recent entries), and will be asked to choose the last one you've already read. This is to avoiding sending you any article you've already consumed. %package help Summary: Development documents and examples for r2k Provides: python3-r2k-doc %description help # R2K (RSS to Kindle) `r2k` is a tool that lets you to track your favorite RSS/Atom feeds, and send cleaned-up (i.e. only text and images) articles received from them directly to your Kindle. [Installation](#installation) [Cleaning up the articles](#cleaning-up-the-articles) [Usage](#usage) ## Installation The best way to get up and running with `r2k` us to use pipx. Simply run: ```bash pipx install r2k ``` If you're not using `pipx` (you should!), `pip install r2k` will also do. If you want to add `r2k` to your Poetry project, run `poetry add r2k`. ## Cleaning up the articles There are currently 3 ways to clean up articles: 1. The default is using the `readability` Python implementation. It doesn't require any extra steps or installations, and thus is the easiest to use. It is, however, a bit less precise than the other 2 methods. 1. Using the [PushToKindle](http://pushtokindle.com/) service. The service works by attaching an email address that forwards cleaned up versions of URLs to your Kindle. It's free for a certain amount of articles, but you need to become their supporter afterward. 1. Using a dockerized version of the [Mercury-Parser](https://github.com/postlight/mercury-parser). This method requires Docker, but is marginally better than the `readability` approach. ## Usage ### Preparations #### If you're using PushToKindle (PTK) The free version of PTK only allows for 25 articles to be sent using their service. After this, you'll have to become their "sustainer" (for as low as 1$/month) on Patreon [here](https://www.patreon.com/bePatron?c=1946606). Before using `r2k` with PTK you need to: 1. Know your kindle email address (find it [here](https://www.amazon.com/mycd), under "Preferences" -> "Personal Document Settings"). 2. Add `kindle@fivefilters.org` to the list of approved email senders (in the same place in Amazon's settings). ### Set up your configuration file Most of what `r2k` does involves the configuration file, in which the feeds you're subscribed to are kept, as well as some other data. After installation, run: ```bash r2k config init [-p CONFIG_PATH] ``` The default location for the config YAML file is in `~/.r2k/config.yml`. During the init you'll be asked several questions (like your kindle email address). To see your configuration run: ```bash r2k config show [-p CONFIG_PATH] ``` #### Adding your GMail credentials Currently `r2k` relies on the fact that you have a GMail address, and it requires a [Google App Password](https://support.google.com/accounts/answer/185833?hl=en&authuser=1). These are useful in cases where you don't want to go through 2FA authentication. Go [here](https://myaccount.google.com/u/1/apppasswords) to generate an `r2k` App Password, and add it to the configuration. ### Add some RSS subscriptions #### Using an OPML file The [OPML](https://en.wikipedia.org/wiki/OPML) format is widely used in the RSS/Atom world (as well as in podcasting and other areas) to represent a collection of feeds. You can export your existing subscriptions from most feed readers into an OPML file. To load all of your subscriptions in one move run: ```bash r2k feed import PATH_TO_OPML_FILE ``` #### Manually adding feeds If you don't have an OPML export, or just want to add a single feed you can run: ```bash r2k feed add -t FEED_TITLE -u FEED_URL ``` If the `FEED_URL` is a proper RSS feed (i.e. an actual XML feed URL), it will be added as is. If the `FEED_URL` is a regular URL, `r2k` will attempt to find the RSS feed by analyzing the page source. In the case of multiple candidates (e.g. WordPress content feed and comment feed), you will be presented with a list of choices. ### Send updates to your Kindle Right now the "periodical" part of `r2k` is not yet operational. In order to send updates to your Kindle you'll have to run: ```bash r2k kindle send [-f FEED_TITLE] ``` If you don't pass the `-f/--feed-title` option, updates will be sent for all of your subscriptions. The first time that `kindle send` is run for any feed, you will be presented with a list of all the available articles in the feed (note that RSS feeds usually only keep a subset of the most recent entries), and will be asked to choose the last one you've already read. This is to avoiding sending you any article you've already consumed. %prep %autosetup -n r2k-0.7.4 %build %py3_build %install %py3_install install -d -m755 %{buildroot}/%{_pkgdocdir} if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi pushd %{buildroot} if [ -d usr/lib ]; then find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst fi if [ -d usr/lib64 ]; then find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst fi if [ -d usr/bin ]; then find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst fi if [ -d usr/sbin ]; then find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst fi touch doclist.lst if [ -d usr/share/man ]; then find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst fi popd mv %{buildroot}/filelist.lst . mv %{buildroot}/doclist.lst . %files -n python3-r2k -f filelist.lst %dir %{python3_sitelib}/* %files help -f doclist.lst %{_docdir}/* %changelog * Mon May 29 2023 Python_Bot - 0.7.4-1 - Package Spec generated