aaronhff8 / gsubs

A desktop app that finds you the perfect subtitle match.

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 this repository to your own GitHub account
2. Clone 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.

📦 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:

• SubDB
• 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
• Giel Cobben
• Vernon de Goede
• Martin Wolf
• Semantic Organization
• Electron
• Visual Studio Code

and to all the great beings who are helping building great things to make our life easier at GitHub.

☕ 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 © Cholaware