RSSpace Quickstart

This simple documentation aims to explain how to get started with the RSSpace plugin for Jetbrains Space.

Introduction

RSSpace was created as an entry for the 2022 Jetbrains Space Application Contest. It's a powerful chatbot application with a full-fledged user interface, easily installable in any Jetbrains Space organization, that allows you to subscribe to unlimited RSS feeds and to get notified whenever new information is accessible.

Installation

In order to install the plugin into your Jetbrains Space organization, simply head over to its Jetbrains Marketplace page:

RSSpace - Space Plugin | MarketplaceJetBrains Marketplace

RSSpace plugin page

Simply click the "Install to Space" button to install it to your organization. After a few seconds, the application will be ready to go! You can then start using it by either talking to the chatbot (by clicking the "Go to chat bot" button) or by using the included UI.

Extension page with "Go to chat bot" button

Usage

Chat commands

Using RSSpace is extremely easy. You have five available commands:

Command	Description	Usage
help	Displays a list of available commands and their usage.	help
list	Displays a list of your currently followed RSS feeds.	list
subscribe	Subscribes to an RSS feed and notifies you whenever new data is available.	subscribe <URL> <Parameter>
unsubscribe	Unsubscribes from an RSS feed you're following.	unsubscribe <URL> | <Name>
bookmarks	Displays all your currently bookmarked items.	bookmarks

For instance, if you subscribe to TechCrunch (using the command subscribe https://techcrunch.com/feed/), you will get notifications resembling this one:

Sample RSS notification

You can add additional parameters to your subscription command. Here is the list of currently available ones:

Parameter	Description	Example usage
Slow mode	Enables slow mode for a subscription.	subscribe https://techcrunch.com/feed/ slow

And you'll be good to go! You can unsubscribe at any time with the unsubscribe command, or list your subscriptions with the list command.

You can customize the appearance of your RSS notifications by accessing the user interface!

User Interface

Since update 2, RSSpace comes with a new user interface in order for you to manage your RSS subscriptions more easily. You can access the UI by either going on the installed RSSpace page for your organization and clicking the "Homepage" tab:

Available tabs

Or by enabling the RSSpace Dashboard tab in your Navigation settings:

Enabling the RSSpace Dashboard tab

Once you access this homepage, you'll be able to manage your RSS subscriptions in a grid format. You just have to press the blue button in the top right corner to create a new one!

Example followed feeds grid

If you encounter issues with the theme (bright background on dark application), please refer to the Frequently asked questions.

You can get more information about the UI in the Navigating the UI page.

What's next?

I am constantly trying to improve this plugin to add more features and innovative functions. I do have pretty nice plans for this application!

Now that the UI is available and polished, I'll keep working on incremental updates to make the whole experience smoother and more interesting. That means more RSS customization options, more feed availability and extra tabs to play around with!