You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
An application for easily download video content from Crunchyroll combining youtube-dl and mkvmerge. Build a fancy-mkv file with subtitles and fonts attached
6
+
7
+
## Features
8
+
9
+
- Choose between softsub or hardsub (no transcoding!)
10
+
- Choose as you want to download: individual episode, several episodies or full series
11
+
- Choose which quality you want to get (from 240p to 1080p)
12
+
- On softsubbing, attach only one subtitle track or all subtitles track
13
+
- On softsubbing, attach your own fonts to the mkv file
14
+
- On softsubbing, warn if there are fonts missing
15
+
- Spoof your user-agent and cookies file for logging with your account
16
+
17
+
## How to use this image?
18
+
19
+
Before starting, you must get your cookies file (to export your Crunchyroll authentication) and know which is your user agent (even if you haven't an account, just for bypassing Cloudflare).
20
+
21
+
To next, you must prepare a volume where you will place your future downloads. In this folder, you must put your cookies file too. The container path for the downloads will be /downloads
22
+
23
+
Additionally, you could prepare a volume where you will place custom fonts. (A warning appears while downloading a video when a font is missing). The container path for the fonts will be /fonts
24
+
25
+
### Examples
26
+
27
+
# For first time or receiving updates
28
+
sudo docker pull beardoverflow/mergecrunch
29
+
30
+
# Example
31
+
sudo docker run--rm -it \
32
+
-v /home/beardoverflow/downloads:/downloads \
33
+
-v /home/beardoverflow/.fonts:/fonts \
34
+
beardoverflow/mergecrunch \
35
+
-i https://www.crunch... \
36
+
--ua 'PUT HERE YOUR USER AGENT' \
37
+
-c /downloads/cookies.txt \
38
+
-f 720p -s esES
39
+
40
+
### Configuration
41
+
42
+
-i Input single video URL or playlist URL
43
+
-c Container path to the cookies file
44
+
-x Renames the file appending its CRC32 hash at the end of filename
45
+
-f Video quality. Accepted values: worst, 240p, 360p, 480p, 720p, 1080p, best
46
+
-s Set the default subtitle track. Required on: --one, --hard. Accepted values: enUS, esES,esLA, frFR, itIT, ptBR, ptPT, deDE, arME, ruRU, jaJP
47
+
--one On softsubing, it merges only the default subtitle track. If it absents, then all available subtitles track will be merged
48
+
--hard Forces hardsubing, any subtitle track will be omitted
49
+
50
+
## How to get your cookies file? (For using your premium account)
Copy file name to clipboardexpand all lines: README.md
+85-76
Original file line number
Diff line number
Diff line change
@@ -1,88 +1,106 @@
1
1
2
2
3
3
***
4
+
## What is MergeCrunch?
4
5
5
-
## Description
6
+
An application for easily download video content from Crunchyroll combining youtube-dl and mkvmerge. Build a fancy-mkv file with subtitles and fonts attached.
6
7
7
-
MergeCrunch is a small bash script (/ironic off) that combines youtube-dl and mkvmerge for getting anime.
8
+
## Docker image
8
9
9
-
The main feature is to generate a pretty mkv file with all availables soft-subtitles from **Crunchyroll** site and after required fonts are attached from fontconfig.
10
+
==This is the recommended way to use this application==
10
11
11
-
Now support to premium users!!
12
+
Find this project on DockerHub. Its latest release is working fully at March 20th, 2019
12
13
13
-
Now support to playlist URLs and playlist selection!!
14
+
**Zero-configuration, for any operating system (Windows, MacOS and Linux). Just pull and run**
14
15
15
-
Now support to cookies file!!
16
+
More information at https://hub.docker.com/r/beardoverflow/mergecrunch
16
17
17
-
Now support to spoof your location!!
18
+
## Features
18
19
19
-
Now support to spoof your user-agent!!
20
+
- Choose between softsub or hardsub (no transcoding!)
21
+
- Choose as you want to download: individual episode, several episodies or full series
22
+
- Choose which quality you want to get (from 240p to 1080p)
23
+
- On softsubbing, attach only one subtitle track or all subtitles track
24
+
- On softsubbing, attach your own fonts to the mkv file
25
+
- On softsubbing, warn if there are fonts missing
26
+
- Spoof your user-agent and cookies file for logging with your account
20
27
21
-
Now support for hardsub or softsub both!!
28
+
## Usage
22
29
23
-
==Tested in Ubuntu 16.04 Xenial, 18.04 Bionic and Debian 9 Stretch, 10 Buster==
30
+
In this section, I will illustrate how to use the application with examples:
24
31
25
-
## Dependencies
32
+
**Basic example (argument -i):**
26
33
27
-
You must have installed youtube-dl, fontconfig and mkvmerge, as minimum.
34
+
Input URL using argument -i. Episode will be downloaded with max resolution in the current directory.
28
35
29
-
Rhash is recommended for calculating CRC32 hash sum.
36
+
```sh
37
+
./mergecrunch.sh -i URL_CRUNCH_HERE
38
+
```
30
39
31
-
For getting this dependencies, execute the classic sudo apt-get install.
40
+
**Playlist selection (append # character in input URL):**
32
41
33
-
Note 1. For youtube-dl, I would recommend to use [nilarimogard's ppa](https://launchpad.net/~nilarimogard/+archive/ubuntu/webupd8).
42
+
For playlist selection, you must append the # character in input URL. After, use selection syntax:
34
43
35
-
Note 2. For mkvtoolnix, I would recommend to use [custom Bunkus' repository](https://www.bunkus.org/videotools/mkvtoolnix/downloads.html#ubuntu).
44
+
- "N-M" for selecting inclusive range from N to M.
Episode will be downloaded with max resolution in the current directory
56
70
57
71
**CRC32 example (argument -x):**
72
+
73
+
In this example, CRC32 will be calculated and stored in the filename.
74
+
58
75
```sh
59
76
./mergecrunch.sh -i URL_CRUNCH_HERE -x
60
77
```
61
-
Same top, but now CRC32 will be calculated and stored in the filename.
62
78
63
79
**Format example (argument -f):**
80
+
81
+
In this example, resolution will be 1280x720. Be careful with this argument, some resolution are availabled for premium users only.
82
+
64
83
```sh
65
84
./mergecrunch.sh -i URL_CRUNCH_HERE -x -f 720p
66
85
```
67
-
Same top, but now resolution will be 1280x720. Be careful with this argument, some resolution are availabled for premium users only.
68
86
69
87
Format | Description
70
88
------ | -----------
71
-
worst | The worst resolution available (generally 360p or 480p)
89
+
worst | The worst resolution available (generally 240p, 360p or 480p)
90
+
240p | 320x240 or 420x240
72
91
360p | 480x360 or 640x360
73
92
480p | 640x360 or 848x480
74
93
720p | 1280x720
75
94
1080p | 1920x1080
76
-
best | The best resolution available (generally 480p or 1080p)
95
+
best | The best resolution available (generally 480p, 720p or 1080p)
77
96
78
97
**Preferred language (argument -s) + Only one language (argument --one):**
79
98
80
-
Using a preferred language, you set a default subtitle track in your mkv. Also, title description and default output filename are set according to this language.
99
+
Using a preferred language, you set a default subtitle track in your mkv. In this example, set spanish subtitle track as preferred. If you append the --one argument, then esES subtitle track will merged exclusively.
Same top, but now I set spanish subtitle track as preferred. If you append the --one argument, then esES subtitle track will merged exclusively.
86
104
87
105
Language | Description
88
106
-------- | -----------
@@ -98,82 +116,73 @@ arME | Forces العربية
98
116
ruRU | Forces Русский
99
117
jaJP | Forces 日本語
100
118
101
-
**Hardsub switch (argument --hard):**
119
+
**Hardsubbing switch (argument --hard):**
102
120
103
121
If you wish download a hardsub video instead of merging a soft subtitle track, you can append the --hard argument. Require -s argument and implies --one argument.
Similar to choose your preferred language, you can spoof your location in order to download videos from foreign locations. The following example shows a spoof location to Russia and preferred language to American Spanish.
127
+
**Account access (argument --cookies and --ua):**
112
128
113
-
Also, default output filename will be in russian.
129
+
You must get your cookies file (to export your Crunchyroll authentication) and know which is your user agent (bypassing Cloudflare).
114
130
131
+
In order to get your cookie file (argument --cookies or -c), I would recommend to use an extension navigator such as [cookies.txt from Chrome Store](https://chrome.google.com/webstore/detail/cookiestxt/njabckikapfpffapmjgojcnbfjonfjfg) or [cookies.txt from Firefox Add-Ons](https://addons.mozilla.org/en-US/firefox/addon/cookies-txt/).
115
132
```sh
116
-
./mergecrunch.sh -i URL_CRUNCH_HERE -x -f 720p -s esLA -g ruRU
In order to get your user agent, [ask to google for getting it using the same browser where you downloaded the cookie file](https://www.google.com/search?q=what+is+my+user+agent)
Install youtube-dl, python3, fontconfig, mkvmerge and rhash
146
+
147
+
For getting this dependencies, execute the classic sudo apt-get install.
136
148
137
-
Sometimes, the login access could fail using argument -u (because youtube-dl is outdated). In this case, you could use a cookie file. In order to get your cookie file, I would recommend to use an extension navigator such as [cookies.txt from Chrome Store](https://chrome.google.com/webstore/detail/cookiestxt/njabckikapfpffapmjgojcnbfjonfjfg) or [cookies.txt from Firefox Add-Ons](https://addons.mozilla.org/en-US/firefox/addon/cookies-txt/).
With the latest changes in CR, you must set your user-agent (argument --ua) and cookies file together. [Ask to google for getting it using the same browser where you downloaded the cookie file](https://www.google.com/search?q=what+is+my+user+agent)
Note 1. Latest version of youtube-dl on [all-in-on binary](https://ytdl-org.github.io/youtube-dl/download.html)
146
154
147
-
**Playlist selection (append # character in input URL):**
155
+
Note 2. Latest version of mkvmerge on [custom Bunkus' repository](https://mkvtoolnix.download/downloads.html#debian)
148
156
149
-
For playlist selection, you must append the # character in input URL. After, according to selection syntaxis:
150
-
- "N-M" for select range from N to M.
151
-
- "N" for simple selection.
152
-
- "," as separator for multiple selections.
157
+
Fontconfig is the engine to search for fonts in your system. If the applicationg warns you about missing fonts, create a folder in your home path called ~/.fonts and put in here the missing fonts
158
+
159
+
## DEPRECATED OPTIONS
160
+
161
+
**Premium account (argument -u and -p):**
162
+
163
+
In this example, I am logging in my premium account. **Deprecated by Crunchyroll’s new verifications.** The console will prompt for username's password.
Example #3. Select IDs items from 12 to 20 and also 2, 5, 23 to 30.
175
+
**Spoof location (argument -g):**
176
+
177
+
Similar to choose your preferred language, you can spoof your location in order to download videos from foreign locations. The following example shows a spoof location to Russia and preferred language to American Spanish. **Deprecated by Crunchyroll's new verifications.**
0 commit comments