This repository has been archived by the owner on Feb 26, 2023. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 457
/
index.html
467 lines (446 loc) · 42.7 KB
/
index.html
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
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
<!DOCTYPE html>
<html lang="en-US">
<head>
<meta charset="UTF-8">
<!-- Begin Jekyll SEO tag v2.8.0 -->
<title>CloneBot V2⚡ | The Powerful Telegram Bot based on Gclone to clone Google Drive’s Shared Drive data easily.🔥</title>
<meta name="generator" content="Jekyll v3.9.2" />
<meta property="og:title" content="CloneBot_V2" />
<meta property="og:locale" content="en_US" />
<meta name="description" content="The Powerful Telegram Bot based on Gclone to clone Google Drive’s Shared Drive data easily.🔥" />
<meta property="og:description" content="The Powerful Telegram Bot based on Gclone to clone Google Drive’s Shared Drive data easily.🔥" />
<link rel="canonical" href="https://www.caduceus.ml/CloneBot_V2/" />
<meta property="og:url" content="https://www.caduceus.ml/CloneBot_V2/" />
<meta property="og:site_name" content="CloneBot_V2" />
<meta property="og:type" content="website" />
<meta name="twitter:card" content="summary" />
<meta property="twitter:title" content="CloneBot_V2" />
<script type="application/ld+json">
{"@context":"https://schema.org","@type":"WebSite","description":"The Powerful Telegram Bot based on Gclone to clone Google Drive’s Shared Drive data easily.🔥","headline":"CloneBot_V2","name":"CloneBot_V2","url":"https://www.caduceus.ml/CloneBot_V2/"}</script>
<!-- End Jekyll SEO tag -->
<link rel="preconnect" href="https://fonts.gstatic.com">
<link rel="preload" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700&display=swap" as="style" type="text/css" crossorigin>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="theme-color" content="#157878">
<meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
<link rel="stylesheet" href="https://www.caduceus.ml/assets/css/style.css?v=5ed094f35e388c5a50aa4ac57fbeeb3840510a97">
<!-- start custom head snippets, customize with your own _includes/head-custom.html file -->
<!-- Setup Google Analytics -->
<!-- You can set your favicon here -->
<link rel="apple-touch-icon" sizes="180x180" href="https://www.caduceus.ml/Img/apple-touch-icon.jpg" />
<link rel="icon" type="image/png" sizes="32x32" href="https://www.caduceus.ml/Img/favicon-32x32.jpg" />
<link rel="icon" type="image/png" sizes="16x16" href="https://www.caduceus.ml/Img/favicon-16x16.png" />
<link rel="manifest" href="/site.webmanifest" />
<link rel="mask-icon" href="/safari-pinned-tab.svg" color="#5bbad5" />
<meta name="msapplication-TileColor" content="#da532c" />
<meta name="theme-color" content="#ffffff" />
<!-- link rel="shortcut icon" type="image/x-icon" href="/CloneBot_V2/favicon.ico" -->
<!-- end custom head snippets -->
</head>
<body>
<a id="skip-to-content" href="#content">Skip to the content.</a>
<header class="page-header" role="banner">
<h1 class="project-name">CloneBot V2🔥</h1>
<h2 class="project-tagline">The Powerful Telegram Bot based on Gclone to clone Google Drive's Shared Drive data easily.🔥</h2>
<a href="https://github.com/TheCaduceus/CloneBot_V2" class="btn">View on GitHub</a>
</header>
<main id="content" class="main-content" role="main">
<h1 align="center"><b>CloneBot V2 🔥</b></h1>
<!---Introduction--->
<p><b>CloneBot V2 is inspired from MsGsuite's CloneBot, which got out-dated and having too many errors in it. We both created it to keep the legacy of CloneBot alive! The bot who helped thousands for cloning their data.❤️</b></p>
<p><b>1. The Powerful Telegram Bot based on Gclone to clone Google Drive's Shared Drive data easily.⚡</b></p>
<p><b>2. CloneBot V2 usage Service Accounts to easily clone TBs of data without hitting 750GB Upload/Clone limit of Google Drive.♻️</b></p>
<p><b>3. It is most lightweight and performs only server-sided cloning to have very less load on system and don't use your own bandwidth.🗃️</b></p>
<p><b>4. Just provide the sharing link of a particular Shared Drive/folder or file and set multiple destination folders to clone data.🔗</b></p>
<!---Index--->
<h2><b>📑 INDEX</b></h2>
<p><b>Easily navigate through out the guide and learn about Powerful CloneBot V2 and terms related to it.</b></p>
<p><b><a href="https://github.com/TheCaduceus/CloneBot_V2#clonebot-v2-">🔥 CloneBot V2</a></b></p>
<p><b><a href="https://github.com/TheCaduceus/CloneBot_V2#-whats-new">🆕 What's New!</a></b></p>
<p><b><a href="https://github.com/TheCaduceus/CloneBot_V2#-notice">⛔ NOTICE</a></b></p>
<p><b><a href="https://github.com/TheCaduceus/CloneBot_V2#%EF%B8%8F-how-to-use">⚙️ How to use?</a></b></p>
<p><b><a href="https://github.com/TheCaduceus/CloneBot_V2/blob/main/Commands.md">➥🔩Commands for BotFather</a></b></p>
<p><b><a href="https://github.com/TheCaduceus/CloneBot_V2#making-shared-drive">🫙 Making Shared Drive</a></b></p>
<p><b><a href="https://github.com/TheCaduceus/CloneBot_V2#using-website">➥🌐Using Website</a></b></p>
<p><b><a href="https://github.com/TheCaduceus/CloneBot_V2#using-telegram-bot">➥🤖Using Telegram Bot</a></b></p>
<p><b><a href="https://github.com/TheCaduceus/CloneBot_V2#python-with-pip-installation">🐍Python with PIP Installation</a></b></p>
<p><b><a href="https://github.com/TheCaduceus/CloneBot_V2#%EF%B8%8Fdeployment">🕹️Deployment</a></b></p>
<p><b><a href="https://github.com/TheCaduceus/CloneBot_V2#getting-config_file_url">➥📎Getting CONFIG_FILE_URL</a></b></p>
<p><b><a href="https://github.com/TheCaduceus/CloneBot_V2#using-drgraph">-->📃Using Dr.Graph</a></b></p>
<p><b><a href="https://github.com/TheCaduceus/CloneBot_V2#using-file-stream-bot">-->🤖Using File Stream Bot</a></b></p>
<p><b><a href="https://github.com/TheCaduceus/CloneBot_V2#%EF%B8%8Fusing-github-gist">-->✏️Using GitHub Gist</a></b></p>
<p><b><a href="https://github.com/TheCaduceus/CloneBot_V2#build-or-deploy-using-docker">➥🐳Build or Deploy using Docker</a></b></p>
<p><b><a href="https://github.com/TheCaduceus/CloneBot_V2#%EF%B8%8Fdeploy-on-fly">➥🕊️Deploy on Fly</a></b></p>
<p><b><a href="https://github.com/TheCaduceus/CloneBot_V2#%EF%B8%8Fdeploy-on-clever-cloud">➥♦️Deploy on Clever Cloud</a></b></p>
<p><b><a href="https://github.com/TheCaduceus/CloneBot_V2#deploy-on-okteto">➥🪬Deploy on Okteto</a></b></p>
<p><b><a href="https://github.com/TheCaduceus/CloneBot_V2#%EF%B8%8F-deploy-on-vps-or-pc">➥🖥️ Deploy on VPS or PC</a></b></p>
<p><b><a href="https://github.com/TheCaduceus/CloneBot_V2#deploy-on-termux">➥📱Deploy on Termux</a></b></p>
<p><b><a href="https://github.com/TheCaduceus/CloneBot_V2#deploy-on-scalingo">➥🎲Deploy on Scalingo</a></b></p>
<p><b><a href="https://github.com/TheCaduceus/CloneBot_V2#-service-accounts">🪪 Service Accounts</a></b></p>
<p><b><a href="https://github.com/TheCaduceus/CloneBot_V2#%EF%B8%8F-create-service-accounts">➥🛠️ Create Service Accounts</a></b></p>
<p><b><a href="https://github.com/TheCaduceus/CloneBot_V2#-adding-in-google-group">➥🌐 Adding in Google Group</a></b></p>
<p><b><a href="https://github.com/TheCaduceus/CloneBot_V2#contact-us">⛑Contact Us!</a></b></p>
<p><b><a href="https://github.com/TheCaduceus/CloneBot_V2#%EF%B8%8Fcredits--thanks">❤️Credits & Thanks</a></b></p>
<!---ChangeLog--->
<h2><b>🆕 What's New!</b></h2>
<p><b>1.Gclone upgraded to v1.59.1 (latest)!😉</b></p>
<p><b>2.UI Changes!🌟</b></p>
<p><b>3.CloneBot V2 is now comfortable with Python <code>3.10.6</code>🐍.</b></p>
<p><b>4.Resolved $PORT listening Errors in Okteto and other platforms.⚙️</p>
<p><b>5.Old Docker Image <code>ghcr.io/thecaduceus/clonebot_v2:main</code> is now no more supported and deprecated!🧹</b></p>
<p><b>6.Lots of other fixes, changes and improvements which can be checked in <code>Changelog</code>.</b></p>
<p><b>Full Changelog: <a href="https://github.com/TheCaduceus/CloneBot_V2/compare/V2.1.4...v2.2.9"><code>V2.1.4...v2.2.9</code></a></b></p>
<!---NOTICE--->
<h2><b>⛔ NOTICE</b></h2>
<p><b>1.You may need account for Fly.io/Clever-Cloud/Okteto/Scalingo while deploying CloneBot V2 on respected platforms.</b></p>
<p><b>2.Service Accounts are mandatory to use CloneBot V2, because it uses Service Accounts to prevent hitting 750GB Upload/Clone limit of Google Drive while cloning large amount of data.</b></p>
<p><b>3.VPS or your local machine (PC or Laptop or Mobile) should have <code>Python 3</code> and <code>Git</code> installed in order to run CloneBot V2.</b></p>
<p><b>4.CloneBot V2 don't use your bandwidth or Internet connection while cloning data but it can if hosted on your local machine or VPS for calling required Telegram APIs to update the progress or to generate required response.</b></p>
<p><b>5.This Project comes with GNU License, please consider reading it before using this.</b></p>
<p><b>6.Name of zip file should be only <code>accounts.zip</code> and it should only contain <code>.json</code> files not folders!</b></p>
<p><b>7.Don't blame contributors of CloneBot V2 in case your account got suspended while using it by deploying on free services provided below! (We already provided you the details that you should follow to prevent it if you are new to this platforms) on Clever-Cloud add Credit card before deploying your bot on it, only report error which is releated with code of CloneBot V2! we don't accept problems regarding any platform on which you are going to deploy this.</b></p>
<p><b>8.Don't get confused! If you use <code>pip</code> to install <code>requirements.txt</code> then only use <code>py</code> or <code>python</code> for executing commands or in the same way if you use <code>pip3</code> then only use <code>python3</code>.</b></p>
<p><b>9.Aim of CloneBot V2 is not to violate any platform's TOS and hence we removed deployment support of platforms like Heroku, don't create an issue or PR for adding support of Heroku or platforms which don't allow it or if CloneBot V2 violate their TOS.</b></p>
<p><b>10.PRs for just changing the status message or similar is not accepted! that does not mean that PRs including Typo Errors will be rejected.</b></p>
<!---Deployment--->
<h2><b>⚙️ How to use?</b></h2>
<p><b>CloneBot V2 is very straight forward and easy to use bot. If you deployed your CloneBot V2 then consider adding commands in it through <a href="https://t.me/BotFather">@BotFather</a> to make it easy for other users to know bot commands, here is the <a href="https://github.com/TheCaduceus/CloneBot_V2/blob/main/Commands.md" alt="Command-list">commands list</a> to be set in <a href="https://t.me/BotFather">@BotFather</a>:</b></p>
<h4><b>1.First convert accounts folder of your Service Accounts into <code>accounts.zip</code> then send it to bot and write <code>/sa</code> in caption or send <code>/sa</code> as reply to <code>accounts.zip</code> file. Don't have Service Accounts? <a href="https://github.com/TheCaduceus/CloneBot_V2#-service-accounts">Learn here</a> how to create</b></h4>
<h4><b>2.Now Send <code>/folders</code> to your CloneBot V2 and then bot will show Shared Drives name in which you added your Service Accounts's Google Group, select Shared Drive or directory available in it as destination. Not added Service Accounts in Google Group? <a href="https://github.com/TheCaduceus/CloneBot_V2#%EF%B8%8F-create-service-accounts">Learn here</a> how to do.</b></h4>
<h4><b>3.Your CloneBot V2 is now ready to be used! just send any Google Drive sharing link and select the Destination folder you set before to clone data in it.</b></h4>
<h4><b>4.Additionally, <code>/ban</code> and <code>/unban</code> command is to unauthorize or authorize user again and <code>/id</code> command is to get your Telegram User ID.</b></h4>
<p><b>⛔NOTE: Each allowed user have to upload their own <code>accounts.zip</code> to use CloneBot V2.</b></p>
<div align="center">
<img src="https://user-images.githubusercontent.com/87380104/180602955-ecf149f9-91a8-43c1-9730-962be45c22b9.png">
</div>
<h2><b>🫙Making Shared Drive</b></h2>
<p><b>CloneBot V2 comes with the ability to clone data between My Drive to Shared Drive or Shared Drive to Shared Drive, but in both case Shared Drive is common & required! So lets see how we can create our own Shared Drive for free to use them with CloneBot V2.</b></p>
<h4><b>First visit MsGsuite's <a href="https://msgsuite.eu.org">Shared Drive Generator</a> Website or you can also use MsGsuite Shared Drive Generator <a href="https://t.me/MSGuite_SD_Creator_Bot">Telegram Bot</a> to create Shared Drive.</b></h4>
<h4><b><i>🌐Using Website:</i></b></h4>
<h4><b>1.Open Website and provide details stated below:</b></h4>
<p><b><code>Shared Drive Name</code>: Enter Name which you want to give to your Shared Drive. It can be anything but avoid using Emojis to prevent UTF-8 Errors</b></p>
<p><b><code>Gmail ID</code>: Enter your Google Account's Email ID for which you want to create Shared Drive.</b></p>
<p><b><code>Domain Selection</code>: Using drop-down list, select a working domain through which you want to create Shared Drive, or if you are not sure then keep it as <code>Random</code>.</b></p>
<img src="https://user-images.githubusercontent.com/87380104/180253709-a8c8f8b9-8f17-4837-adc8-6ecead61f42a.png">
<h4><b>2.Once done! Solve hcaptcha to prove that you are human and then click <code>CREATE</code>.</b></h4>
<h4><b>3.After creating, add Google Group of your Service Accounts in that Shared Drive to use it with CloneBot V2. Don't know how to? <a href="https://github.com/TheCaduceus/CloneBot_V2#-adding-in-google-group">Learn Here</a></b></h4>
<img src="https://user-images.githubusercontent.com/87380104/180262451-1240e3bd-b0f1-4403-837f-ee0b6c179beb.png">
<h4><b>4.All problems or Error codes related with MsGsuite's Website with their solutions are listed <a href="https://t.me/msgsuitechat/154243">here</a>.</b></h4>
<h4><b><i>🤖Using Telegram Bot:</i></b></h4>
<h4><b>1.Open MsGsuite's Telegram Bot on Telegram and send <code>/start</code>, then click <code>CREATE TD</code>.</b></h4>
<h4><b>2.Now provide your Gmail ID for which you want to create Shared Drive and then give name to your Shared Drive.</b></h4>
<h4><b>3.After giving required details! Bot will ask you to either select domain randomely or manually! select as per your choice. Finally! You done it.😘</b></h4>
<img src="https://user-images.githubusercontent.com/87380104/180258551-4bbd0802-0655-4ec1-97e8-32aa46dce184.png">
<p><b>⛔NOTE: Shared Drive is a temporary storage! use it carefully and keep backup of your data always with you.</b></p>
<h2><b>🐍Python with PIP Installation</b></h2>
<p><b>Generally, I seen people, blindly running and ignoring options provided by Setup for installing Python and PIP which is most important thing to make <a href="https://github.com/TheCaduceus/CloneBot_V2#-service-accounts">Service Accounts</a> or to run CloneBot V2. People like it are just there to flood out support chat and abuse moderators too! Hence I made this Section to tackle this special disease. Lets name this disease Setup-Blindness😂</b></p>
<h4><b>1.Run the Python Setup again and click <code>Customize Installation</code>:</b></h4>
<img src="https://user-images.githubusercontent.com/87380104/180266218-8a8f822f-d7f6-4896-862c-ffa196d7cdee.png">
<h4><b>2.Now select all options as shown in the image and click <code>Next</code>.</b></h4>
<img src="https://user-images.githubusercontent.com/87380104/180266623-ae7ef39f-6c0a-4ea1-8b9c-8d2d1f041cfd.png">
<h4><b>3.Again! choose following options and click <code>Install</code> and you done it!</b></h4>
<img src="https://user-images.githubusercontent.com/87380104/180266946-ed1bc4e3-2b9a-47c5-83ea-45445d04cadb.png">
<h4><b>4.Above steps solves below Errors:</b></h4>
<p><b><code>'python3' is not recognized as an internal or external command,
operable program or batch file.</code></b></p>
<p><b><code>'python' is not recognized as an internal or external command,
operable program or batch file.</code></b></p>
<p><b><code>'py' is not recognized as an internal or external command,
operable program or batch file.</code></b></p>
<p><b><code>'pip3' is not recognized as an internal or external command,
operable program or batch file.</code></b></p>
<p><b><code>'pip' is not recognized as an internal or external command,
operable program or batch file.</code></b></p>
<h4><b>⛔NOTE: One dose is sufficient to cure this! Don't take it personally.😂</b></h4>
<h2><b>🕹️Deployment</b></h2>
<p><b>Deployment of CloneBot V2 is as simple as its usage! Their are many methods listed below to deploy CloneBot easily, but before you deploy it, you need some values listed below and how to get it:</b></p>
<p><b>
<code>path_to_gclone</code> - Path to gclone file, by default it is <code>gclone</code> or change it if you using different one.<br><br>
<code>telegram_token</code> - Get your bot's Telegram API Token from <a href="https://t.me/BotFather">BotFather</a>.<br><br>
<code>user_ids</code> - Telegram User IDs of users who can use your CloneBot_V2. Separate them using <code>,</code> and first User ID is Admin.<br><br>
<code>group_ids</code> - Telegram Group IDs of Groups in which CloneBot can be used otherwise keep it <code>-1</code>. Separate them using <code>,</code><br><br>
<code>gclone_para_override</code> - Keep it blank if you don't know what it is.
</b></p>
<p><b>⛔NOTE: Everything in <code>config.ini</code> should be <code>Int</code>.</b></p>
<h3><b>📎Getting CONFIG_FILE_URL</b></h3>
<p><b><code>CONFIG_FILE_URL</code> is URL to <code>config.ini</code> file which contains values of variables discussed above, lets see how to get your <code>CONFIG_FILE_URL</code> easily:</b></p>
<h4><b>0.First open <a href="https://github.com/TheCaduceus/CloneBot_V2/blob/main/sample-config.ini"> sample-config.ini file</a> then copy its code.</b></h4>
<img src="Img/32.png" alt="32">
<h3><b>📃Using Dr.Graph:</b></h3>
<h4><b>1.Open <a href="https://drgraph.cf/">Dr.Graph</a>, enable <code>Code</code> as well as <code>Raw</code> option then paste the variables discussed above!</b></h4>
<img src="https://user-images.githubusercontent.com/87380104/191306051-931e2e02-4c01-4d38-b99d-50f7969cf447.png">
<h4><b>2.You can use Custom URL to make the final output link memorable and then press Save button as shown in the image given above.</b></h4>
<h4><b>3.It will open the new tab! just press the <code>View Raw</code> button and copy the URL from address bar which you will get after pressing it.</b></h4>
<img src="https://user-images.githubusercontent.com/87380104/191307525-0562c949-f72a-415c-99c1-013d6a9e46a8.png">
<h3><b>🤖Using File Stream Bot</b></h3>
<h4><b>1.Open <a href="https://t.me/drfilestreambot">File Stream Bot</a> on Telegram and save the above discussed values in <code>config.ini</code> file and send that file to the bot and get permanent working link.</b></h4>
<img src="https://user-images.githubusercontent.com/87380104/191310830-8600677c-03ad-4d00-9b70-ae904a8b14dd.png">
<h4><b>2.Your <code>CONFIG_FILE_URL</code> is now ready to be used.</b></h4>
<h3><b>✏️Using GitHub Gist:</b></h4>
<h4><b>1.Open <a href="https://gist.github.com" alt="GitHub Gist">GitHub Gist</a> and create a new gist and paste the code you copied above and name it as <code>config.ini</code> and now fill below values as discussed above!</b></h4>
<img src="Img/33.png" alt="33">
<h4><b>2.Then press <code>Create Secret Gist</code> then click <code>Raw</code>, it will open a New Tab in your Browser. Just copy the URL of that New Tab</b></h4>
<img src="Img/34.png" alt="34">
<img src="Img/35.png" alt="35">
<h4><b>3.Once you copied the URL! then remove <code>Commit_ID</code> from the URL:</b></h4>
<p><b>Before:<br>
https://gist.githubusercontent.com/UserName/0ee24eXXXXXXXXXXXXXXX6b/raw/<code>Commit_ID</code>/config.ini<br>
After:<br>
https://gist.githubusercontent.com/UserName/0ee24eXXXXXXXXXXXXXXX6b/raw/config.ini
</b></p>
<!---Docker--->
<h2><b>🐳Build or Deploy using Docker</b></h2>
<p><b>CloneBot V2 can be deployed almost everywhere using Docker, either you can create your own Docker Image using Build Tool provided in the Workflow including <code>Docker-Code</code>. While CloneBot V2 also have ready to use Docker image for systems based on <code>AMD 64</code>.</b></p>
<h4><b>1.To pull CloneBot V2 Docker Image:</h4>
<p><b>-><code>docker pull ghcr.io/thecaduceus/clonebot-v2:main</code></b></p>
<h4><b>2.Or, to use as base Image:</b></h4>
<p><b>-><code>FROM ghcr.io/thecaduceus/clonebot-v2:main</code></b></p>
<h4><b>3.Old Docker Image <code>ghcr.io/thecaduceus/clonebot_v2:main</code> is now no more supported and deprecated!</b></h4>
<h4><b>4.Want to build own docker image? alright! <a href="https://github.com/TheCaduceus/CloneBot_V2/blob/main/.github/workflows/Docker-Build-Guide.md" alt="Build Docker Guide">here</a> is the guide.</b></h4>
<p><b>⛔NOTE:</b></p>
<p><b>1.Docker Image only accepts <code>CONFIG_FILE_URL</code></b></p>
<p><b>2.Use your own Docker Image for deploying on VPS only! Using it for deploying on platforms like Heroku, Okteto or Scalingo will simply cause Account suspension.</b></p>
<h2><b>🕊️Deploy on Fly</b></h2>
<p><b>Fly.io is platform and best alternative of Heroku (Salesforce) becuase here you can deploy your apps by just adding Credit Card (without being charged) or anyother payment methods, unlike Heroku, they offers you 2,340 running hours per month while Heroku only provides 550 running hours (dyno hours) to run your app! that means you don't have to worry about suddenly getting your app stopped like in the case of Heroku. Fly.io also not restarts your app each 24 hours which enables you to clone bigger data easily.</b></p>
<h4><b>1.Create an account on <a href="https://fly.io/app/sign-in">Fly.io</a>.</b></h4>
<img src="https://user-images.githubusercontent.com/87380104/186624984-a8a4e199-3f04-4456-a9a0-47a05e5632ba.png">
<h4><b>2.Install flyctl on your system.</b></h4>
<p><b><i>MacOS / Linux:</i></b></p>
<p><b><code>curl -L https://fly.io/install.sh | sh</code></b></p>
<p><b><i>Using Brew:</i></b></p>
<p><b><code>brew install flyctl</code></b></p>
<p><b><i>Windows Powershell:</i></b></p>
<p><b><code>iwr https://fly.io/install.ps1 -useb | iex</code></b></p>
<p><b><i>Termux:</i> (Refer <a href="https://github.com/TheCaduceus/CloneBot_V2/discussions/54">#54</a>)</b></p>
<p><b><code>pkg install flyctl</code></b></p>
<h4><b>3.Download CloneBot_V2 Repository:</b></h4>
<p><b><code>git clone https://github.com/TheCaduceus/CloneBot_V2</code></b></p>
<h4><b>4.Now run following commands:</b></h4>
<p><b>
<code>cd CloneBot_V2</code> - To change directory.</br>
<code>fly auth login</code> - To login on Fly.io.</br>
<code>fly launch</code> - To configure basic things, like app name and data center as well as creating <code>fly.toml</code>.
</b></p>
<h4><b>5.Configure App:</b></h4>
<p><b>1.For app name keep the field empty (Hit <code>Enter</code>), and for choosing data center! use arrow keys to select one. For attaching Postgres Database enter
<code>N</code> including for Deploy Now.</b></p>
<img src="https://user-images.githubusercontent.com/87380104/186633010-ff7ca124-0026-4385-a2d6-d9ccc010b832.png">
<p><b>2.Once you run the above command! it will automatically create <code>fly.toml</code> file, open the <code>fly.toml</code> file with any text editor and under <code>[env]</code> section put your <code>CONFIG_FILE_URL</code> which you created above!</b></p>
<img src="https://user-images.githubusercontent.com/87380104/186635091-dcc791b7-cd43-44ed-a66a-3d6cec26320d.png">
<p><b>3.Everything done! now run the final deploy command to deploy your app.</b></p>
<p><b><code>fly deploy</code> - To deploy your app.</b></p>
<p><b>⛔NOTICE: You can use <code>flyctl</code> instead of <code>fly</code>.</b></p>
<h4><b>🧿Using GitHub Actions</b></h4>
<p><b>CloneBot V2 can also be deployed on Fly.io using GitHub Actions, this method is useful if you don't have PC or you can't download <code>flyctl</code> on Termux due to architecture limitations.</b></p>
<p><b>1.Set following secret in GitHub Secrets:</b></p>
<p><b><code>FLY_API_TOKEN</code>: Get your Fly API Token from <a href="https://fly.io/user/personal_access_tokens">here</a>.</b></p>
<p><b><code>APP_NAME</code>: Fly App name of your choice </b></p>
<p><b><code>CONFIG_FILE_URL</code>: <code>CONFIG_FILE_URL</code> created above</b></p>
<p><b>2.Go to <code>Actions</code> Tab and run <code>Deploy to Fly</code> workflow.</b><p>
<h2><b>♦️Deploy on Clever Cloud</b></h2>
<p><b>Clever Cloud is a Europe-based PaaS (Platform as a Service) company. They help developers deploy and run their apps with bulletproof infrastructure, automatic scaling as well as fair pricing. In my opinion! it is best choice to deploy CloneBot V2 on Clever Cloud because pricing is excellent & fair as well as you can run CloneBot V2 for days to clone large amount of data.</b></p>
<p><b>⛔NOTICE: Before deploying/running CloneBot V2 on Clever Cloud! Don't forget to add payment method like credit card in your account to verify your account otherwise deploying and using CloneBot V2 on Clever Cloud will cause suspension of your app/account.</b></p>
<h4><b>1.First log in on <a href="www.clever-cloud.com">Clever Cloud</a>.</b></h4>
<img src="https://user-images.githubusercontent.com/87380104/184601649-db7a14f5-9eb0-4da8-8709-32f58a339c09.png">
<h4><b>2.Now click on <code>Create</code> and then select <code>an application</code> from the list.</b></h4>
<img src="https://user-images.githubusercontent.com/87380104/184602348-3165036a-bb54-47b1-8ec2-7a3e019c9333.png">
<h4><b>3.Once you reach "Application Creation" page, choose "Create an application from GitHub repository" and select the CloneBot V2 Repository. Not visible? fork this!</b></h4>
<img src="https://user-images.githubusercontent.com/87380104/184602864-f01c6b56-0fe5-4360-9e26-531e8aea2cef.png">
<h4><b>4.Done? now specify the application type by choosing our beloved <code>Docker</code>.😘</b></h4>
<img src="https://user-images.githubusercontent.com/87380104/184603233-e4427ea0-fce6-4420-85bf-4b4fb0660005.png">
<h4><b>5.After that! directly click <code>Next</code> on "How many number of instances?" page and keep the number of instance only 1. Additionally, you can keep instance type to <code>Nano</code> which is most cheap because CloneBot V2 is designed to run on very low end systems.</b></h4>
<img src="https://user-images.githubusercontent.com/87380104/184603755-cf8f55a6-2c41-4112-b24c-22fb36878479.png">
<h4><b>6.Provide your instance a beautiful name, it can be "CloneBot V2" itself, and for instance location, you can choose <code>Paris France</code> for lower ping (tested!😉).</b></h4>
<img src="https://user-images.githubusercontent.com/87380104/184604532-d1e3db06-1778-482c-a0d8-bd41cc5dbe1d.png">
<h4><b>7.Now it will navigate to "Add-ons" page, simply click <code>I DON'T NEED ANY ADD-ONS</code> because... you already know it!🌟 still why? it is designed for low end systems.</b></h4>
<img src="https://user-images.githubusercontent.com/87380104/184605060-83283c09-043b-475e-90ca-a9e4ad315a71.png">
<h4><b>8.Then enter <code>CONFIG_FILE_URL</code> as variable name and the <code>CONFIG_FILE_URL</code> which you just made <a href="https://github.com/TheCaduceus/CloneBot_V2#getting-config_file_url">here!</a> and Clever Cloud will start deploying your instance.</b></h4>
<img src="https://user-images.githubusercontent.com/87380104/184605716-4dd3d534-b866-45fc-af43-39c0a11e7c2c.png">
<h4><b>9.Finally! to check if CloneBot V2 is working perfectly, you can open the domain (it will display the guide) provided by Clever Cloud for your instance which can be collected from <code>Domain Names</code> tab and for logs you can check <code>Logs</code> tab.</b></h4>
<img src="https://user-images.githubusercontent.com/87380104/184609344-9d32243c-f8d8-4b22-9ee1-1c8cec455b9e.png">
<!---Okteto--->
<h2><b>🪬Deploy on Okteto</b></h2>
<p><b>Okteto is Kubernetes development platforms and used by many users and it is ideal for lightweight apps and it is perfect for CloneBot V2, Okteto is worst than Heroku, your bot will sleep after 24 hours and will not get back to online until you ping the provided ENDPOINT.</b></p>
<h4><b>1.First Create your Okteto Account, You need one GitHub account as okteto supports only one Method to either Create or Login:<a href="https://cloud.okteto.com/#/login" alt="Login on Okteto"> Create/Login on Okteto</a></b></h4>
<img src="Img/38.png" alt="38">
<h4><b>2.Now fork this repository, and go to Okteto Dashboard then press "Launch Dev Environment".</b></h4>
<img src="Img/39.png" alt="39">
<h4><b>3.After it, select your forked repository and select branch <code>main</code> and add following value carefully:</b></h4>
<p><b>
<code>CONFIG_FILE_URL</code> - Enter <code>CONFIG_FILE_URL</code>, which you just made <a href="https://github.com/TheCaduceus/CloneBot_V2#getting-config_file_url">here</a>.<br>
</b></p>
<img src="Img/40.png" alt="40">
<h4><b>4.Once done! press "Launch" and you successfully done it! Yes 😊</b></h4>
<h4><b>5.Okteto make your deployed app to sleep if provided ENDPOINT (Allotted URL) remain untouched for 24 Hours. So lets setup a simple cron-job to keep your app active.</b></h4>
<h4><b>6.First copy your app's ENDPOINT as shown in the image and go to <a href="https://cron-job.org/en" alt="Cron-Job">Cron-Job.org</a> and sign up!</b></h4>
<img src="Img/41.png" alt="41">
<img src="Img/42.png" alt="42">
<h4><b>7.Done? Nice! now click "CREATE CRONJOB" button and provide your copied ENDPOINT URL that you just copied and change execution schedule to every 5 minutes.Finally! click "CREATE" and you done it! 😌 Relax and use CloneBot V2 freely.</b></h4>
<img src="Img/43.png" alt="43">
<p><b>⛔NOTE: Don't forget to setup Cron-Job for Okteto otherwise your deployed bot will go into sleep and you have to active it from Okteto Dashboard, while Cron-Job doing it on your behalf.</b></p>
<!---Deploy-on-VPS/PC--->
<h2><b>🖥️ Deploy on VPS or PC</b></h2>
<p><b>Running CloneBot V2 on your PC or VPS is very simple and takes very less efforts! It have very less load on your System and don't use your bandwidth or Internet connection for cloning Google Drive data but only for calling Telegram APIs to update the progress or to generate required response.</b></p>
<h4><b>1.Download Requirements:</b></h4>
<p><b>
-><a href="https://www.python.org/downloads/">Python 3 or above with pip</a><br>
-><a href="https://git-scm.com/downloads">Git</a>
</b></p>
<h4><b>2.Download Repository:</b></h4>
<p><b>
-><code>git clone https://github.com/TheCaduceus/CloneBot_V2</code><br>
->Or Download from <a href="https://drfilestreambot.cf/AgADJA4573">Here</a>
</b></p>
<h4><b>3.Install CloneBot_V2 Requirements:</b></h4>
<p><b>
-><code>cd CloneBot_V2</code><br>
-><code>pip install -r requirements.txt</code>
</b></p>
<h4><b>4.Download Gclone:</b></h4>
<p><b>
->Go to <a href="https://clonebot.tk/0:/">Gclone Library</a> and download Gclone file as per your Operating System and place it in "telegram_gcloner" folder.<br>
->Website provides direct download link, so you can also use Command-line to download Gclone.<br>
Linux:<br>
-><code>curl download_link_here >> telegram_gcloner/gclone</code><br>
Windows:<br>
-><code>curl download_link_here >> telegram_gcloner/gclone.exe</code>
</b></p>
<h4><b>5.Edit <code>Config.ini</code> file</b></h4>
<p><b>
->Open <code>Config.ini</code> file in any text editor and enter the values of variables as <a href="https://github.com/TheCaduceus/CloneBot_V2#%EF%B8%8Fdeployment">written here</a><br>
<br>Or you can download your <code>Config.ini</code> file from external source using <a href="https://github.com/TheCaduceus/CloneBot_V2#getting-config_file_url">CONFIG_FILE_URL</a> by using Command-line:<br>
-><code>curl CONFIG_FILE_URL >> telegram_gcloner/config.ini</code>
</b></p>
<h4><b>6.Start CloneBot V2:</b></h4>
<p><b>
-><code>cd CloneBot_V2</code><br>
-><code>python telegram_gcloner/telegram_gcloner.py</code>
</b></p>
<h4><b>7.Stop CloneBot V2:</b></h4>
<p><b>
->Press <code>CTRL</code> + <code>C</code> keys
</b></p>
<!---Termux--->
<h2><b>📱Deploy on Termux</b></h2>
<p><b>Termux is a best app for running and using Command-line tools on Mobile, CloneBot can also be deploy on your Mobile using Termux itself, don't worry because CloneBot V2 is very lightweight and designed to be deployed even on low-end systems and thus it will not cause heavy load on your Mobile.</b></p>
<h4><b>1.Download Termux app: <a href="https://github.com/termux/termux-app/releases" alt="Download-Termux">Download Here</a></b></h4>
<h4><b>2.Choose specific code <a href="https://github.com/TheCaduceus/CloneBot_V2/blob/main/Termux-Guide.md">from here</a> based on architecture of your phone.</b></h4>
<h4><b>3.Run the code you got from above and follow on-screen instructions.</b></h4>
<h2><b>🎲Deploy on Scalingo</b></h2>
<p><b>CloneBot V2 is also deployable to Scalingo cloud, Just deploy <code>Scalingo</code> Branch.</b></p>
<p><b>Switch to <a href="https://github.com/TheCaduceus/CloneBot_V2/tree/Scalingo">Scalingo Branch</a> for guide.</b></p>
<!---Creating Service Accounts--->
<h2><b>🪪 Service Accounts</b></h2>
<p><b>Service Accounts are just like normal Google Account and thus have same Upload or Download limits as Google Account which is 750GB Upload and 10TB Download. They are used to act on behalf of a Google Account and hence we can use them to prevent hitting Google Drive limits by creating them in a bulk amount. After creating Service Accounts, we have to add them in Google Group so that we can directly add Google Group's Email ID in Shared Drive at place of adding each Service Accounts manually.</b></p>
<h3><b>🛠️ Create Service Accounts</b></h3>
<h4><b>1.First go to <a href="https://console.cloud.google.com/welcome">Google Cloud Console</a> and select "Create or select a project" then click "CREATE PROJECT" as shown in the image.</b></h4>
<img src="Img/1.png" alt="1">
<img src="Img/2.png" alt="2">
<h4><b>2.Now give your Project Name, for location select "No organization" and click "CREATE".</b></h4>
<img src="Img/3.png" alt="3">
<h4><b>3.Once your project is created! then click "SELECT PROJECT". Now click on hamburger menu and hover the cursor on "APIs and services" after which a small drop-down menu list is visible, select "Enabled APIs and services"</b></h4>
<img src="Img/4.png" alt="4">
<img src="Img/5.png" alt="5">
<h4><b>4.After it, Click "ENABLE APIS AND SERVICES" button and search for "Google Drive API" in the Search bar as shown in the image.</b></h4>
<img src="Img/6.png" alt="6">
<img src="Img/7.png" alt="7">
<h4><b>5.Open "Google Drive API" and click on "ENABLE" button to enable it for your Project.</b></h4>
<img src="Img/8.png" alt="8">
<h4><b>6.Once Enabled, Click on "OAuth consent screen" then select "External" as "User Type" and click "CREATE" button.</b></h4>
<img src="Img/9.png" alt="9">
<img src="Img/10.png" alt="10">
<h4><b>7.It will now open "Edit app registration" screen, provide App Name, Support Email and Developer Email ID (Same as Support Email ID) and then click "SAVE AND CONTINUE" button.</b></h4>
<img src="Img/11.png" alt="11">
<h4><b>8.Now it will ask you to "ADD OR REMOVE SCOPES", just ignore this and directly click "SAVE AND CONTINUE" button. Then it will ask you to "ADD USERS" again ignore it and directly press "SAVE AND CONTINUE"</b></h4>
<img src="Img/12.png" alt="12">
<img src="Img/13.png" alt="13">
<h4><b>9.At summary page, press "BACK TO DASHBOARD" and click "PUBLISH APP".</b></h4>
<img src="Img/14.png" alt="14">
<img src="Img/15.png" alt="15">
<h4><b>10.After publishing, Select "Credentials" and click "CREATE CREDENTIALS", from drop down list select "OAuth Client ID".</b></h4>
<img src="Img/16.png" alt="16">
<img src="Img/17.png" alt="17">
<h4><b>11.Choose Application type as "Desktop app" and press "CREATE" button. Now create a Folder on your computer with name like "My Service Accounts", and then from pop-up click "DOWNLOAD JSON". Download the json file as <code>credentials.json</code> in the folder you just created.</b></h4>
<p><b>⛔NOTE: Download json file as <code>credentials.json</code> only!</b></p>
<img src="Img/18.png" alt="18">
<img src="Img/19.png" alt="19">
<h4><b>12.Once downloaded, now download some required python scripts <a href="https://drfilestreambot.cf/AgADHw4531">from here</a> and extract it. Then move <code>gen_sa_accounts.py</code> <code>rename_script.py</code> as well as <code>requirements.txt</code> files to folder in which you downloaded <code>credentials.json</code>.</b></h4>
<img src="Img/20.png" alt="20">
<h4><b>13.Before we proceed further, please confirm you have installed Python (with pip) carefully. Not downloaded yet?<a href="https://www.python.org/downloads/" alt="Download Python"> Download Now!</a></b></h4>
<h4><b>14.All Ready? Type "cmd" in the address bar of folder which you created in STEP 11 and hit ENTER or as an alternative of this, you can use <code>cd</code> command like <code>cd FOLDER_PATH</code> in CMD.</b></h4>
<img src="Img/23.png" alt="23">
<h4><b>15.Now run following commands carefully in CMD one-by-one:</b></h4>
<!---Commands--->
<p><b>
1. <code>pip install -U -r requirements.txt</code> - To install requirements.<br>
2. <code>py gen_sa_accounts.py</code> - To get login URL.
</b></p>
<h4><b>16.Running command 2 will give you a Login URL, just copy & paste it in your URL and login using your Google Account and provide all asked permission.</b></h4>
<p><b>⛔NOTE: Login only with Google account which you used to create Project on Google Cloud Console.</b></p>
<img src="Img/21.png" alt="21">
<img src="Img/22.png" alt="22">
<h4><b>17.Back to CMD screen, run following commands carefully one-by-one:</b></h4>
<!---Commands--->
<p><b>
3. <code>py gen_sa_accounts.py --list-projects</code> - To get the ID of your created Project.<br>
4. <code>py gen_sa_accounts.py --enable-services PROJECT_ID</code> - To Enable Services in given project.<br>
5. <code>py gen_sa_accounts.py --create-sas PROJECT_ID</code> - To create Service Accounts.<br>
6. <code>py gen_sa_accounts.py --download-keys PROJECT_ID</code> - To download Service Accounts file.<br>
7. <code>py rename_script.py</code> - To rename Service Accounts file in 1-100 sequence.
</b></p>
<p><b>⛔NOTE: Replace <Code>PROJECT_ID</code> with Project ID which you will get from command 3 and if commands not working then replace <code>py</code> with <code>python</code> or <code>python3</code>.</b></p>
<h4><b>18.Till now, We have created 100 Service Accounts but we have to do some more work before we take them in our use. Open folder which you created in STEP 11 and you will see <code>accounts</code> folder in it which have your 100 Service Accounts file (json files), now type "Powershell" in address bar of accounts folder or as an alternative you can use <code>cd</code> commands like <code>cd FOLDER_PATH</code> in Powershell.</b></h4>
<img src="Img/24.png" alt="24">
<h4><b>19.Done? Now run following command:</b></h4>
<p><b><i>MacOS / Linux:</i></b></p>
<p><b>
<code>grep -oPh '"client_email": "\K[^"]+' *.json > emails.txt</code>
</b></p>
<p><b><i>Windows:</i></b></p>
<p><b>
<code>$emails = Get-ChildItem .\**.json |Get-Content -Raw |ConvertFrom-Json |Select -ExpandProperty client_email >>emails.txt</code>
</b></p>
<h4><b>20.Above command collects the EMAIL-ID of all your Service Accounts available in <code>accounts</code> folder into <code>emails.txt</code> file. Move <code>emails.txt</code> file from accounts folder to prevent confusion or any other problem.</b></h4>
<h3><b>🌐 Adding in Google Group</b></h3>
<h4><b>21.Last work! we have to add them in a Google Group and have to add that Google Group in a Shared Drive to give read + write permission to all Service Accounts at once. Go to <a href="https://groups.google.com" alt="Create Google Group">Google Groups</a> and press "Create group" button to create a group.</b></h4>
<img src="Img/25.png" alt="25">
<h4><b>22.In pop-up, fill up details of your Google Group like Name and Email ID as shown in the image then press "Next". After it, let privacy settings as it is and again click "Next"</b></h4>
<img src="Img/26.png" alt="26">
<img src="Img/27.png" alt="27">
<h4><b>23.Once done, it will ask you to "Add Members" in your Group as shown in the image,just ignore it and directly press "Create Group". Now open your Google Group and select "Members" from sidebar and click "Add Members"</b></h4>
<img src="Img/28.png" alt="28">
<img src="Img/29.png" alt="29">
<h4><b>24.In the pop-up shown, enable "Directly add members" and open <code>emails.txt</code> file which you got from STEP 19 then copy & paste 10 Email IDs in the field named "Group Managers". In this way! add all 100 Email IDs in your Google Group but only 10 Email IDs at once.</b></h4>
<img src="Img/30.png" alt="30">
<h4><b>25.After adding all Email IDs of your Service Accounts, now copy the Email ID of your Google Group which looks like <code>[email protected]</code> and add it in your Shared Drives as "Manager".</b></h4>
<img src="Img/31.png" alt="31">
<h4><b>26.Finally! We have created 100 Service Accounts and also added them in Google Group. Each Service Account have 750 GB Upload/Clone limit and 10 TB Download limit that means now we can upload/clone 75 TB and can download 100 TB a day.</b></h4>
<h2><b>⛑Contact Us!</b></h2>
<h4><b>Join my Update Channel on Telegram:<a href="https://t.me/TheCaduceusOfficial"> Join Now!</a></b></h4>
<h4><b>Special Torrent Group on Telegram:<a href="https://t.me/DrTorrent"> Dr.Torrent</a></b></h4>
<h4><b>Directly Contact the Developer using Telegram <a href="https://telegram.me/HelpAutomatted_Bot">@HelpAutomatted_Bot</a></b></h4>
<h2><b>❤️Credits & Thanks</b></h2>
<h4><b>🔥CloneBot V2:</b></h4>
<p><b><a href="https://github.com/TheCaduceus">Dr.Caduceus</a>: For making this Project and Guide.</b></p>
<p><b><a href="https://github.com/l3v11">Levi</a>: For Gclone and upgrading it.</b></p>
<h4><b>⚡CloneBot:</b></h4>
<p><b>
<a href="https://github.com/wrenfairbank/telegram_gcloner">wrenfairbank</a>: For the original python script.<br>
<a href="https://github.com/smartass08/telegram_gcloner">smartass08</a>: To adapt the scrip to heroku.<br>
<a href="https://github.com/anymeofu/CloneBot">anymeofu</a>: For making the Direct Heroku deployable Version.<br>
<a href="#">Zero-The-Kamisama</a>: To making MsGsuite discover this amazing bot and the detailed instructions.<br>
<a href="https://t.me/zorgof">zorgof</a>: For the termux script.<br>
<a href="https://github.com/aishik2005">Aishik Tokdar</a>: For Adding Guide to Deploy on Railway.app , Qovery , Clever Cloud , Scalingo and some other Code Improvements.Also Added Heroku Workflow Deployment Method.<br>
<a href="https://github.com/tiararosebiezetta">Katarina</a>: For adding the ability to be deployed to Clever Cloud and Scalingo.<br>
<a href="https://github.com/missemily2022">Miss Emily</a>: For adding Support of Okteto Cloud Deployment as well as improving little layout.
</b></p>
<h4><b>🍵Other Projects</b></h4>
<p><b><a href="https://drgraph.cf/">Dr.Graph</a> Online Anonymous Text / Pasting platform without limits.</b></p>
<p><b><a href="https://drfilestreambot.t.me/">Dr.FileStreamBot</a> Get Download / Stream links for Telegram files and use as host.</b></p>
<footer class="site-footer">
<span class="site-footer-credits"><b>Copyright Owner: <a href="https://github.com/TheCaduceus">Dr.Caduceus</a>.</b></span>
</footer>
</main>
</body>
</html>
<!--- End of File --->