Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/itsamirhn/subdesc
A simple tool for working with Subtitles
https://github.com/itsamirhn/subdesc
Last synced: 25 days ago
JSON representation
A simple tool for working with Subtitles
- Host: GitHub
- URL: https://github.com/itsamirhn/subdesc
- Owner: itsamirhn
- Created: 2023-10-06T13:13:28.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2023-10-07T04:49:30.000Z (about 1 year ago)
- Last Synced: 2023-10-07T14:20:22.893Z (about 1 year ago)
- Language: Python
- Homepage:
- Size: 26.4 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Subdesc
A simple utility module for Subtitles.
### Installation 🛠️
Subdesc requires `mkvtoolnix` and `ffmpeg` for working with mkv files. You can install them with the following commands:
```bash
brew install mkvtoolnix
brew install ffmpeg
```
Then, Just run `pip install subdesc`
## Usage 🍿
You can use Subdesc as a command line tool as follows. `subd` can be replaced with `subdesc` as well.
### Muxing Video and Subtitle
When you want to attach subtitle to your mkv file as softsub:
```bash
subd mux
```
### Normalizing Subtitle
When your subtitle file has weird encoding and it's not human-readable:
```bash
subd normalize
```
### Sync Subtitle
When your subtitle file is out of sync with your video file:
```bash
subd sync
```
`source_file` could be a mkv file or another subtitle file
### Magic 🪄
When you have OCD like me and you want to apply all of the above commands at once:
```bash
subd magic
```
This will overwrite video file with the new one.
## Caution ⚠️
Subdesc is still in development, and it's not stable yet.
It could delete your input files in case of interruption. So please take a backup and use it at your own risk.
## Contributing 🤝
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
## License 📄
[MIT](https://choosealicense.com/licenses/mit/)