Git Product home page Git Product logo

plugin.audio.jwa-unofficial's Introduction

Unofficial JW.ORG audio player for Kodi

screenshot

Play audio recordings from JW.ORG on your Kodi box! Select one of the hundred languages, and listen to the Bible, the latest magazines or any of the available books or brochures.

This add-on is not supported by the Watchtower Society. If you run in to any problems, do not contact jw.org for support. Instead please leave an issue here on GitHub.

It would of course be better if you could access these publications using an officially supported method, like the JW Library app, or simply a web browser. The Watchtower Society urges people to use their official apps, instead of third-party software like Kodi add-ons (w18 April page 30-31).

Installation

There are multiple ways you can install this add-on. You could use git clone or Download ZIP from GitHub.

But the easiest way is to install it from my repo. This way you'll receive updates automatically (if I remember to upload them):

  1. Download this ZIP
  2. In Kodi: click on "Add-ons"
  3. Click on the little box icon in the upper left hand corner
  4. "Install from zip file"
  5. Browse to the directory with the zip and select it
  6. Click on "Install from repository"
  7. "allejok96's Repository > Music add-ons > JWA Unofficial > Install"

Disclaimer

As the WT article above points out, there are some risks with third-party software:

  • When jw.org improves, this add-on may break, misbehave or lag behind.
  • If someone hacked my repo, they could forge the spiritual food (extremely unlikely).

But since you found this page I guess you know what you're doing.

Questions

How to switch language?

The add-on will auto detect your language at first startup. You can change language in the add-on settings (press left if you're using the Estuary skin). You can also play a single recording in a different language by opening the context menu and selecting Play in another language.

Why are some books missing?

Under "Books & Brochures", you can do a "Auto scan" to get all books. There is currently no good way to get a list of all books, so I explicitly typed out the ones available at the time of making. Any new books will not be detected by "Auto scan". If you notice a book is missing, please drop an issue here, and I'll add it in the next release.

Meanwhile, you can manually add it by clicking on "Add more...", answering no, and typing in the two or three letter publication code. You find it inside the covers of, or at the back of the book, or at WOL.

Why not in Kodi official repository?

See JWB Unofficial

Is this legal?

Yes. The Terms of Service states:

You may not ... create software ... made to download, extract, harvest, or scrape data, HTML, images, or text from this site. (This does not prohibit the distribution of free, non-commercial applications designed to download electronic files such as EPUB, PDF, MP3, and MP4 files from public areas of this site.)

As you can see, software like this add-on is very generously allowed for. But there's one part of this add-on that violates the terms...

What about Translated menus?

When selecting a language, the add-on extracts a few translated words from the HTML of a page at jw.org. This violates the terms above. But since it's a one time thing, I feel the aesthetic benefits outweighs the violation.

The funny thing, though, is that this extraction is much more prone to fail, compared to the rest of the add-on (the "allowed" usage). If you were to experience any problems, you can turn it off. Just go to settings and disable Translated menus.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.