https://github.com/fcusson/srt-align
a CLI tool to align a subrip file with video file
https://github.com/fcusson/srt-align
srt subrip video-source
Last synced: about 1 year ago
JSON representation
a CLI tool to align a subrip file with video file
- Host: GitHub
- URL: https://github.com/fcusson/srt-align
- Owner: fcusson
- License: gpl-3.0
- Created: 2021-06-10T12:37:14.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2021-06-22T16:41:01.000Z (almost 5 years ago)
- Last Synced: 2025-02-15T05:19:29.424Z (over 1 year ago)
- Topics: srt, subrip, video-source
- Language: C#
- Homepage:
- Size: 31.2 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# SRT Align
SRT Align is a CLI software that can edit timestamp in an SRT file (SubRip) to align the timing with the video Source. The tool can help for two types of offset:
- **Shift**: help with different duration of files and one source is faster than the other
- **Linear**: when the subtitle is always slightly before or being the video source due to wrong start time
## Installation
### Windows
#### Installer
1. Download the most recent release (srt-align_Setup.exe)
2. Run the installer
#### Manual
1. Download the most recent release (srt-align.exe)
2. Place the file in your folder of choice
3. Add the location of srt-align.exe to your environnement variable (PATH) for access from anywhere in cmd/powershell
### Linux
#### Manual
1. Download the most recent release(srt-align)
2. Place the file in your folder of choice
3. Add a symbolic link in /usr/local/bin
## Usage
The structure of the commands for the tool is has followed:
> srt-align {--shift|--linear} [OPTIONS...] \ [output]
### Options
| Option | Description |
|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------|
| -h --help | Show the help panel |
| -v --version | Show the package version |
| -s --shift | Shifts the timestamp of a file based on a mutiple ratio (floating point value) where 1 means no change. |
| -l --linear | Increase or decrease the timestamp value of a file based on a timestamp provided. The timestamp must be in a valid format for srt file ([-]##:##:##,###) |
| -o --overwrite | Tells the program to overwrite the input file that was provided. |
A choice must be made between a shift alignement and a linear alignement. Both cannot be inputed at the same time.
### Input/Output
- **input:** The input srt file that must be provided. This file is mandatory.
- **output:** The ouptut file for the srt file after modification. This item is optional. If this value is ommited, the file will be named after the input name with "-edited" at the end. The file will be placed in the input file directory.
## Licence
[GPL3](LICENSE)