ReadYou/README.md

152 lines
7.1 KiB
Markdown
Raw Normal View History

2022-04-10 17:30:21 +02:00
<div align="center">
2023-01-12 13:26:36 +01:00
<img width="200" height="200" style="display: block; border: 1px solid #f5f5f5; border-radius: 9999px;" src="https://raw.githubusercontent.com/Ashinch/ReadYou/main/fastlane/metadata/android/en-US/images/icon.png">
2022-04-10 17:30:21 +02:00
</div>
<br>
<br>
<br>
<div align="center">
<img alt="GitHub" src="https://img.shields.io/github/license/Ashinch/ReadYou?color=c3e7ff&style=flat-square">
2022-08-08 16:53:48 +02:00
<a target="_blank" href="https://github.com/Ashinch/ReadYou/releases">
<img alt="Version" src="https://img.shields.io/github/v/release/Ashinch/ReadYou?color=c3e7ff&label=version&style=flat-square">
</a>
2022-04-10 17:30:21 +02:00
<img alt="GitHub last commit" src="https://img.shields.io/github/last-commit/Ashinch/ReadYou?color=c3e7ff&style=flat-square">
<br>
<a target="_blank" href="https://t.me/ReadYouApp">
<img alt="Telegram" src="https://img.shields.io/badge/Telegram-ReadYouApp-c3e7ff?logo=telegram&style=flat-square">
</a>
<a target="_blank" href="https://www.figma.com/file/ViBW8GbUgkTMmK6a80h8X1/Read-You?node-id=7028%3A23673">
<img alt="Figma" src="https://img.shields.io/badge/Figma-ReadYou-c3e7ff?logo=figma&style=flat-square">
</a>
</div>
<div align="center">
<h1>Read You</h1>
2023-01-12 13:26:36 +01:00
<p>An Android RSS reader presented in <a target="_blank" href="https://m3.material.io/">Material You</a> style.</p>
<p>English&nbsp;&nbsp;|&nbsp;&nbsp;
2022-05-15 22:28:32 +02:00
<a target="_blank" href="https://github.com/Ashinch/ReadYou/blob/main/README-de.md">Deutsch</a>&nbsp;&nbsp;|&nbsp;&nbsp;
2022-08-08 16:33:26 +02:00
<a target="_blank" href="https://github.com/Ashinch/ReadYou/blob/main/README-zh-CN.md">简体中文</a>&nbsp;&nbsp;|&nbsp;&nbsp;
<a target="_blank" href="https://github.com/Ashinch/ReadYou/blob/main/README-zh-TW.md">繁體中文 (Outdated)</a>&nbsp;&nbsp;|&nbsp;&nbsp;
<a target="_blank" href="https://github.com/Ashinch/ReadYou/blob/main/README-fa.md">فارسی (Outdated)</a></p>
2022-04-10 19:07:39 +02:00
<br/>
<br/>
2023-01-12 13:26:36 +01:00
<img src="https://raw.githubusercontent.com/Ashinch/ReadYou/main/fastlane/metadata/android/en-US/images/startup.png" width="19.2%" alt="startup" />
<img src="https://raw.githubusercontent.com/Ashinch/ReadYou/main/fastlane/metadata/android/en-US/images/feeds.png" width="19.2%" alt="feeds" />
<img src="https://raw.githubusercontent.com/Ashinch/ReadYou/main/fastlane/metadata/android/en-US/images/flow.png" width="19.2%" alt="flow" />
<img src="https://raw.githubusercontent.com/Ashinch/ReadYou/main/fastlane/metadata/android/en-US/images/read.png" width="19.2%" alt="read" />
<img src="https://raw.githubusercontent.com/Ashinch/ReadYou/main/fastlane/metadata/android/en-US/images/settings.png" width="19.2%" alt="settings" />
2022-04-10 19:07:39 +02:00
<br/>
<br/>
2022-04-10 17:30:21 +02:00
</div>
2022-03-08 22:12:19 +01:00
2022-03-20 10:35:17 +01:00
## Features
2022-03-08 22:12:19 +01:00
2023-01-12 13:26:36 +01:00
**Read You** is an Android RSS reader presented in [Material You](https://m3.material.io/) style.
2022-03-20 10:35:17 +01:00
The following are the progress made so far and the goals to be worked on in the near future:
2023-01-12 13:26:36 +01:00
- [x] Subscribe to RSS links
- [x] Import or export OPML files
- [x] Notification of new articles
- [x] Article readability optimization
- [x] Full content parse for original articles
- [x] Multi-account
- [ ] Bionic reading
- [ ] Read aloud
- [ ] Android widget
- [ ] ...
[What am I doing now?](https://github.com/users/Ashinch/projects/2)
2023-01-12 13:26:36 +01:00
## Integration
**Read You** integrates with some of third-party service APIs to support you in using your existing cloud accounts as data sources.
- [x] Fever
- [ ] Google Reader
- [ ] FreshRSS
- [ ] Miniflux
- [ ] Tiny Tiny RSS
- [ ] Inoreader
- [ ] Feedly
- [ ] Feedbin
- [ ] ...
2022-03-08 22:12:19 +01:00
2022-06-22 05:58:23 +02:00
## Download
2023-01-12 13:26:36 +01:00
[<img src="https://s1.ax1x.com/2023/01/12/pSu1a36.png" alt="Get it on GitHub" height="80">](https://github.com/Ashinch/ReadYou/releases)
[<img src="https://s1.ax1x.com/2023/01/12/pSnTZ0f.png"
alt="Get it on Telegram Channel"
height="80">](https://t.me/ReadYouApp)
2022-06-22 05:58:23 +02:00
[<img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png"
alt="Get it on F-Droid"
height="80">](https://f-droid.org/packages/me.ash.reader/)
2023-01-12 13:26:36 +01:00
F-Droid releases can not upgrade to other releases and it is compiled, signed and distributed uniformly by [F-Droid](https://f-droid.org/docs/FAQ_-_General/).
2022-06-22 05:58:23 +02:00
2023-01-12 13:26:36 +01:00
## Sponsor
2022-08-08 16:32:40 +02:00
2023-01-12 13:26:36 +01:00
**Read You** is a free open source software that benefits from the open source community and every user can enjoy it's full functionality for free, so if you appreciate my current work, you can buy me a cup of coffee ☕️.
2023-02-10 06:11:32 +01:00
<a href="https://www.buymeacoffee.com/ashinch"><img width="200px" src="https://img.buymeacoffee.com/button-api/?text=Buy me a coffee&emoji=&slug=ashinch&button_colour=FFDD00&font_colour=000000&font_family=Cookie&outline_colour=000000&coffee_colour=ffffff" /></a>
2023-01-12 13:26:36 +01:00
2023-02-10 06:11:32 +01:00
Thanks for all the love and support ❤️
2023-01-12 13:26:36 +01:00
## Localization
Thank you to each of the **Read You** translators, and if you would like to contribute, please submit a translation via [Weblate](https://hosted.weblate.org/engage/readyou/).
[<img src="https://hosted.weblate.org/widgets/readyou/-/horizontal-auto.svg" alt="" />](https://hosted.weblate.org/engage/readyou/)
2022-08-08 16:32:40 +02:00
2022-03-20 10:35:17 +01:00
## Build
2022-03-08 22:12:19 +01:00
2023-01-12 13:26:36 +01:00
> Welcome to open a [pull request](https://github.com/Ashinch/ReadYou/pulls). [GitHub Actions](https://github.com/Ashinch/ReadYou/actions) automatically packages all flavors of apk files for each commit.
2022-03-08 22:12:19 +01:00
2023-01-12 13:26:36 +01:00
**Read You** is based on [Jetpack Compose](https://developer.android.com/jetpack/compose) toolkit for building Android's native UI.
2022-03-08 22:12:19 +01:00
2022-03-20 10:35:17 +01:00
1. First you need to get the source code of **Read You**.
2022-03-08 22:12:19 +01:00
2023-01-12 13:26:36 +01:00
```shell
git clone https://github.com/Ashinch/ReadYou.git
```
2022-03-08 22:12:19 +01:00
2022-03-20 10:35:17 +01:00
2. Then open it via [Android Studio (latest version)](https://developer.android.com/studio).
2022-03-08 22:12:19 +01:00
2022-03-20 10:35:17 +01:00
3. When you click the `▶ Run` button, it will be built and run automatically.
2022-03-08 22:12:19 +01:00
2022-03-20 10:35:17 +01:00
> In case of lag, please select Release version build.
2022-03-08 22:12:19 +01:00
2022-03-20 10:35:17 +01:00
## Credits
2022-03-08 22:12:19 +01:00
2023-01-12 13:26:36 +01:00
### Open Source Projects
- [MusicYou](https://github.com/Kyant0/MusicYou)
- [ParseRSS](https://github.com/muhrifqii/ParseRSS)
- [Readability4J](https://github.com/dankito/Readability4J)
- [opml-parser](https://github.com/mdewilde/opml-parser)
- [compose-html](https://github.com/ireward/compose-html)
- [Rome](https://github.com/rometools/rome)
- [Feeder](https://gitlab.com/spacecowboy/Feeder)
- [Seal](https://github.com/JunkFood02/Seal)
- [news-flash](https://gitlab.com/news-flash)
- ...
### Special Thanks
2023-01-12 14:03:37 +01:00
[<img src="https://avatars.githubusercontent.com/u/76829190?v=4" width="180" height="180" style="display: block; border: 1px solid #f5f5f5; border-radius: 9999px;"/>](https://github.com/Kyant0)
2023-01-12 13:26:36 +01:00
Thanks to **@Kyant0** for the design inspiration and Monet engine implementation for **Read You**.
2023-01-12 13:26:36 +01:00
[<img src="https://resources.jetbrains.com/storage/products/company/brand/logos/jb_beam.png" width="200" alt="Copyright © 2000-2023 JetBrains s.r.o. JetBrains and the JetBrains logo are registered trademarks of JetBrains s.r.o."/>](https://www.jetbrains.com/)
Thanks to **JetBrains** for allocating free open-source licences for IDEs for **Read You**.
[<img src="https://hosted.weblate.org/widgets/readyou/-/287x66-white.png" width="200"/>](https://hosted.weblate.org/engage/readyou/)
Thanks to **Weblate** for providing free hosting of open source projects for **Read You**.
2022-03-30 17:34:22 +02:00
## License
2023-02-10 06:11:32 +01:00
GNU GPL v3.0 © [Read You](https://github.com/Ashinch/ReadYou/blob/main/LICENSE)