Skip to main content

NCERT textbook downloader for Classes 6–12

Project description

ncert-dl

ncert-dl is a command-line tool that downloads official NCERT textbooks directly from ncert.nic.in for Class 10 (and partially Class 9). It organizes them into clean folders with human-readable chapter names.

Features

  • Official Source: Downloads directly from the NCERT website.
  • Interactive UI: Select class, subjects, and language using a checkbox menu.
  • Smart Renaming: Automatically converts cryptic filenames (e.g., jemh101.pdf) to readable ones (e.g., Mathematics/01_Chapter.pdf).
  • Clean Organization: structured folders by Subject > Chapter.
  • Resumable: Skips already downloaded files and handles interruptions gracefully.
  • Cross-Platform: Works on Windows, macOS, and Linux.

Installation

pipx install ncert-dl

Or with pip:

pip install ncert-dl

Usage

Simply run the command:

ncert-dl

Follow the interactive prompts:

  1. Select Class (e.g., 10)
  2. Select Subjects (e.g., Mathematics, Science)
  3. Select Language (English or Hindi)

The tool will download the PDFs and organize them in a NCERT_Downloads directory.

How It Works

NCERT uses a predictable naming convention for their PDF files. This tool reverses that convention to generate URLs dynamically.

  • Maths/Science: [prefix][class][chapter].pdf (e.g., jemh101.pdf)
  • Social Science: Specific mappings (e.g., jess101.pdf -> History Ch 1)

This ensures the downloader is fast, reliable, and doesn't rely on web scraping.

Disclaimer

This tool is for educational purposes only. It effectively automates the manual process of downloading textbooks from the official portal. Please respect copyright and terms of service of the source website.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ncert_dl-1.0.2.tar.gz (5.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ncert_dl-1.0.2-py3-none-any.whl (6.2 kB view details)

Uploaded Python 3

File details

Details for the file ncert_dl-1.0.2.tar.gz.

File metadata

  • Download URL: ncert_dl-1.0.2.tar.gz
  • Upload date:
  • Size: 5.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for ncert_dl-1.0.2.tar.gz
Algorithm Hash digest
SHA256 546d024192d3a0e83c760b9bb41307b97d5c7b30fe622ed97db309361aecb550
MD5 939ca9d9a6a27d27793bbd3100d3a1d0
BLAKE2b-256 03bb5a27d686235593de7810580310b4299bf9d1904bdc8f12a8c1277ef6884a

See more details on using hashes here.

File details

Details for the file ncert_dl-1.0.2-py3-none-any.whl.

File metadata

  • Download URL: ncert_dl-1.0.2-py3-none-any.whl
  • Upload date:
  • Size: 6.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for ncert_dl-1.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 c5272f94687cd528c28fa26675c9c94ac5992755bc8874b0b075473addc3fb74
MD5 bb422464b6e0ab2b9457733dae60f20b
BLAKE2b-256 634e692036dee884a579d085aa2d1b1f26fa869a954a1603d1f415fa3a9069d5

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page