gsubs

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

★ 78 Open GitHub ↗

A desktop app that finds you the perfect subtitle match.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<img href="https://cholaware.com/gsubs" src="app/img/gsub-banner.png" alt="banner" draggable="false">
 
 <h5 align="center">INTRODUCTION</h5>
 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.
 <a href="https://cholaware.com/gsubs">Download gSubs</a>
 
 <a href="https://github.com/sanjevirau/gsubs/releases" alt="Downloads"><img src="https://img.shields.io/github/downloads/sanjevirau/gsubs/total.svg" /></a>
 <a href="https://github.com/sanjevirau/gsubs/stargazers" alt="Stars"><img src="https://img.shields.io/github/stars/sanjevirau/gsubs.svg" /></a>
 <a href="https://github.com/sanjevirau/gsubs/network" alt="Forks"><img src="https://img.shields.io/github/forks/sanjevirau/gsubs.svg" /></a>
 <a href="https://github.com/sanjevirau/gsubs/issues" alt="Issues"><img src="https://img.shields.io/github/issues/sanjevirau/gsubs.svg" /></a>
 <a href="https://github.com/sanjevirau/gsubs/blob/master/LICENSE" alt="License"><img src="https://img.shields.io/github/license/sanjevirau/gsubs.svg" /></a>
 <a href="https://paypal.me/sanjevirau" alt="License"><img src="https://img.shields.io/badge/Donate-PayPal-green.svg" /></a>

## 💡 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 git@github.com: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)

gsubs

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README