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.org
- AllMishnah.org
- TorahDownloads.org
- Naaleh.com
- Etzion.org
- TorahMediaInAmerica.com
- Nishmat.net
- Mp3Shiur.com
- Torahweb.com
- Orayta.com
- KolHalashon.com
- Help us out by adding your favorite Torah website!
Note:
Virtual Beit Midrash (Etzion)is currently temporarily degraded for automated clients in CI due to upstream Cloudflare/bot protection. Browser access may still work normally.
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).
Contributors
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file torah_dl-0.6.3.tar.gz.
File metadata
- Download URL: torah_dl-0.6.3.tar.gz
- Upload date:
- Size: 171.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
959f2b84a2b07ea561e56f1774d0a74a833f5884dec590392bb4dc78f0e1f120
|
|
| MD5 |
f6499efe6ab3a6af2dd3595576727619
|
|
| BLAKE2b-256 |
914a06eec78173b9293863e13b10c6dd700bf601e35a0ce7a2b62bca7c6b1d73
|
Provenance
The following attestation bundles were made for torah_dl-0.6.3.tar.gz:
Publisher:
release.yml on SoferAi/torah-dl
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
torah_dl-0.6.3.tar.gz -
Subject digest:
959f2b84a2b07ea561e56f1774d0a74a833f5884dec590392bb4dc78f0e1f120 - Sigstore transparency entry: 2371047455
- Sigstore integration time:
-
Permalink:
SoferAi/torah-dl@b64f8e846073690fd0758d34467dd017d23018f4 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/SoferAi
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@b64f8e846073690fd0758d34467dd017d23018f4 -
Trigger Event:
push
-
Statement type:
File details
Details for the file torah_dl-0.6.3-py3-none-any.whl.
File metadata
- Download URL: torah_dl-0.6.3-py3-none-any.whl
- Upload date:
- Size: 39.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a3804e3e4b9e91a32f644e3383f0ec24e19d9a5d918b9ac2d183292e4af7a727
|
|
| MD5 |
c5435a2ec1f35175ffa6e729f17fd5a0
|
|
| BLAKE2b-256 |
0f288e6454366f7741c9f0178c9765078eacc53cb8279e168aca938d0f8d3456
|
Provenance
The following attestation bundles were made for torah_dl-0.6.3-py3-none-any.whl:
Publisher:
release.yml on SoferAi/torah-dl
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
torah_dl-0.6.3-py3-none-any.whl -
Subject digest:
a3804e3e4b9e91a32f644e3383f0ec24e19d9a5d918b9ac2d183292e4af7a727 - Sigstore transparency entry: 2371047472
- Sigstore integration time:
-
Permalink:
SoferAi/torah-dl@b64f8e846073690fd0758d34467dd017d23018f4 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/SoferAi
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@b64f8e846073690fd0758d34467dd017d23018f4 -
Trigger Event:
push
-
Statement type:
