TeleMediaSpider - Telegram 频道资源爬虫

## 声明
***仅限个人用途使用。***

## 介绍
[TeleMediaSpider](https://github.com/liesauer/TeleMediaSpider) 是一个开源的用于抓取 Telegram 频道资源的个人爬虫，支持抓取 `图片` `视频` `音频` `文件`，支持多频道同时下载，支持断点续抓。

![2024-06-08_163123.jpg](https://storage.liesauer.net/2024/06/1928292490.jpg)

仓库地址：https://github.com/liesauer/TeleMediaSpider

## 使用说明

### 0. 下载
已打包好的 `TeleMediaSpider` 可在这里下载：[https://github.com/liesauer/TeleMediaSpider/releases](https://github.com/liesauer/TeleMediaSpider/releases)，包含 `Windows x64` `Linux x64` 多个版本，如需其他版本，请自行打包。

### 1. 首次运行
第一次运行时，会自动生成 `data/config.toml` 配置文件，需要配置以下内容：
`account.apiId`（参考文档）
`account.apiHash`（参考文档）
`account.account`（Telegram账号）
~~`account.session`~~（这个不需要填）

参考：
[Authentication | GramJS](https://gram.js.org/getting-started/authorization#getting-api-id-and-api-hash)

代理看情况配置，可参考[Using MTProxies and Socks5 Proxies.](https://gram.js.org/getting-started/authorization#using-mtproxies-and-socks5-proxies)。

### 2. 获取频道列表
```bash
TeleMediaSpider --list
```
列举出你账号加入的所有频道，复制频道ID，并打开 `data/config.toml` 配置文件，配置以下内容：
`spider.channels`

示例：
```toml
[spider]
channels = [ "频道id1", "频道id2" ]
```

如何抓取自己的已保存信息？
使用固定的频道id：`me` 即可，其他不变。

默认抓取频道的`图片` `视频` `音频` `文件`，如果你想特定的频道只抓取特定的数据，也可自由配置，有效值：`photo` `video` `audio` `file`。

将以下配置
```toml
[spider]
medias = { }
```
修改为
```toml
[spider]
  [spider.medias]
  频道id1 = "photo"
  频道id2 = "photo,video,audio,file"
```

### 3. 正式抓取
直接运行 `TeleMediaSpider`，爬虫将会自动抓取频道信息，自动获取新消息，支持断点续爬，可任意时刻随意关闭软件。

## 4. 并发下载
**注意：这并不是传统意义上的并发下载，而是指多频道同时下载，单一频道只能一条一条信息从前往后解析下载。**

将以下配置
```toml
[spider]
concurrency = 5
```
修改为你想要的多频道同时下载数，默认为5个频道同时下载。

# 数据保存
所有数据都保存在 `data/{频道id}` 文件夹下，文件名格式：`{频道id}_{消息id}[_{原文件名}]`。