Awesome
Twine - RSS Reader
Twine is a multiplatform RSS reader app built using Kotlin and Compose Multiplatform. It features an nice user interface and experience to browse through the feeds, and supports Material 3 content based dynamic theming.
Download
<a href='https://play.google.com/store/apps/details?id=dev.sasikanth.rss.reader&pcampaignid=pcampaignidMKT-Other-global-all-co-prtnr-py-PartBadge-Mar2515-1'><img alt='Get it on Google Play' src='https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png' width="200px"/></a> <a href="https://apps.apple.com/us/app/twine-rss-reader/id6465694958?itsct=apps_box_badge&itscg=30200" style="display: inline-block; overflow: hidden; border-radius: 13px;"><img src="https://tools.applemediaservices.com/api/badges/download-on-the-app-store/white/en-us;releaseDate=1694390400" alt="Download on the App Store" width="200px"></a>
Screenshots
<p style="text-align: center;"> <img src="readme_images/home.png" width="250" alt="Home Screen"/> <img src="readme_images/home_scrolled.png" width="250" alt="Home Screen Scrolled"/> <img src="readme_images/feeds_sheet.png" width="250" alt="Feeds Sheet"/> <img src="readme_images/feeds_sheet_add_feed.png" width="250" alt="Add Feed"/> <img src="readme_images/feeds_sheet_edit.png" width="250" alt="Edit Feeds"/> <img src="readme_images/search.png" width="250" alt="Search Screen"/> <img src="readme_images/bookmarks.png" width="250" alt="Bookmarks Screen"/> <img src="readme_images/settings.png" width="250" alt="Settings Screen"/> <img src="readme_images/reader_screen.png" width="250" alt="Reader Screen"/> </p>Features ✨
- Supports RSS & Atom feeds
- Feed management: Add, Edit & Pin feeds
- Feed grouping
- Access to pinned feeds/groups from bottom bar
- Smart fetching: Twine looks for feeds when given any website homepage
- Article shortcut to fetch full article in reader view
- Bookmark posts to read later
- Search posts
- Background sync
- Import and exports your feeds with OPML
- Dynamic content theming
- Light/Dark mode support
Tech Stack 📚
- Kotlin Multiplatform
- Kotlin Coroutines
- Compose Multiplatform
- Ktor
- SQLDelight
- Decompose
- Kotlin-inject
For full list of dependencies used, please take a look at the catalog file.
Development 🛠️
You can just clone the repo and build it locally without requiring any changes.
Project requires JDK 20+, and based on the AGP version defined in libs.versions.toml
file,
you can use appropriate Android Studio to import the project.
Contributing 🛠️
You can contribute bug fixes to the project via PRs, for anything else open an issue to start a conversation.
This project uses ktfmt, provided via the spotless gradle plugin, and the bundled project IntelliJ codestyle. Run
./gradlew spotlessApply
to format the code before raising a PR.
Made by ❤️
- Sasikanth Miriyampalli / Development
- Eduardo Pratti / Design
Error Reporting by
<a href="http://www.bugsnag.com/"> <img src="readme_images/bugsnag.png" width="250" alt="bugsnag logo"/> </a>License
Copyright Sasikanth Miriyampalli
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
https://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.