JDRssDownloader/README.md

81 lines
3.0 KiB
Markdown
Raw Normal View History

2022-06-08 14:17:09 +01:00
# JDRssDownloader
2022-06-11 19:03:54 +01:00
JDownloader 2 is a great tool, but since V1 has been missing a way to automatically download from RSS feeds, and filter downloads to only download what you want, in my case 720p HEVC files, MeGusta rips by preference.
2022-06-08 14:17:09 +01:00
I have put together this simple project to allow me to do that, people may find useful.
2022-06-11 19:03:54 +01:00
- Automatically check an RSS feed and send to JDownloader
2022-06-09 20:23:36 +01:00
- Uses MyJDownloader API to allow running on separate system
- Local file cache of RSS feed
- Specify time to check RSS feed
- Specify time to check file cache to send links to JDownloader
- Ability to add multiple shows to check for
- Ability to check for different qualities per show you are looking for
2022-06-18 10:13:36 +01:00
- Ability to turn OFF only HEVC search
2022-06-09 20:23:36 +01:00
2022-06-11 19:03:54 +01:00
# Configuration
2022-06-18 10:13:36 +01:00
There is a `config-sample.json` file that needs to be renamed to `config.json`, after this you can update it with your required settings.
2022-06-08 14:17:09 +01:00
- JDUserName - Your MyJDownloader Username
- JDPassword - Your MyJDownloader Password
2022-06-18 10:13:36 +01:00
- RSSFeed - The url to the rss feed you want to watch (Only tested with - rlsbb)
- RSSFeedRefreshMins - How often to poll your rss feed down to local file cache
2022-06-18 10:13:36 +01:00
- JDPostLinksMins - How often to check your file cache for your shows and send found links to JDownloader
2022-06-08 14:17:09 +01:00
- Autostart - Tells JDownloader to add and start the downloads straight away (true/false)
2022-06-18 10:13:36 +01:00
- OnlyHEVC - If false, this will download any files that it finds on the post that matches the quality (true/false)
- Shows - This needs to be a comma separated list of json objects of the show and quality you want to check for.
2022-06-08 15:29:27 +00:00
An example shown below
```
{
"JDUserName": "User",
"JDPassword": "Pass",
2022-06-18 10:13:36 +01:00
"RSSFeed": "https://mypage.com/feed/",
"RSSFeedRefreshMins": 10,
"JDPostLinksMins": 180,
2022-06-08 15:29:27 +00:00
"Autostart": false,
2022-06-18 10:13:36 +01:00
"OnlyHEVC": true,
2022-06-08 15:29:27 +00:00
"Shows": [
{
"Name": "Obi-Wan Kenobi",
"Quality": "1080"
},
{
"Name": "Taskmaster",
"Quality": "720"
}
]
}
```
2022-06-18 10:13:36 +01:00
2022-06-11 19:03:54 +01:00
# Running
## Release Version
2022-06-18 10:13:36 +01:00
2022-06-11 19:03:54 +01:00
Either download the version on the releases, as well as the `config-sample.json` and run execute, this is the simplest way, but may not be the latest code, and will not run in the background
## Source Version
2022-06-18 10:13:36 +01:00
2022-06-11 19:03:54 +01:00
You will need NodeJS installed, then you can checkout this repo.
2022-06-08 14:17:09 +01:00
For basic usage you can just navigate into the folder and run -
2022-06-18 10:13:36 +01:00
- `npm i` to install the requirements.
- `node JDRssDownloader.js` This will execute the process and add the links if they are found.
2022-06-08 14:17:09 +01:00
My suggestion would be to use pm2 so it can run "in the background"
2022-06-08 14:17:09 +01:00
2022-06-11 19:03:54 +01:00
# Issues
Not alot of testing has gone into this, and I threw it together in a few hours, and only for my use case, so there are bound to be issues, please open them and let me know if you find any.
# Future
2022-06-18 10:13:36 +01:00
I have some ideas to make this a bit smarter and I want to add the ability to look at multiple RSS feeds, this seems quite easy, and I will do in the next couple of weeks.
2022-06-08 14:17:09 +01:00
2022-06-11 19:03:54 +01:00
# Thanks
2022-06-18 10:13:36 +01:00
Thank for all the people who made any of the modules that I used to create this.