Need help with RSS-Parser?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

prof18
238 Stars 87 Forks Apache License 2.0 200 Commits 2 Opened issues

Description

An Android library to parse a RSS Feed

Services available

!
?

Need anything else?

Contributors list

RSS Parser

Download License API

RSS Parser is an Android library to parse any RSS feed. With RSS Parser, you can fetch plenty of useful information from any RSS channel, be it a blog, magazine, or even a podcast feed.

As of April 2020, it's been downloaded more than 30,000 times from 125 different countries (among them, North Korea, Madagascar and even Panama 🌴).

⚠️ Important Notice

Versions 1.4 and 1.4.1 have been deleted due to a critical dependency error. Please forgive me and update to the latest version available.

Table of Contents

Available data

The RSS channel resulting object provides you with the following data:

  • Title
  • Description
  • Link
  • Articles
  • Image (Title, Url and Link)
  • Last build data
  • Update period

Articles, on the other hand, support the following attributes:

  • Title
  • Author
  • Description
  • Content
  • Main Image
  • Link
  • Publication Date
  • Categories
  • Audio
  • Source (name and link)

Features

Caching

The library provides a caching layer to avoid wasting data with very long feeds. All you need to do is provide an expiration date. For more details, give a look to the Usage section

⚠️ For the time being caching is only supported if you are using Kotlin.

RSS Parsing from string

The library provides a way of simply parsing raw data from a string.

Installation

The library is provided by jCenter, so you can easily add its dependency and be good to go.

dependencies {
  implementation 'com.prof.rssparser:rssparser:2.1.1'
}

Usage

Kotlin

First of all, you have to create a

Parser
object with the Parser Builder. In the builder you can provided some custom and optional fields:
  • A custom
    OkHttpClient
    ; if not provided, the library will create one for you.
  • A custom Charset; if not provided, the default one is
    UTF_8
    .
  • The Android Context, mandatory to make the caching layer work.
  • The cache expiration date in milliseconds, mandatory to make the caching layer work.

If you don't provide the Android Context and the cache expiration date, the library will continue working but without the caching feature.

val parser = Parser.Builder()
                .context(this)
                .charset(Charset.forName("ISO-8859-7"))
                .cacheExpirationMillis(24L * 60L * 60L * 100L) // one day
                .build()

The library uses the Kotlin Coroutines to retrieve, parse and cache the feed. So to start the process, you need to launch the coroutine.

//url of RSS feed
private val url = "https://www.androidauthority.com/feed"

viewModelScope.launch { try { val channel = parser.getChannel(url) // Do something with your data } catch (e: Exception) { e.printStackTrace() // Handle the exception } }

For flushing the cache:

parser.flushCache(url)

For simply parsing raw data: - A

suspend
function
Parser#parser(rawRssFeed)
which returns the channel.
// parser without any network or caching configuration
val parser = Parser.Builder().build()

viewModelScope.launch { try { val channel = parser.parse(raw) // Do something with your data } catch (e: Exception) { e.printStackTrace() // Handle the exception } }

You can give a look to the full Kotlin sample by clicking here

Java

Starting from the version 2.x, the library has been completely rewritten using Kotlin and the coroutines. However, the compatibility with Java has been preserved and the same code of the versions 1.x can still be used.

⚠️ For the time being, the caching is not supported if you are using Java.

If you are still using Java, this is the interface to use the library:

import com.prof.rssparser.Article;
import com.prof.rssparser.OnTaskCompleted;
import com.prof.rssparser.Parser;

Parser parser = new Parser.Builder() .charset(Charset.forName("ISO-8859-7")) // .cacheExpirationMillis() and .context() not called because on Java side, caching is NOT supported .build();

parser.onFinish(new OnTaskCompleted() {

//what to do when the parsing is done
@Override
public void onTaskCompleted(Channel channel) {
    // Use the channel info
}

//what to do in case of error
@Override
public void onError(Exception e) {
    // Handle the exception
}

}); parser.execute(urlString);

For parsing raw data there is a java compatible function which calls the listeners

OnTaskCompleted
and
onError
once done.

Parser.parser(rawRssFeed, OnTaskCompleted)

The full Java sample is available here

Version 1.4.4 and below

For older versions of the library, the interface is marginally different:

import com.prof.rssparser.Article;
import com.prof.rssparser.Parser;

//url of RSS feed String urlString = "http://www.androidcentral.com/feed"; Parser parser = new Parser(); parser.onFinish(new Parser.OnTaskCompleted() {

@Override
public void onTaskCompleted(Channel channel) {
  //what to do when the parsing is done
}

@Override
public void onError() {
  //what to do in case of error
}

}); parser.execute(urlString);

Sample app

I wrote a simple app that shows articles from Android Authority. If in the article's content there isn't an image, a placeholder will be loaded.

The sample is written both in Kotlin and Java. You can browse the Kotlin code here and the Java code here You can also download the apk file to try it!

Please use the issues tracker only to report issues. If you have any kind of question you can ask it on the blog post that I wrote

Changelog

From version 1.4.4 and above, the changelog is available in the release section.

  • 14 December 2017 - Little fixes on Error Management - Version 1.3.1
  • 13 December 2017 - Improved Error Management - Version 1.3
  • 10 December 2017 - Added support for the categories - Version 1.2
  • 12 August 2017 - Fixed the Library Manifest and updated the dependencies - Version 1.1
  • 18 June 2016 - First release - Version 1.0

License

   Copyright 2016-2020 Marco Gomiero

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Apps using RSS Parser

If you are using RSS Parser in your app and would like to be listed here, please open a pull request!

List of Apps using RSS Parser

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.