-
Notifications
You must be signed in to change notification settings - Fork 100
/
PKG-INFO
183 lines (132 loc) · 7.99 KB
/
PKG-INFO
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
Metadata-Version: 1.1
Name: scribd-downloader
Version: 1.3.1
Summary: Download documents, books and audiobooks off Scribd
Home-page: https://www.github.com/ritiek/scribd-downloader
Author: Ritiek Malhotra
Author-email: [email protected]
License: MIT
Download-URL: https://github.com/ritiek/scribd-downloader/archive/v1.3.1.tar.gz
Description: Scribd-Downloader
=================
|PyPi Version| |Build Status| |Coverage Status|
(I also found an online service https://dlscrib.com/ created by `Erik Fong`_. It doesn't
use this script as some people seem to think!).
Current features:
+------------+-------------------------------------+-------------------------------------------+
| Type | Downloadable without Scribd premium | Requires Scribd premium for full download |
+============+=====================================+===========================================+
| Documents | Yes | No |
+------------+-------------------------------------+-------------------------------------------+
| Books | Yes | Yes |
+------------+-------------------------------------+-------------------------------------------+
| Audiobooks | Yes | Yes |
+------------+-------------------------------------+-------------------------------------------+
**Some information about Scribd documents:**
There are two types of documents on Scribd:
- Documents made up using a collection of images and
- Actual documents where the text can be selected, copied etc.
This script takes a different approach to both of them:
- Documents consisting of a collection of images is straightforward and
this script will simply download the induvidual images which can
be combined to ``.pdf`` by passing ``--pdf`` option to the tool. Simple.
- Actual documents where the text can be selected are hard to tackle.
If we feed such a document to this tool, only the text present in
document will be downloaded. Scribd seems to use javascript to somehow
combine text and images. So far, I haven't been able to combine them
with Python in a way they look like the original document.
------------
Installation
------------
Make sure you're using Python 3 (Python 2 is not supported by a few dependencies).
Then run these commands:
::
$ pip install scribd-downloader
or install the development version with:
::
$ python setup.py install
-----
Usage
-----
::
usage: scribdl [-h] [-i] [-p] URL
Download documents and books from scribd.com
positional arguments:
URL scribd url to download
optional arguments:
-h, --help show this help message and exit
-i, --images download url made up of images
-p, --pdf convert to pdf (*Nix: imagemagick)
-c CREDENTIALS_FILE, --credentials-file CREDENTIALS_FILE
path to file containing your Scribd premium
credentials
--------
Examples
--------
Scribd Documents
----------------
Downloading text from document containing selectable text:
::
$ scribdl https://www.scribd.com/document/55949937/33-Strategies-of-War
(Text will be saved side by side in a ``.md`` file in the current
working directory)
Download document containing images; use the ``--images`` option (the tool cannot figure out this on its own):
::
$ scribdl -i https://scribd.com/doc/17142797/Case-in-Point
(Images will be saved in the current working directory)
Scribd Books
------------
The below command will generate an ``.md`` file of the book in the current working directory:
::
$ scribdl https://www.scribd.com/read/189087235/Confessions-of-a-Casting-Director-Help-Actors-Land-Any-Role-with-Secrets-from-Inside-the-Audition-Room
Pass ``--pdf`` option to convert the generated output to a PDF.
This will only dowload the book content available without owning a premium account on Scribd.
See the below section for downloading full books if you own a premium Scribd account.
Scribd Audiobooks
-----------------
This will download .mp3 of the audiobook:
::
$ scribdl https://www.scribd.com/audiobook/237606860/100-Ways-to-Motivate-Yourself-Change-Your-Life-Forever
This will only download the preview version of the audiobook. See the below section for
downloading complete audiobooks if you own a premium Scribd account.
-------------------------------------------------
Downloading complete textual books and audiobooks
-------------------------------------------------
If you have a premium Scribd account, you can also download the full version of
textual books and audiobooks.
Create a text file containing your Scribd credentials, such that the contents of the file look like below:
::
password
Now pass the file path to the ``-c`` option, for example:
::
$ scribdl -c scribd_credentials.txt https://www.scribd.com/audiobook/359295794/Principles-Life-and-Work
It should then download you all the audiobook chapters as mp3. Similarly, you could also download complete
contents of a Scribd book by replacing the URL with the URL of your choice.
If you're not willing to use place your account credentials in a file, you could also copy the cookie values
for ``_scribd_session`` and ``_scribd_expire`` when logged into your premium account on scribd on the web
browser and replace them with the ones in this file https://github.com/ritiek/scribd-downloader/blob/master/scribdl/const.py.
You should then be able to automatically download full version of both textual books and audiobooks
from Scribd using the tool by running the commands as usual.
----------
Disclaimer
----------
Downloading books from Scribd for free maybe prohibited. This tool is
meant for educational purposes only. Please support the authors by buying
their titles.
-------
License
-------
``The MIT License``
.. |PyPi Version| image:: https://img.shields.io/pypi/v/scribd-downloader.svg
:target: https://pypi.org/project/scribd-downloader
.. |Build Status| image:: https://travis-ci.org/ritiek/scribd-downloader.svg?branch=master
:target: https://travis-ci.org/ritiek/scribd-downloader
.. |Coverage Status| image:: https://codecov.io/gh/ritiek/scribd-downloader/branch/master/graph/badge.svg
:target: https://codecov.io/gh/ritiek/scribd-downloader
.. _Mitmproxy: https://github.com/mitmproxy/mitmproxy
.. _Erik Fong: mailto:[email protected]
.. _BookURL: https://www.scribd.com/read/189087235/Confessions-of-a-Casting-Director-Help-Actors-Land-Any-Role-with-Secrets-from-Inside-the-Audition-Room
.. ConstantValues:
Keywords: scribd-downloader,documents,command-line,python
Platform: UNKNOWN