1 | # dmhy-subscribe
|
2 |
|
3 | [![npm version](https://badge.fury.io/js/dmhy-subscribe.svg)](https://www.npmjs.com/package/dmhy-subscribe) [![Build Status](https://travis-ci.org/FlandreDaisuki/dmhy-subscribe.svg?branch=master)](https://travis-ci.org/FlandreDaisuki/dmhy-subscribe) [![CircleCI](https://circleci.com/gh/FlandreDaisuki/dmhy-subscribe.svg?style=shield)](https://circleci.com/gh/FlandreDaisuki/dmhy-subscribe)
|
4 |
|
5 | Subscribe and schedule downloading magnets on dmhy. Support Linux & Windows 10.
|
6 |
|
7 | 在動漫花園訂閱並排程下載磁鏈,支援 Linux & Windows 10
|
8 |
|
9 | * [Demo 範例影片](#Demo-範例影片)
|
10 | * [Requirements 依賴軟體](#Requirements-依賴軟體)
|
11 | * [Installation 安裝方法](#Installation-安裝方法)
|
12 | * [Usage 使用方法](#Usage-使用方法)
|
13 | * [Scheduling 自動排程](#Scheduling-自動排程)
|
14 | * [Feedbacks 回報問題](#Feedbacks-回報問題)
|
15 | * [Known Issues 已知問題](#Known-Issues-已知問題)
|
16 | * [首頁已經有最新一集出現了,但是 `dmhy` 卻沒更新](#首頁已經有最新一集出現了但是-dmhy-卻沒更新)
|
17 | * [Contributing 貢獻專案](#Contributing-貢獻專案)
|
18 | * [Contributors](#Contributors)
|
19 |
|
20 | ## Demo 範例影片
|
21 |
|
22 | GIF 由 [ttygif](https://github.com/icholy/ttygif) 生成
|
23 |
|
24 | <p align="center">
|
25 | <img src="./tty.gif" alt="tty demo">
|
26 | </p>
|
27 |
|
28 | ## Requirements 依賴軟體
|
29 |
|
30 | * nodejs (v8.9+) & npm
|
31 | * Ubuntu 推薦使用:[creationix/nvm](https://github.com/creationix/nvm)
|
32 | 或 [tj/n](https://github.com/tj/n)
|
33 | * Windows 10 推薦使用:[官方安裝](https://nodejs.org/)
|
34 |
|
35 | 下載器目前提供下面六種,擇一即可 (推薦使用 `system`)
|
36 |
|
37 | * system(預設): 若系統有註冊 `magnet://` 關聯程式,則啟動該程式
|
38 | * deluge: [deluge 安裝教學](docs/deluge.md)
|
39 | * qBittorrent: [qBittorrent 安裝教學](docs/qbittorrent.md)
|
40 | * aria2c: [aria2 安裝教學](docs/aria2.md)
|
41 | * webhook: [webhook 安裝教學](docs/webhook.md)(待補)
|
42 | * stdout: 直接印出連結到 stdout
|
43 |
|
44 | ## Installation 安裝方法
|
45 |
|
46 | <details close>
|
47 | <summary>確認 nodejs 安裝</summary>
|
48 | <p>
|
49 | Ubuntu:
|
50 |
|
51 | ```bash
|
52 | $ node -v
|
53 | v9.4.0
|
54 | $ npm -v
|
55 | 5.6.0
|
56 | ```
|
57 |
|
58 | Windows10 (PowerShell):
|
59 |
|
60 | ```powershell
|
61 | PS C:\> node -v
|
62 | v9.4.0
|
63 | PS C:\> npm -v
|
64 | 5.6.0
|
65 | ```
|
66 |
|
67 | </p>
|
68 | </details>
|
69 |
|
70 | ```bash
|
71 | $ npm i -g dmhy-subscribe
|
72 | ```
|
73 |
|
74 | 若之前已有安裝,推薦先輸出可訂閱字串作為備份
|
75 |
|
76 | ```bash
|
77 | (0.3.x) $ dmhy ls --addable > backup.txt
|
78 | (0.5.x) $ dmhy ls -s > backup.txt
|
79 | ```
|
80 |
|
81 | 如果習慣使用 Docker 或 npm 無法正確安裝,也可以透過 [Docker](https://www.docker.com) 來執行本程式。
|
82 |
|
83 | * [Docker 安裝與使用教學](docs/docker.md)
|
84 |
|
85 | ## Usage 使用方法
|
86 |
|
87 | ```txt
|
88 | 使用方法: dmhy [命令] [選項]
|
89 |
|
90 | 若不指定命令,則到網站檢查更新,並*只*下載尚未紀錄的貼文
|
91 |
|
92 |
|
93 | 命令:
|
94 | dmhy add [subscribable...] 新增一筆訂閱
|
95 | dmhy list [SID...] 顯示訂閱資訊 [別名: ls]
|
96 | dmhy remove [SID...] 根據訂閱識別碼刪除訂閱 [別名: rm]
|
97 | dmhy search <subscribable-string> 直接搜尋貼文 [別名: find]
|
98 | dmhy config [key] [value] 設定內部參數 [別名: cfg]
|
99 | dmhy download <THID...> 根據下載識別碼下載訂閱 [別名: dl]
|
100 |
|
101 | 選項:
|
102 | -x, --no-dl 只更新訂閱但不下載 [布林]
|
103 | -h, --help 顯示說明 [布林]
|
104 | -v, --version 顯示版本 [布林]
|
105 |
|
106 | 例:
|
107 | dmhy add "搖曳露營,喵萌,繁體" 最簡單的例子,新增訂閱並全部更新下載
|
108 | dmhy
|
109 | ```
|
110 |
|
111 | ## Scheduling 自動排程
|
112 |
|
113 | 參考[自動排程](docs/scheduling.md)教學
|
114 |
|
115 | ## Feedbacks 回報問題
|
116 |
|
117 | 先到 [issue](https://github.com/FlandreDaisuki/dmhy-subscribe/issues) 看看有沒有相似的問題,若沒有相似問題請點擊 New issue 描述問題。
|
118 |
|
119 | ## Known Issues 已知問題
|
120 |
|
121 | ### 首頁已經有最新一集出現了,但是 `dmhy` 卻沒更新
|
122 |
|
123 | 這是正常的,因為動漫花園因為一些未知的原因,搜尋的結果會有點延遲
|
124 | 可以試著去直接搜尋訂閱的關鍵字,是看不到最新一集的
|
125 |
|
126 | ## Contributing 貢獻專案
|
127 |
|
128 | Fork 並 clone 到本地端
|
129 |
|
130 | ```bash
|
131 | (master) $ git remote add upstream https://github.com/FlandreDaisuki/dmhy-subscribe.git
|
132 | (master) $ git merge upstream master # 更新上游分支
|
133 | (master) $ git checkout -b 0.6.x # *最新版本*的最後一個數字改成x
|
134 | (0.6.x) $ # 改改改
|
135 | (0.6.x) $ git push origin 0.6.x
|
136 | ```
|
137 |
|
138 | 到 GitHub 發 PR 到我的同名分支 (不要發到 master)
|
139 |
|
140 | ## Contributors
|
141 |
|
142 |
|
143 |
|
144 | | [<img src="https://avatars0.githubusercontent.com/u/5981459?v=4" width="100px;"/><br /><sub><b>Chun-Hao Lien</b></sub>](https://github.com/FlandreDaisuki)<br />[💻](https://github.com/FlandreDaisuki/dmhy-subscribe/commits?author=FlandreDaisuki "Code") [📖](https://github.com/FlandreDaisuki/dmhy-subscribe/commits?author=FlandreDaisuki "Documentation") [⚠️](https://github.com/FlandreDaisuki/dmhy-subscribe/commits?author=FlandreDaisuki "Tests") [👀](#review-FlandreDaisuki "Reviewed Pull Requests") | [<img src="https://avatars1.githubusercontent.com/u/9370547?v=4" width="100px;"/><br /><sub><b>maple</b></sub>](https://blog.maple3142.net/)<br />[💻](https://github.com/FlandreDaisuki/dmhy-subscribe/commits?author=maple3142 "Code") [📖](https://github.com/FlandreDaisuki/dmhy-subscribe/commits?author=maple3142 "Documentation") [🤔](#ideas-maple3142 "Ideas, Planning, & Feedback") [🐛](https://github.com/FlandreDaisuki/dmhy-subscribe/issues?q=author%3Amaple3142 "Bug reports") | [<img src="https://avatars1.githubusercontent.com/u/2549826?v=4" width="100px;"/><br /><sub><b>Ting Shu Lin</b></sub>](http://sudopotato.github.io/)<br />[💻](https://github.com/FlandreDaisuki/dmhy-subscribe/commits?author=wabilin "Code") [🤔](#ideas-wabilin "Ideas, Planning, & Feedback") [📦](#platform-wabilin "Packaging/porting to new platform") |
|
145 | | :---: | :---: | :---: |
|
146 |
|
147 | Thanks goes to these wonderful people ([emoji key](https://github.com/kentcdodds/all-contributors#emoji-key)):
|
148 |
|
149 | This project follows the [all-contributors](https://github.com/kentcdodds/all-contributors) specification. Contributions of any kind welcome!
|