# RssMonitorTelegramBot

**Repository Path**: kylelin1998/RssMonitorTelegramBot

## Basic Information

- **Project Name**: RssMonitorTelegramBot
- **Description**: RSS监控最新文章， 如果有监控到最新文章会通知到您设置好的Telegram群聊， 频道， 或者个人号上 支持自定义消息通知， 由你掌控内容
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2023-02-15
- **Last Updated**: 2025-03-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

### [简体中文](./README.md) | English

![License](https://img.shields.io/badge/license-MIT-green)
[![release](https://img.shields.io/github/v/release/kylelin1998/RssMonitorTelegramBot)](https://github.com/kylelin1998/RssMonitorTelegramBot/releases/latest)

## Introduction
Monitor articles for RSS

Send messages of an up-to-date article to your set-up Telegram channel,  group, or personal if you have up-to-date.

Support custom message content to your decision.

## Install & Deploy
Dockerfile and Jar file to save the same directory for building docker image.
```
docker build -t rssb .
```
You need to build logs, config directory on your personal server.

Then, Need to create a file named config.json in config directory.
```
docker run --name rssb -d -v /var/project/RssMonitorBot/logs:/logs -v /var/project/RssMonitorBot/rss-monitor-for-telegram-universal.jar:/app.jar -v /var/project/RssMonitorBot/config:/config  --restart=always rssb
```
## About
My Telegram: <https://t.me/KyleLin1998>

My Telegram Channel(Software, if have a new version, will be in this channel to notify everyone. Welcome to subscribe to it.): <https://t.me/KyleLin1998Channel>

My email: email@kylelin1998.com

## Usage
config.json for example:
```json
{
  "on_proxy": false,
  "proxy_host": "127.0.0.1",
  "proxy_port": 7890,
  "bot_admin_username": "xxxx",
  "bot_admin_id": "xxxx",
  "bot_name": "xxx",
  "bot_token": "xxx",
  "interval_minute": 10,
  "chatIdArray": ["xxxxx"]
}
```
Bot Admin mainly means only you can trigger command to manage monitor plans
* bot_admin_username -> Bot admins username
* bot_admin_id -> Bot admins chat id
* bot_name -> Bot username
* bot_token -> Bot Token
* interval_minute -> Monitor interval(Minute)
* chatIdArray -> Send to chat id list

You need to send commands in the chat interface of the bot to manage monitor plans, command for example:
* /cmd create \<monitor name>
* /cmd list
* /cmd get \<monitor name>
* /cmd update \<monitor name>
* /cmd on \<monitor name>
* /cmd off \<monitor name>
* /cmd test \<monitor name>
* /cmd exit

template:
Support custom message content
* ${link} -> Article website URL
* ${title} -> Article title
* ${author} -> Article author

For example, automatically replace the variable:
```
${title}

${link}
```

![76a8a4773462df933b7b9c53492bd4eef98f49fd.png](https://i.imgur.com/M4zBGla.png)
![b4417bb31dd3b912b7017c95841e3c4e26df710b.png](https://i.imgur.com/9Emxu6T.png)