/dandanplay-resmonitor

弹弹play资源监视器:跨平台动漫资源自动监视+下载的小工具

Primary LanguageC#Apache License 2.0Apache-2.0

弹弹play资源监视器 dandanplay-resmonitor

License GitHub repo size Docker Image Size (latest by date)

Build status DockerHub Github Release

一、介绍

一句话简介

这是一个动漫资源自动监视+下载的小工具。

它能做什么

此工具模拟了 弹弹play播放器 Windows版上的“自动下载”功能,能够根据设定好的监视规则自动检测网上是否有新的资源发布,当发现新的资源后自动通知下载工具新建任务并开始下载。

简单来说,一般从网上找资源的流程是 访问资源站->搜索->选择->下载->观看。此工具可以帮你把 访问资源站->搜索->选择 这前几步变成完全自动的,不用等每次资源有更新时再手动操作一遍了,能为你节省很多时间和精力。

此工具没有内置下载器,但是支持调用已有的 Aria2Transmission 等下载工具进行BT下载。

开发工具

此项目使用 ASP.NET Core 技术编写,编程语言使用了 C#,在 macOS 10.15 下的 Jetbrains Rider IDE 进行开发。SDK版本目前为 .NET Core SDK 3.1.100

付费

为了补贴各种服务器费用和日常开销,本工具虽是开源产品,但并不是免费使用的。试用到期后,您需要赞助作者才可以持续使用。新用户将会在您第一次使用弹弹play登录账号并同步“自动下载规则”后向您赠送7天的免费试用时间。

访问 爱发电 赞助此项目

二、怎样使用

在弹弹play客户端上注册用户并创建规则

  1. 去弹弹play官网 dandanplay.com 下载安装最新版的Windows客户端或UWP客户端

  2. 在首页或者“个人中心”页登录或注册一个新的弹弹play账号

  3. 登录弹弹play账号后,点击上方菜单导航到“资源”-“自动下载”页面

  4. 新建一个“自动下载”规则,填写对应的监视参数。新建完毕后此规则会被自动同步到云端。

在本机运行

  1. Github发布页面下载编译好的最新版本,将所有文件解压到本地的某个文件夹中。目前我们已编译好面向多个操作系统的版本,您可以选择:
  • xxxxxxxx_dotnet.zip 这是通用的版本,可以运行在大部分环境中,但是需要您先安装.NET Core 3.1 运行时或SDK

  • xxxxxxxx_win-x64.zip 这是面向64位Windows编译的版本

  • xxxxxxxx_linux-x64.zip 这是面向64位Linux系统编译的版本

  • xxxxxxxx_osx-x64.zip 这是面向macOS 10.12或以上系统编译的版本

  1. 进入解压后的文件夹,使用文本编辑器软件打开 appsettings.json 文件,修改软件配置。这里将会有一篇详细的说明文档:本机运行。建议修改完成后备份此配置文件,免得将来升级时被不小心覆盖。

  2. 之后即可运行此程序了:

  • 对于通用版(dotnet.zip),使用命令行(cmd、Terminal等)进入此文件夹,然后执行 dotnet ResourceMonitor.dll 命令,即可启动。

  • 对于Windows版(win-x64.zip),直接双击启动 ResourceMonitor.exe 文件

  • 对于Linux版(linux-x64.zip)和macOS版(osx-x64.zip),直接双击启动 ResourceMonitor 文件。

程序启动后将会持续运行,直到你关闭窗口或是按 Ctrl+C 结束进程。

docker镜像部署

DockerHub

  1. 运行命令 docker run -it kaedei/dandanplay-resmonitor 即可启动此工具

  2. 添加 -e 参数可以(通过改变环境变量的方式)自定义程序运行参数。这一步是必需的,详情请参考文档 docker部署

  3. 添加 -d 参数可以让容器在后台持续运行

  4. 添加 -p 本机端口:80 可以暴露内部的web服务,之后通过浏览器访问刚才指定的本机IP和端口(例如 http://192.168.1.100:8080) 即可看到此工具的当前状态。

  5. 此工具的日志文件位于容器内的 /app/log 目录,可以通过 -v 挂载本机目录,然后查看这些日志文件。

三、开发者相关

配置开发环境

  1. 通过 GitHub的打包下载 或通过 git clone 下载最新版的代码到本机目录

  2. 安装 .NET Core SDK 3.1.100 或更高的版本。官方下载链接

  3. 使用 Visual Studio 2019、Rider 等开发工具打开 /ResourceMonitor/ResourceMonitor.sln 文件,即可打开解决方案。

编译代码

  1. 命令行导航到源代码所在目录,例如 C:\code\dandanplay-resmonitor

  2. 进入ResourceMonitor.csproj 所在的文件夹,大概在 C:\code\dandanplay-resmonitor\ResourceMonitor\ResourceMonitor\ResourceMonitor.csproj

  3. 运行命令 dotnet build -c Release 即可以Release模式编译代码,编译后的文件位于 \bin\Release\netcoreapp3.1\publish 文件夹中

其他说明

  • 为了保证程序可以随时启动、终止并保证状态一致,代码中没有设计存储层,即不会将状态保存到外部数据库、Redis、文件系统中。

  • 可以通过扩展实现 IDownloader 接口来支持更多的下载工具