wattpdl 1.2.0

                         ██╗    ██╗ █████╗ ████████╗████████╗██████╗ ██████╗ ██╗     
                         ██║    ██║██╔══██╗╚══██╔══╝╚══██╔══╝██╔══██╗██╔══██╗██║     
                         ██║ █╗ ██║███████║   ██║      ██║   ██████╔╝██║  ██║██║     
                         ██║███╗██║██╔══██║   ██║      ██║   ██╔═══╝ ██║  ██║██║     
                         ╚███╔███╔╝██║  ██║   ██║      ██║   ██║     ██████╔╝███████╗
                         ╚══╝╚══╝ ╚═╝  ╚═╝   ╚═╝      ╚═╝   ╚═╝     ╚═════╝ ╚══════╝

✨ Tentang Project

WattPDL adalah script Python ringan yang mengunduh chapter dari cerita Wattpad pilihanmu, lalu menyimpannya sebagai file .txt polos, dokumen Word .docx, atau ebook .epub yang bersih dan rapi. Kamu bisa unduh seluruh cerita jadi satu file, semua chapter terpisah dalam satu .zip, atau cukup chapter tertentu yang kamu pilih sendiri. Tidak perlu login, tidak perlu API key, cukup link atau ID ceritanya.

"Karena cerita yang bagus layak dibaca kapan saja, bahkan tanpa internet."

🎯 Fitur

📦 Requirements

• Python 3.9 atau lebih baru
• Koneksi internet
• Library: requests, rich, python-docx, EbookLib — otomatis terinstall bareng wattpdl, tidak perlu diinstall manual

Belum pernah pakai terminal? Ikuti ini dulu

Belum punya Python?

1. Buka python.org/downloads dan unduh versi terbaru
2. Khusus Windows: saat instalasi, centang dulu kotak "Add Python to PATH" di layar pertama sebelum klik Install. Kalau ini kelewat, perintah python nanti tidak akan dikenali
3. Setelah selesai install, buka terminal (lihat panduan di atas) lalu cek dengan:

python --version
# atau
python3 --version

Kalau muncul angka versi (misal Python 3.12.1), berarti sudah siap.

🚀 Instalasi

Cara A: Install dari PyPI (paling gampang)

pip install wattpdl

Kalau pip tidak dikenali, coba:

python -m pip install wattpdl

Kalau muncul error externally-managed-environment (biasanya di Linux):

pip install wattpdl --break-system-packages

Setelah terinstall, command wattpdl langsung bisa dipakai dari terminal mana saja — lanjut ke bagian Cara Pakai.

Cara B: Install dari source (untuk development / mau lihat/ubah kode)

1. Ambil kode project ini

git clone https://github.com/nekonaru/wattpdl.git
cd wattpdl

cd Downloads/wattpdl-main

2. Install dalam mode "editable"

pip install -e .

Sama seperti Cara A, tambahkan --break-system-packages di akhir kalau muncul error externally-managed-environment.

Ini juga mendaftarkan command wattpdl, tapi mengambil kodenya langsung dari folder ini — cocok kalau kamu mau modifikasi kode dan langsung lihat hasilnya tanpa install ulang.

🖥️ Cara Pakai

Jalankan:

wattpdl

Kalau kamu install dari source tanpa pip install -e ., jalankan lewat python -m wattpdl dari dalam folder src/ — tapi cara Editable Install di atas lebih direkomendasikan.

Masukkan link atau ID cerita saat diminta:

Link atau ID cerita Wattpad: https://www.wattpad.com/story/123456789-judul-cerita

atau cukup ID-nya:

Link atau ID cerita Wattpad: 123456789

Pilih mode unduh:

  1  Semua chapter → 1 file gabungan
  2  Semua chapter → file terpisah per chapter, dikemas .zip
  3  Pilih beberapa chapter → 1 file gabungan
  4  Pilih 1 chapter saja

Pilih mode [1/2/3/4] (1):

• Mode 1: cara paling umum, seluruh cerita jadi satu file rapi dari chapter pertama sampai terakhir
• Mode 2: cocok kalau mau baca per chapter terpisah, hasilnya satu .zip berisi file per chapter
• Mode 3: muncul daftar semua judul chapter bernomor, lalu ketik nomor yang mau diunduh, bisa gabung koma dan rentang, contoh: 1,3,5-8
• Mode 4: muncul daftar semua judul chapter, ketik satu nomor untuk unduh chapter itu saja

Pilih format file:

  1  Teks polos (.txt)
  2  Dokumen Word (.docx)
  3  Ebook (.epub)

Pilih format file [1/2/3] (1):

Pilih folder penyimpanan:

Folder default: C:\Users\user\Downloads
Tekan Enter untuk pakai folder itu, atau ketik path lain:

Tekan Enter untuk simpan di Downloads, atau ketik path kustom seperti:

• Windows: D:\Cerita\Wattpad
• Linux/macOS: /home/user/cerita

Tunggu proses selesai:

⠋ Chapter 24...              ████████████████░░░░░░░░░░░░░░  53.3%  24/45  0:00:12  sisa 0:00:11

Done! 🎉

╔══════ 🎉 Berhasil!  Semua chapter tersimpan ══════╗
║ 📁 File tersimpan di   C:\Users\user\Downloads\Judul_Cerita.txt ║
║ ✅ Berhasil            45/45                                    ║
║ ⏱️  Waktu total         2m 18d                                   ║
╚═══════════════════════════════════════════════════╝

↻ Resume Otomatis

Kalau proses unduh terhenti di tengah jalan (koneksi putus, terminal ditutup, laptop mati), setiap chapter yang sudah berhasil diunduh tersimpan otomatis di ~/.wattpdl/progress/<id_cerita>.json.

Jalankan lagi dengan cerita yang sama (ID/link sama), dan WattPDL akan:

• Melewati chapter yang sudah berhasil (dipakai dari cache, tidak fetch ulang)
• Hanya mengunduh chapter yang belum berhasil / gagal sebelumnya

File progress otomatis dihapus setelah semua chapter berhasil diunduh dalam satu sesi. Kalau mau paksa unduh ulang dari awal, hapus manual folder ~/.wattpdl/progress/.

⚙️ Preferensi Tersimpan

Folder simpan dan format file terakhir yang kamu pilih otomatis tersimpan di ~/.wattpdl/config.json, dan dipakai lagi sebagai default di sesi berikutnya — gak perlu isi ulang tiap kali jalanin script.

🤖 Mode Non-Interaktif (Scripting/Otomatisasi)

Selain mode tanya-jawab, WattPDL juga bisa dijalankan lewat argumen command line — cocok buat dijadwalkan (cron/Task Scheduler) atau dipanggil dari script lain.

wattpdl --id 398440633 --mode 1 --format docx

Argumen yang tersedia:

Contoh lain:

# Unduh semua chapter sebagai .zip terpisah
wattpdl --id 398440633 --mode 2 --format txt

# Unduh chapter 1, 3, dan 5-8 saja, jadi 1 file gabungan
wattpdl --id 398440633 --mode 3 --chapters 1,3,5-8 --format docx

# Unduh chapter 10 saja, simpan ke folder custom
wattpdl --id 398440633 --mode 4 --chapter 10 --output-dir "D:\Cerita Wattpad"

# Unduh semua chapter jadi 1 ebook .epub
wattpdl --id 398440633 --mode 1 --format epub

# Lihat semua opsi
wattpdl --help

📂 Struktur Output

Nama dan bentuk file yang dihasilkan tergantung mode & format yang kamu pilih:

Isi file gabungan (mode 1 & 3): judul cerita, penulis, dan sumber di bagian atas, lalu tiap chapter dipisah dengan penanda #####.

Judul Cerita
oleh Nama Penulis
Sumber : https://www.wattpad.com/story/123456789

==================================================

##### Judul Chapter 1 #####

Isi teks chapter 1...

##### Judul Chapter 2 #####

Isi teks chapter 2...

Di versi .docx, judul cerita jadi heading utama dan tiap chapter otomatis jadi Heading 1 dengan halaman baru, tinggal buka di Word atau Google Docs dan langsung enak dibaca.

Di versi .epub, cerita jadi ebook standar dengan daftar isi (table of contents) otomatis per chapter — tinggal buka di aplikasi pembaca ebook favoritmu (Google Play Books, Apple Books, Calibre, dll).

Isi zip (mode 2): satu file per chapter, bernomor urut sesuai posisi di cerita, plus 000_info.txt/000_info.docx/000_info.epub berisi judul, penulis, dan sumber. Ekstensi file di dalam zip mengikuti format yang dipilih saat menjalankan script (.txt, .docx, atau .epub):

Judul_Cerita.zip
├── 000_info.txt
├── 001_Judul_Chapter_1.txt
├── 002_Judul_Chapter_2.txt
└── ...

🗺️ Default Folder per OS

⚠️ Troubleshooting

📝 Catatan Penting

• ID cerita adalah angka di URL Wattpad, tepat setelah /story/
• Script memakai endpoint publik, tidak butuh login atau API key
• Jeda 0.5 detik antar chapter sudah diatur untuk menghindari rate limit server, jangan dihapus
• Script ini hanya untuk membaca cerita milik sendiri atau cerita publik secara offline. Hormati hak cipta penulis

🛠️ Dibuat dengan

🗂️ Struktur Project

wattpdl/
├── src/
│   └── wattpdl/
│       ├── __init__.py       # metadata package (__version__)
│       ├── __main__.py       # entry untuk `python -m wattpdl`
│       ├── app.py            # orkestrasi alur program (main())
│       ├── api.py            # komunikasi ke Wattpad public API
│       ├── writers.py        # konversi teks & penulisan file .txt/.docx/.zip
│       ├── cli.py            # tampilan terminal (rich), interaksi dengan user
│       ├── cli_args.py       # parsing argumen untuk mode non-interaktif
│       ├── config.py         # simpan preferensi user (folder simpan, format)
│       └── progress.py       # cache progress unduhan untuk fitur resume
├── requirements.txt          # daftar dependency (untuk referensi manual)
├── pyproject.toml            # metadata package + build config + ruff
├── tests/
│   ├── __init__.py
│   └── test_wattpdl.py       # unit test (pytest)
├── .github/
│   └── workflows/
│       ├── tests.yml         # CI: test, lint, & build check otomatis
│       └── publish.yml       # auto-publish ke PyPI saat rilis baru
├── CONTRIBUTING.md           # panduan kontribusi
├── LICENSE
└── README.md

Prinsip pemisahan modul:

• api.py — tidak tahu apa-apa soal tampilan (rich), murni fetch data
• writers.py — tidak melakukan request jaringan, murni konversi & tulis file
• cli.py — semua interaksi dengan user & tampilan progress bar
• cli_args.py — parsing & validasi argumen command line, tidak ada logika bisnis
• config.py / progress.py — baca-tulis file JSON di ~/.wattpdl/, tidak tahu soal CLI atau jaringan
• app.py — menyatukan semuanya, tanpa logika bisnis sendiri (dipanggil lewat command wattpdl setelah install)

🧪 Testing

Ada unit test untuk fungsi-fungsi inti (parsing ID cerita, validasi nama file, parsing pilihan chapter, konversi HTML ke teks, config, progress/resume, parsing argumen CLI, dll).

pip install -e .[dev]
pytest tests/ -v
ruff check .

🤝 Kontribusi

Mau bantu kembangin WattPDL? Baca CONTRIBUTING.md untuk struktur project dan alur kontribusi.

❓ FAQ

👤 Author

Nicolas Dwi Dharma
github.com/nekonaru

📄 License

Distributed under the MIT License. See LICENSE for more information.