Reading List Feeds

[ShindouMihou]

Since August 31, 2022, Amelia has replaced the support of story feeds with reading list feeds (in accordance with ScribbleHub's latest changes which blocked story feeds). Unlike author feeds, reading list feeds have to do some more manual work as Amelia is unable to access your account (obviously) which will turn people off especially authors.

If you want to simply link an author's feed then please read Creating Author Feeds

🎉 What are Reading List Feeds?

Reading list feeds are the RSS feeds that are dedicated to your reading list, you can use this to get notified when new chapter updates come from stories inside your reading list using specialized tools (e.g. Amelia).

In ScribbleHub, there are two kinds of reading list feeds:

1. Global: this reading list feed will list all updates of all your reading lists (including private reading lists).
2. Local: this reading list feed will list all updates only on that specific reading list.

To find your reading list link, you can head to Reading Lists and open the gear icon (⚙️) to find two different RSS feed icons.

You should be able to identify which button leads to the local and global feeds, but to help some people identify them, here are the descriptions of each type of reading list:

1. Global: the global feed is the yellow circle button.
2. Local: the local feed is the blueish-green circle button.

To understand what each type of feed is, we have to understand that we can have more than one feeds and that is what we call a "local" feed.

You can identify what the local feed button will lead to by looking into what reading list is currently being highlighted (in the picture above, we can see that "Reading" is being highlighted which means pressing the local feed button will give us the link to the local reading feed).

Warning

Unless you want to expose your private reading list, NEVER share your reading list feed link as it contains specific secret parameters that can give anyone access to any of your reading lists.

Amelia respects this behavior and redacts the reading list link, you can only view the reading list link if you are the one who created the reading list feed and this is only viewable if you use the /feeds id:[feed id] command.

📆 Creating Reading Lists

Now that we have understood the context of what reading list feeds are, let us delve into how to create these feeds. To first create the feed, we have to get our reading list link. If you haven't skipped the above section then you should be able to know how to find it.

A sample of how a reading list link would look would be:

1. Global: https://www.scribblehub.com/rssfeed.php?type=global&uid=24680&unq=REDACTED
2. Local: https://www.scribblehub.com/rssfeed.php?type=local&uid=24680&unq=REDACTED&lid=1

Once you have the link, you can run the following command in Amelia:

/register list name:[reading_list_name] link:[reading_list_link] channel:[#text-channel]

Note

The following: [reading_list_name], [reading_list_link] and [#text-channel] are placeholders, you should replace them (without the brackets) into their proper value.

Once you send the command, it should result in a success message like this:

If you don't get a success message then it's either:

1. Your reading list is empty and has no stories that have published a chapter.
2. ScribbleHub or Amelia is down or broken.

You can then verify that it is working by running the command:

/feeds

It should send an embed containing all of the server's feeds, for example:

If you need more verification like to see whether it can send messages then you can use the test command which takes in the id of the feed (in our example, it is 5215):

If you have completed all that then congratulations, your feed is working!

💭 How to understand the redacted link?

Amelia redacts all reading list links to prevent exposing all private lists that the feeds have, but we still support finding out what reading list is this registered by giving a minor context which is what we can see with the example below.

Local Reading List Feed

Global Reading List Feed

The Global Reading List Feed should be clear to understand, you are given the link to the user who owns the reading list's profile which means that the feed is specifically for all the reading lists of the user.

It's the local reading list feed where people will definitely be confused, so let us focus on that instead. As you can see in the picture below, we are given the user who owns the reading list's profile link and also what reading list number this feed is.

To identify what reading list this is, we can head to the user's profile by clicking the User text which would bring us to my profile. After which, you can head to the Reading List section before seeing all my reading lists publicly available.

That reading list that we see upon first opening the section is what we call "Reading List No. 1". Our feed wants us to find the Reading List No. 2 therefore we must open the dropdown box and find the second option. (visual, camera quality because cannot screenshot)

In the visual, we can see there are 5 reading lists available and in that five, the one we are looking for is the one we are highlighting (Gir's Love) and that is what we call Reading List No. 2.

🔮 Purpose for Redacting

The purpose for redacting the reading list has to do with private reading lists and the fact that they can be exposed as long as you have the proper credentials from the RSS feed link. I have contacted the relevant people in this and was told that this is intentional behavior therefore Amelia will instead redact the feed link unless you are using the /feeds id:[feed id] command and you are the one who created the feed.

For any further questions, feel free to ask in this discussion and I'll answer as much as possible. ❤️