You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+22-34Lines changed: 22 additions & 34 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,16 +1,16 @@
1
1
# JW Scripts (Go Version)
2
2
3
+
This project is a Go-based reimplementation of the [original Python scripts](https://github.com/allejok96/jw-scripts) for interacting with jw.org content. It offers improved performance and modern features while maintaining compatibility with the original command-line flags.
4
+
3
5
*These methods of accessing jw.org are, while legal, not officially supported by the organisation. Use them if you find it worth the time, pain and risk. But first, please take the time to read [w18.04 30-31](https://wol.jw.org/en/wol/d/r1/lp-e/2018364). Then consider buying a device which has official support for JW Broadcasting app. Like a Roku, Apple TV or Amazon Fire TV. It will give you a better and safer experience.*
4
6
5
7
### JW Broadcasting and Publications anywhere
6
8
7
9
With these scripts you can get the latest JW Broadcasting videos and publications automatically downloaded. You can turn a computer (like a Raspberry Pi) into a JW TV, either by streaming directly, or by playing downloaded videos from your collection.
8
10
9
-
**Note**: The publication download feature (`jwb-books`) is currently a framework implementation. The JW.org API does not currently provide access to publications/books - only broadcasting content (videos and audio). See [docs/BOOK_DOWNLOAD_ANALYSIS.md](docs/BOOK_DOWNLOAD_ANALYSIS.md) for details.
10
-
11
11
## Get started
12
12
13
-
This project is now written in Go. You have two options to get started:
13
+
You have two options to get started with the Go version of JW Scripts:
./bin/jwb-books --category=bible-study --language E --format=pdf --output=./books
101
107
102
-
#Search for specific publications (when API becomes available)
103
-
./bin/jwb-books --search="watchtower 2024"
108
+
#Download magazines in EPUB format
109
+
./bin/jwb-books --category=magazines --language E --format=epub --output=./publications
104
110
```
105
111
106
112
See [docs/BOOK_DOWNLOAD_ANALYSIS.md](docs/BOOK_DOWNLOAD_ANALYSIS.md) for detailed information about the API analysis and framework implementation.
@@ -109,24 +115,6 @@ Next, check out the [Wiki pages](https://github.com/allejok96/jw-scripts/wiki) f
109
115
110
116
## Questions
111
117
112
-
#### Isn't there an easier way to watch JW Broadcasting in Kodi?
113
-
114
-
Yes, I'm keeping an add-on alive [here](https://github.com/allejok96/plugin.video.jwb-unofficial).
115
-
116
-
#### Why is the video download so slow?
117
-
118
-
~~It seems to be realated to the `--limit-rate` flag ([why?](https://github.com/allejok96/jw-scripts/wiki/How-it-works#batch-downloading)).~~
119
-
120
-
**Fixed!** The rate limiting implementation has been improved to provide smooth downloads at the specified rate limits without the previous throttling issues.
121
-
122
-
*But please, somebody think of the servers!* :-)
123
-
124
-
#### What happened to the script for Bible recordings?
125
-
126
-
Since all recordings can be easily downloaded from the website, and the script couldn't do more than one publication at a time I didn't see any practical use for it.
127
-
128
-
But checkout [@vbastianpc](https://github.com/vbastianpc)'s nice fork of it that can download sign language publications.
129
-
130
118
#### Is this legal?
131
119
132
120
Yes. The [Terms of Service](http://www.jw.org/en/terms-of-use/) allows:
0 commit comments