Skip to content

Commit 87432d5

Browse files
committed
Updated README
1 parent 65172ca commit 87432d5

File tree

1 file changed

+14
-14
lines changed

1 file changed

+14
-14
lines changed

README.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,44 +1,44 @@
11
[![][Logo]][Site]
22

3-
Copyright © 2014 Boni Garcia. Licensed under [GPL v3].
3+
Copyright © 2014-2015 Boni Garcia. Licensed under [GPL v3].
44

55
DualSub
66
=======
77

8-
DualSub is a tool which allows you to **merge two SRT subtitles** in a single file. The idea of using merged subtitles (let's call them *dual subtitles*) is to watch movies/series in original version with two sets of subtitles. *Why is this useful?* Dual subtitles can be used to learn a second language while watching movies/series. The typical case is when your mother tongue is not English but you want to watch movies/series in English. Then you have several options: 1. Learn English; 2. Watch it with subtitles; 3. Watch it translated to your mother language; 4. Do not watch it. DualSub is a tool for those people between options 1 and 2.
8+
DualSub is a tool which allows you to **merge two SRT subtitles** in a single file. The idea of using merged subtitles (let's call them *dual subtitles* or *bilingual subtitles*) is to watch movies/series in original version with two sets of subtitles. This can be used to learn a second language while watching movies/series. Watching movies/series with dual subtitles you will never be in doubt anymore of those expressions you do not understand, since the translation is instantaneous.
99

10-
If your English is not perfect, you usually face to idioms, words and expression you do not know. By watching movies/series with dual subtitles (i.e. its original subtitles plus a translation) you will never be in doubt anymore of those expressions you do not understand, since the translation is instantaneous.
10+
If you want to create your own dual subtitles, you need the video to be played with its subtitles. Ideally, you should have two subtitles SRT files for a single video (for instance, the first SRT subtitle in English and the second one in other language). There are plenty of web sites available to collect SRT files, for example [opensubtitles], [subscene], and so on.
1111

12-
If you want to create your own dual subtitles, you need the video to be played with its subtitles. Ideally, you should have two subtitles SRT files for a single video (for instance, the first SRT subtitle in English and the second one in other language). There are plenty of web sites available to collect SRT files, for example <a href="http://www.opensubtitles.org/">opensubtitles</a>, <a href="http://subscene.com/">subscene</a>, <a href="http://www.subtitulos.es/">subtitulos.es</a>, and so on. If you only have a SRT file, you can also <strong>translate</strong> it automatically using DualSub.
12+
DualSub also allows you to **translate SRT subtitles**. Sometimes, it is difficult to find the subtitles for a given content in two different languages. For that reason, DualSub is able to translate subtitles. To that aim, DualSub uses the Google Translate online service. You will be requested to fill up a *captcha* in order to ensure that there is are a human behind the request to Google Translate.
1313

14-
Once you have your video and SRT subtitle(s), the next important step is to decide which player you are going to use to play it. This decision is important since it will determine the available width in which subtitles are going to be displayed. Take into account that the double of text subtitles is going to be displayed. For that reason, you need to specify the player/subtitles features. These parameters are: screen width (in pixels); subtitles font family (Arial, Tahoma, ...); subtitles font size (in points). Nevertheless, the way of working of the most of the players regarding the display of subtitles is quite tricky. For example, VLC shows the size of the subtitles proportional to the video size. For this reason, this setup usually has to be tuned using trial and error.
14+
A picture is worth a thousand words:
15+
16+
![][screenshot]
1517

16-
You can see an example of dual subtitles in [YouTube]. It is a piece of Kill Bill Volume 1 with English an Spanish subtitles. Be careful if you have not seen this movie since it is the end of the movie and contains important spoilers!!!
1718

1819
Source
1920
------
2021

2122
DualSub is open source, released under the terms of [GPL v3]. The source code of this project can be cloned from the [GitHub Repository].
2223

23-
Compile
24-
-------
25-
26-
To compile the app run `mvn clean compile assembly:single`
24+
DualSub was been created with **Java** and **Maven**. To compile and build the application run the command `mvn clean compile assembly:single`
2725

2826
Downloads
2927
---------
3028

31-
DualSub has been developed in Java. Binary releases for Windows, Linux, and Mac OS X are available on [GitHub Releases].
29+
Binary releases for Windows, Linux, and Mac OS X are available on [GitHub Releases].
3230

3331
About
3432
-----
3533

36-
DualSub is a personal project of [Boni Garcia]. Comments, questions and suggestions are always very welcome!
34+
DualSub is a personal project of [Boni Garcia]. Comments, questions and suggestions are always very [welcome]!
3735

3836
[Logo]: http://bonigarcia.github.io/dualsub/img/dualsub.png
3937
[GPL v3]: https://www.gnu.org/copyleft/gpl.html
4038
[Site]: http://bonigarcia.github.io/dualsub/
41-
[GitHub Repository]: https://github.com/bonigarcia/dualsub
4239
[Boni Garcia]: http://bonigarcia.github.io/
4340
[GitHub Releases]: https://github.com/bonigarcia/dualsub/releases
44-
[YouTube]: https://www.youtube.com/watch?v=GwaeRt9bOL0
41+
[opensubtitles]: http://www.opensubtitles.org/
42+
[subscene]: http://subscene.com/
43+
[welcome]: https://groups.google.com/forum/?hl=es#!forum/dualsub
44+
[screenshot]: http://bonigarcia.github.io/dualsub/img/dualsub-collage.png

0 commit comments

Comments
 (0)