Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/sanjevirau/gsubs

A desktop app that finds you the perfect subtitle match.
https://github.com/sanjevirau/gsubs

electron electron-app subtitle-downloader subtitledownloader subtitles windows

Last synced: 9 days ago
JSON representation

A desktop app that finds you the perfect subtitle match.

Awesome Lists containing this project

README 

        


  gSubs Logo








  




  banner

  


  
INTRODUCTION


  
Meet gSubs. 
 A desktop app that finds you the perfect subtitle match for your videos. Simply download now and drag and drop videos to get started.

 gSubs is multi-platform, open-source, and built entirely on web technology.


  
Download gSubs


  


  

  

  

  

  

  

  







## 💡 Key Features

The following features made what gSubs is today and many more features will be, hopefully added with the support of great open source community in the future.



#### Drag & Drop

Just drag and drop the video files that you want to search subtitle for and gSubs will do it's job. No more browsing and selecting videos from the mysteries directories that you don't know.



#### Multiple Files

gSubs supports multiple files input, meaning you can drag and drop as many files as you want and gSubs will find subtitles for each and every file. You have an entire season with dozen of episodes? gSubs gets your subtitles for the entire season in one time.



#### Search Subtitles

You don't have a video file but just want to donwload your favourite movies or series subtitles? Don't worry, gSubs consists of the search function where you can input any queries for search. gSubs will give you the results according to the language that has been set.



#### 10 Languages

gSubs are capable of finding you subtitles for 10 languages which are English, Español, Français, Italiano, Nederlands, Polski, Português, Român, Svenska and Türkçe. Many more languages will be added soon.



#### Auto Update

gSubs have auto update feature included in it. This means you don't have to manually download the latest release every time. gSubs downloads and installs the latest release automatically.







## ⚡️ Contributing



gSubs is completely open-source. If you'd like to help out by adding features, working on bug fixes,

or assisting in other parts of development, here's how to get started:



###### To begin working locally:



1. [Fork](https://help.github.com/articles/fork-a-repo/) this repository to your

   own GitHub account

2. [Clone](https://help.github.com/articles/cloning-a-repository/) it to your

   local device: `git clone [email protected]:sanjevirau/gsubs.git`

3. Install the dependencies: `npm install`

4. Run the app by starting electron, building the code and watch for changes:

   `npm start`

   ###### To build for production (should not generally be used):

5. Build the actual app for Windows: `npm run

   dist`

6. gSubs can also be build into Mac and Linux by change the `dist` script to `build -wlm --config` in the `package.json` file and then building the app using `npm run dist`



We does give you credits for your contributions. Every contributors name will be shown in our contributors page at [gSubs Contributors](http://cholaware.com/gsubs/contributors.php).







## 📦 Sources



gSubs currently uses 2 sources to gather subtitles. When user drag and drop the video files, gSubs looks into SubDB source first followed by OpenSubtitles source. We hope to add more sources in the future.



###### Standard sources:



* [x] SubDB

* [x] OpenSubtitles

* [ ] Addic7ed







## 🌟 Special Thanks

We would like to thank the following great beings and projects for assisting and giving us the motivation to build gSubs directly or indirectly.



* [Caption](https://github.com/gielcobben/caption)

* [Giel Cobben](https://github.com/gielcobben)

* [Vernon de Goede](https://github.com/vernondegoede)

* [Martin Wolf](https://github.com/martinwolf)

* [Semantic Organization](https://github.com/Semantic-Org)

* [Electron](https://github.com/electron/electron)

* [Visual Studio Code](https://github.com/Microsoft/vscode)



and to all the great beings who are helping building great things to make our life easier at [GitHub](https://github.com/).







## ☕  Donation

If this project helps you in any way making your life easier, you can give us some donation to get gSubs released in Mac OS and Linux.



  

  






## 🔑 License

This project is licensed under

[MIT](https://github.com/gielcobben/Caption/blob/master/LICENSE) ©

[Cholaware](https://cholaware.com)