torah-dl 0.4.0

Add your description here

torah-dl - tools for downloading media from Torah websites.

Why torah-dl?

Most of our generation's Torah content is locked up in websites that are not easily accessible. Sofer.Ai is building a platform to make Torah accessible to everyone, and we decided to build key parts of that platform in the open. We intend to support every website with Torah audio on our platform, and realized quickly that even finding all the sites with audio would be a full-time job. So we open-sourced torah-dl to make it easier for others to download Torah audio from any website, and make Torah more accessible!

How does it work?

torah-dl is a library and a set of command-line tools for downloading media from Torah websites. You can use it as a command-line tool with uv (preferred), pipx, pip, poetry, venv, or any Python tool installer of your choice, simply by running uv tool install "torah-dl[cli]", and then running torah-dl.

For those who want to integrate torah-dl into their Python application, you can simply install it via uv add torah-dl or pip install torah-dl. You can then use the library in your code as you would any other Python library:

from torah_dl import extract

extraction = extract("https://www.yutorah.org/lectures/details?shiurid=1117416")

print(extraction.download_url) # https://download.yutorah.org/2024/34263/1117416/ketuvot-57a-b---preparation-for-nisuin.mp3

print(extraction.title) # Ketuvot 57a-b - Preparation for Nisuin

print(extraction.file_format) # audio/mp3

print(extraction.file_name) # ketuvot-57a-b---preparation-for-nisuin.mp3

What sites does it support?

Here is the list of sites that torah-dl supports already, and what's coming soon:

• Yutorah
• TorahAnytime
• TorahApp
• OUTorah.org
• AllDaf.org
• AllHalacha.org
• AllParsha.com
• AllMishna.com
• TorahDownloads.org
• Help us out by adding your favorite Torah website!

Contributing

We'd love your help! Please see our CONTRIBUTING.md for more information on how to get involved.

Frequently Asked Questions

Am I allowed to download Torah audio from these websites?

You are responsible for ensuring that you follow all Terms of Service agreements, Copyright agreements, and other legal agreements with these websites.

TODO: get a lawyer to review this.

How do I download audio from a site that is not on the list?

We'd love your help! Please see our CONTRIBUTING.md for more information on how to get involved.

What are the usecases for `torah-dl`?

Allowing transcription services to make Torah more accessible 😉

Other uses include downloading Torah audio for offline listening, or for use in Torah study tools, or for training AI models to understand Torah, or for other purposes (please see question above about permissions).