Skip to content

Commit 5f3b1a2

Browse files
committed
Add README
1 parent c31cb72 commit 5f3b1a2

File tree

2 files changed

+141
-0
lines changed

2 files changed

+141
-0
lines changed

README.CN.md

Lines changed: 69 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
1+
一个用于 Tiny Tiny RSS 的插件,通过 [Ntfy](https://ntfy.sh/)
2+
推送订阅源更新提醒。
3+
4+
## 功能特点
5+
6+
- 支持通过 Ntfy 发送 RSS 订阅更新通知
7+
- 可配合 TT-RSS 过滤推送通知
8+
9+
## 安装步骤
10+
11+
1. 下载本插件到 TT-RSS 的插件目录:
12+
13+
```bash
14+
cd /path/to/tt-rss/plugins
15+
git clone https://github.com/resticDOG/tt-rss-plgin-ntfy.git ntfy
16+
```
17+
18+
1. 在 TT-RSS 管理界面启用插件:
19+
- 进入偏好设置 -> 插件
20+
- 找到 "Ntfy"
21+
- 点击启用
22+
23+
## 配置说明
24+
25+
1. 在插件设置中配置以下参数:
26+
- Ntfy 服务器地址 (例如: <https://ntfy.sh>)
27+
- 通知主题 (Topic)
28+
- Token
29+
30+
![image.png](https://img.linkzz.eu.org/main/images/2024/10/2db2ec2587ca9d38d05d581ab209c25b.png)
31+
32+
## 使用方法
33+
34+
### 1. 订阅源启用
35+
36+
在订阅源编辑页面启用插件,当订阅源更新之后推送
37+
38+
![image.png](https://img.linkzz.eu.org/main/images/2024/10/fda8b59913cbd5a6b3a8dc56f993bf1d.png)
39+
40+
### 1. 结合过滤功能启用
41+
42+
创建一个过滤器,在应用操作中选择 **Invoke plugin**: **Ntfy: Send Notification**
43+
44+
![image.png](https://img.linkzz.eu.org/main/images/2024/10/623b8bec5f8a53b86cb4de8cf63b762c.png)
45+
46+
### 故障排除
47+
48+
如果遇到问题,请检查:
49+
50+
1. PHP curl 扩展是否已安装
51+
2. Ntfy 服务器地址是否正确
52+
3. TT-RSS 日志中是否有相关错误信息
53+
54+
### 贡献指南
55+
56+
欢迎提交 Pull Requests 和 Issues!
57+
58+
### 致谢
59+
60+
- [Tiny Tiny RSS](https://tt-rss.org/)
61+
- [Ntfy](https://ntfy.sh/)
62+
- [mercury_fulltext](https://github.com/HenryQW/mercury_fulltext)
63+
64+
### 联系方式
65+
66+
如有问题或建议,请通过以下方式联系:
67+
68+
- 提交 [Issue](https://github.com/resticDOG/tt-rss-plugin-ntfy/issues)
69+
- Pull Requests

README.md

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
[中文](./README.CN.md)
2+
3+
## Features
4+
5+
- Supports sending RSS feed update notifications via Ntfy
6+
- Can be used with TT-RSS filters to control notifications
7+
8+
## Installation
9+
10+
1. Clone this plugin to the TT-RSS plugin directory:
11+
12+
```bash
13+
cd /path/to/tt-rss/plugins
14+
git clone https://github.com/resticDOG/tt-rss-plugin-ntfy.git ntfy
15+
```
16+
17+
2. Enable the plugin in the TT-RSS admin interface:
18+
- Go to Preferences -> Plugins
19+
- Find "Ntfy"
20+
- Click Enable
21+
22+
## Configuration
23+
24+
1. Configure the following parameters in the plugin settings:
25+
- Ntfy server address (e.g., <https://ntfy.sh>)
26+
- Notification topic (Topic)
27+
- Token
28+
29+
![image.png](https://img.linkzz.eu.org/main/images/2024/10/2db2ec2587ca9d38d05d581ab209c25b.png)
30+
31+
## Usage
32+
33+
### 1. Enable for a Feed
34+
35+
Enable the plugin on the feed edit page to push notifications when the feed
36+
updates.
37+
38+
![image.png](https://img.linkzz.eu.org/main/images/2024/10/fda8b59913cbd5a6b3a8dc56f993bf1d.png)
39+
40+
### 2. Enable with Filter
41+
42+
Create a filter and select **Invoke plugin**: **Ntfy: Send Notification** in the
43+
actions.
44+
45+
![image.png](https://img.linkzz.eu.org/main/images/2024/10/623b8bec5f8a53b86cb4de8cf63b762c.png)
46+
47+
### Troubleshooting
48+
49+
If you encounter issues, check:
50+
51+
1. Whether the PHP curl extension is installed
52+
2. If the Ntfy server address is correct
53+
3. TT-RSS logs for related error messages
54+
55+
### Contribution Guide
56+
57+
Pull Requests and Issues are welcome!
58+
59+
### Acknowledgments
60+
61+
- [Tiny Tiny RSS](https://tt-rss.org/)
62+
- [Ntfy](https://ntfy.sh/)
63+
- [mercury_fulltext](https://github.com/HenryQW/mercury_fulltext)
64+
65+
### Contact
66+
67+
For questions or suggestions, please contact via:
68+
69+
- Submit an [Issue](https://github.com/resticDOG/tt-rss-plugin-ntfy/issues)
70+
- Pull Requests
71+
72+
---

0 commit comments

Comments
 (0)