https://github.com/kattni/rsstodon

A Python script to parse an RSS feed, generate a dynamic string, and send it to Mastodon.
https://github.com/kattni/rsstodon

mastodon python rss-feed-parser

Last synced: about 14 hours ago
JSON representation

A Python script to parse an RSS feed, generate a dynamic string, and send it to Mastodon.

• Host: GitHub
• URL: https://github.com/kattni/rsstodon
• Owner: kattni
• License: gpl-3.0
• Created: 2022-10-19T21:47:15.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2023-01-24T21:20:36.000Z (about 2 years ago)
• Last Synced: 2024-05-02T04:07:30.944Z (9 months ago)
• Topics: mastodon, python, rss-feed-parser
• Language: Python
• Homepage:
• Size: 33.2 KB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# TwitteRSS

## Parse an RSS Feed and Post Content to Twitter and Mastodon

Thank you to @foamyguy for help with the `feedparser` code.

### Code usage

**If you have not already, please complete the prerequisites below before running the script.**

To use this example, from the directory containing the script file, simply run the following from command line:

```commandline

python rss_to_toot.py

```

Note: If Python 2 is your default version, you may need to modify the command to begin with `python3`.

### Prerequisites

1. You must have Python 3 installed on your computer, along with the `pip` installer. If you have not already done so, search for the instructions specific to your computer hardware and operating system.

2. Use `pip` to install the packages within the _requirements.txt_ file. From within the same directory as the _requirements.txt_ file, run the following:

    ```commandline

    pip install -r requirements.txt

    ```

   Note: If Python 3 is not your default version, you may have to modify the command to begin with `pip3`.

3. You must acquire API access for Mastodon. Please check the documentation for Mastodon for information on how to obtain the appropriate token.

   * For Mastodon, this means you should obtain the following:

     * Mastodon access token

4. Once the key is obtained, it should be added to a _keys.py_ file in the same directory as this script, as a string assigned to the following variable.

      * MASTODON_ACCESS_TOKEN

   For example, keys.py should contain something similar to the following:

   ```python

   MASTODON_ACCESS_TOKEN = "yourmastodonaccesstokenhere"

   ```

5. Create an empty file named _string_cache.txt_ in the same directory from which you plan to run this script. The code checks for it and fails with instructions if you have not already done this before running the script.

6. In the `** CUSTOMISATIONS **` section at the beginning of the code, update the variables to your desired settings or content. The customisable options are as follows:

    * Disable sending to Mastodon, by updating `True` shown on the following line to `False`. It defaults to `True` meaning sending is enabled by default.

      ```python

      SEND_TO_MASTODON = True

      ```

    * Update mastodon_server_url to your Mastodon server URL as a string. Defaults to `"https://octodon.social"`.

      ```python

      mastodon_server_url = "https://octodon.social"

      ```

    * Update the feed URL to match the URL of the RSS feed you intend to parse. Defaults to the kattni.com blog RSS feed.

      ```python

      feed = feedparser.parse("https://kattni.com/feeds/all.atom.xml")

      ```

Once you've completed the steps above, you're ready to run the script!