Add URLs to pyproject
Add instructions to readme
This commit is contained in:
parent
55a99049ef
commit
4c84f40e0e
2 changed files with 63 additions and 32 deletions
75
README.md
75
README.md
|
@ -2,43 +2,56 @@
|
||||||
|
|
||||||
## Slixfeed
|
## Slixfeed
|
||||||
|
|
||||||
Slixfeed aims to be an easy to use and fully-featured news aggregator bot for XMPP. It provides a convenient access to Blogs, Fediverse and News websites along with filtering functionality.
|
Slixfeed aims to be an easy to use and fully-featured news aggregator bot for XMPP. It provides a convenient access to Blogs, Fediverse (i.e. Akkoma, Mastodon, Misskey, Pleroma etc.) and News websites.
|
||||||
|
|
||||||
Slixfeed is primarily designed for XMPP (aka Jabber).
|
|
||||||
|
|
||||||
Visit https://xmpp.org/software/ for more information.
|
|
||||||
|
|
||||||
## XMPP
|
## XMPP
|
||||||
|
|
||||||
XMPP is the Extensible Messaging and Presence Protocol, a set of open technologies for instant messaging, presence, multi-party chat, voice and video calls, collaboration, lightweight middleware, content syndication, and generalized routing of XML data.
|
XMPP is the Extensible Messaging and Presence Protocol, a set of open technologies for instant messaging, presence, multi-party chat, voice and video calls, collaboration, lightweight middleware, content syndication, and generalized routing of XML data.
|
||||||
|
|
||||||
Visit https://xmpp.org/about/ for more information on the XMPP protocol.
|
Visit https://xmpp.org/about/ for more information on the XMPP protocol and https://xmpp.org/software/ for list of XMPP clients.
|
||||||
|
|
||||||
|
Slixfeed is primarily designed for XMPP (aka Jabber), yet it is built to be extended to other protocols.
|
||||||
|
|
||||||
|
### Features
|
||||||
|
|
||||||
|
#### Simultaneous
|
||||||
|
|
||||||
|
Slixfeed is designed to handle multiple contacts, including groupchats, Simultaneously.
|
||||||
|
|
||||||
|
#### Ease
|
||||||
|
|
||||||
|
Slixfeed automatically scans (i.e. crawls) for web feeds of given URL.
|
||||||
|
|
||||||
|
#### Filtering
|
||||||
|
|
||||||
|
Slixfeed provides positive and nagative ways to filter by allow and deny lists.
|
||||||
|
|
||||||
|
#### Proxy
|
||||||
|
|
||||||
|
Redirect to alternative online back-ends, such as Invidious, Librarian, Nitter, for increased privacy and productivity and security.
|
||||||
|
|
||||||
## Getting Started
|
## Getting Started
|
||||||
|
|
||||||
|
### Install
|
||||||
|
|
||||||
```
|
```
|
||||||
$ python __main__.py
|
$ pipx install git+https://gitgud.io/sjehuda/slixfeed
|
||||||
Username:
|
|
||||||
Password:
|
|
||||||
```
|
```
|
||||||
|
|
||||||
## Usage
|
### Start
|
||||||
- Start bot;
|
|
||||||
- Add contact JID of Slixfeed to your roster;
|
|
||||||
- Open chat with Slixfeed;
|
|
||||||
- Add news source by sending a `<url>` (in groupchat, use `!<url>`).
|
|
||||||
|
|
||||||
### Feeds
|
|
||||||
Example feeds you can subscribe to.
|
|
||||||
```
|
```
|
||||||
https://xmpp.org/feeds/all.atom.xml
|
$ slixfeed
|
||||||
https://takebackourtech.org/rss/
|
|
||||||
https://redecentralize.org/podcast/feed.rss
|
|
||||||
http://hackerpublicradio.org/hpr_ogg_rss.php
|
|
||||||
https://www.blacklistednews.com/rss.php
|
|
||||||
https://theconsciousresistance.com/feed/
|
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### Usage
|
||||||
|
|
||||||
|
- Start a chat with the bot and follow it instructions.
|
||||||
|
- Send command `help` or `commands` for a list of commands.
|
||||||
|
|
||||||
## Roadmap
|
## Roadmap
|
||||||
|
|
||||||
|
- Add service interface;
|
||||||
- Improve asynchronism hadling;
|
- Improve asynchronism hadling;
|
||||||
- Improve logging and error handling;
|
- Improve logging and error handling;
|
||||||
- Add daemon interface;
|
- Add daemon interface;
|
||||||
|
@ -46,31 +59,37 @@ https://theconsciousresistance.com/feed/
|
||||||
- Add feed history tables of last week and last month.
|
- Add feed history tables of last week and last month.
|
||||||
|
|
||||||
## Authors
|
## Authors
|
||||||
|
|
||||||
|
- [Laura](xmpp:lauranna@404.city?message) (Co-Author, Instructor and Mentor).
|
||||||
- [Schimon](xmpp:sch@pimux.de?message) (Author).
|
- [Schimon](xmpp:sch@pimux.de?message) (Author).
|
||||||
- [Laura](xmpp:lauranna@404.city?message) (Instructor, Mentor and Co-Author).
|
|
||||||
|
|
||||||
## Acknowledgment
|
## Acknowledgment
|
||||||
|
|
||||||
Special thank you to Mrs. Lapina who instructed me all the way to complete this, in addition to significant code fixes.
|
Special thank you to Mrs. Lapina who instructed me all the way to complete this, in addition to significant code fixes.
|
||||||
|
|
||||||
Laura, I thank you greatly for your encouragement, time and help.
|
Laura, I thank you greatly for your encouragement, time and help. This bot would not have existed without you.
|
||||||
|
|
||||||
May this bot be a life changing factor to people the world over.
|
May this bot be a life changing factor to people the world over.
|
||||||
|
|
||||||
This bot would not be a reality without you.
|
|
||||||
|
|
||||||
## License
|
## License
|
||||||
MIT license
|
|
||||||
|
MIT license.
|
||||||
|
|
||||||
## Copyright
|
## Copyright
|
||||||
- Schimon Zackary 2022 - 2023
|
|
||||||
- Laura Lapina 2022 - 2023
|
- Laura Lapina 2022 - 2023
|
||||||
|
- Schimon Zackary 2022 - 2024
|
||||||
|
|
||||||
## Similar Projects
|
## Similar Projects
|
||||||
|
|
||||||
Please visit our friends who offer different approach to convey RSS to XMPP.
|
Please visit our friends who offer different approach to convey RSS to XMPP.
|
||||||
|
|
||||||
* [AtomToPubsub](https://github.com/imattau/atomtopubsub)
|
* [AtomToPubsub](https://github.com/imattau/atomtopubsub)
|
||||||
RSS feeds as XMPP Pubsub Nodes.
|
RSS feeds as XMPP Pubsub Nodes.
|
||||||
|
|
||||||
|
* [err-rssreader](https://github.com/errbotters/err-rssreader)
|
||||||
|
A port of old Brutal's RSS Reader for Errbot.
|
||||||
|
|
||||||
* [feed-to-muc](https://salsa.debian.org/mdosch/feed-to-muc)
|
* [feed-to-muc](https://salsa.debian.org/mdosch/feed-to-muc)
|
||||||
An XMPP bot which posts to a MUC (groupchat) if there is an update in newsfeeds.
|
An XMPP bot which posts to a MUC (groupchat) if there is an update in newsfeeds.
|
||||||
|
|
||||||
|
|
|
@ -35,7 +35,7 @@ keywords = [
|
||||||
"syndication",
|
"syndication",
|
||||||
"xmpp",
|
"xmpp",
|
||||||
]
|
]
|
||||||
urls = {Homepage = "https://gitgud.io/sjehuda/slixfeed"}
|
# urls = {Homepage = "https://gitgud.io/sjehuda/slixfeed"}
|
||||||
dependencies = [
|
dependencies = [
|
||||||
"pyyaml",
|
"pyyaml",
|
||||||
"python-dateutil",
|
"python-dateutil",
|
||||||
|
@ -46,10 +46,22 @@ dependencies = [
|
||||||
"slixmpp",
|
"slixmpp",
|
||||||
]
|
]
|
||||||
|
|
||||||
|
[project.urls]
|
||||||
|
Homepage = "http://slixfeed.i2p/"
|
||||||
|
Repository = "https://gitgud.io/sjehuda/slixfeed"
|
||||||
|
Issues = "https://gitgud.io/sjehuda/slixfeed/issues"
|
||||||
|
|
||||||
|
|
||||||
[project.optional-dependencies]
|
[project.optional-dependencies]
|
||||||
"export as markdown" = ["html2text"]
|
# socks = ["PySocks"]
|
||||||
"export as pdf" = ["pdfkit"]
|
file-export = ["html2text", "pdfkit"]
|
||||||
"readable html" = ["readability-lxml"]
|
readability = ["readability-lxml"]
|
||||||
|
|
||||||
|
# This section returns pep508-identifier error
|
||||||
|
# [project.optional-dependencies]
|
||||||
|
# "export as markdown" = ["html2text"]
|
||||||
|
# "export as pdf" = ["pdfkit"]
|
||||||
|
# "readable html" = ["readability-lxml"]
|
||||||
|
|
||||||
# [project.readme]
|
# [project.readme]
|
||||||
# text = "Slixfeed is a news aggregator bot for online news feeds. This program is primarily designed for XMPP"
|
# text = "Slixfeed is a news aggregator bot for online news feeds. This program is primarily designed for XMPP"
|
||||||
|
|
Loading…
Reference in a new issue