KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #typescript #codex #claude-code #mcp #rust #deepseek-harness #ai-agent #cli

SRTto3Dsubtitles

★ 14 Open GitHub ↗

Convert .srt subtitles to 3D .ass format for SBS, Over-Under, and Anaglyph video playback.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# SRT to 3D Subtitles

Convert standard `.srt` subtitles into `.ass` format, offset so they display correctly in 3D video playback.

## The Problem

When watching 3D movies (Side-by-Side, Over-Under, Anaglyph), centered subtitles get split between the left and right eye views, making them disorienting to read. This tool converts standard `.srt` subtitles into a 3D-compatible `.ass` format that keeps each eye's subtitles in the correct position.

## Features

- **SBS (Side-by-Side)** — subtitles split left/right for each eye
- **OU (Over-Under)** — subtitles split top/bottom for each eye
- **Anaglyph (Red/Green)** — subtitles offset with red/green color channels
- **CLI** — full command-line interface with configurable options
- **GUI** — lightweight Windows interface for easier mode selection
- **Formatting support** — converts HTML tags (`<b>`, `<i>`, `<u>`, `<font color>`) to ASS format codes
- **Resolution scaling** — adjusts subtitle positioning based on target resolution

## Usage

The application runs in two modes — **GUI** (no arguments) and **CLI** (with arguments).

### GUI

1. Launch `ConvertSRTto3DASS.exe` (or the Linux/macOS binary)
2. Select your `.srt` input file
3. Choose your 3D mode (SBS, OU, or Anaglyph)
4. Adjust settings as needed
5. Click **Convert**

> **Note:** The GUI is experimental. Feedback and bug reports are welcome!

### Command Line

The CLI runs on **Windows, Linux, and macOS**.

#### Drag and drop:
1. Drag and drop an `.srt` file onto `ConvertSRTto3DASS`
   - Uses default settings (SBS mode, 1280x720)
2. The resulting `.ass` file will be saved in the same directory as the `.srt`

#### Command line:
 ```

ConvertSRTto3DASS.exe input.srt [options]

```

##### Available options:
 ```

--mode sbs|ou|rg              3D mode (default: sbs)
--resx <number>               Output width
--resy <number>               Output height
--baseresx <number>           Scaling reference width (default: 1280)
--baseresy <number>           Scaling reference height (default: 720)
--fontsize <number>           Font size (default: 16)
--offsetx <number>            RG eye separation
--bottomoffset <number>       RG bottom offset
--sbssidemargin <number>      SBS side margin
--outopmargin <number>        OU top subtitle margin
--verticalmargin <number>     General vertical margin
--output <path>               Output file path
--help, -h, /?                Show help

```
 
##### Examples:
 ```

ConvertSRTto3DASS.exe movie.srt --mode sbs
 ConvertSRTto3DASS.exe movie.srt --mode ou --resx 1920 --resy 1080
 ConvertSRTto3DASS.exe movie.srt --mode rg --offsetx 6 --bottomoffset 24

```

## Known Issues

- Subtitle positional data from `.srt` files is stripped during conversion.

## Requirements

- **.NET 8 SDK** — required to build
- **Windows** — the GUI runs on Windows
- **Linux/macOS** — the CLI runs cross-platform

## Building

```bash
# Build all projects
dotnet build

# Publish CLI (self-contained)
## Linux x64
dotnet publish ConvertSRTto3DASS.Cli -c Release -r linux-x64 --self-contained true -p:PublishSingleFile=true -p:IncludeNativeLibrariesForSelfExtract=true
## OSX x64
dotnet publish ConvertSRTto3DASS.Cli -c Release -r osx-x64 --self-contained true -p:PublishSingleFile=true -p:IncludeNativeLibrariesForSelfExtract=true
## OSX arm64
dotnet publish ConvertSRTto3DASS.Cli -c Release -r osx-arm64 --self-contained false -p:PublishSingleFile=true -p:IncludeNativeLibrariesForSelfExtract=true
## Windows x64
dotnet publish ConvertSRTto3DASS.Cli -c Release -r win-x64 --self-contained true -p:PublishSingleFile=true -p:IncludeNativeLibrariesForSelfExtract=true

# Publish GUI (Windows x64 only, self-contained)
dotnet publish ConvertSRTto3DASS.Gui -c Release -r win-x64 --self-contained true -p:PublishSingleFile=true -p:IncludeNativeLibrariesForSelfExtract=true
 ```

_Each publish produces a single .exe with no .dll sidecars._

## License

## Contributing

Contributions are welcome. Please open an issue or submit a pull request.

### Contributors

- [imrayya](https://github.com/imrayya) — project owner
- [jae0815](https://github.com/jae0815)
- [fabio-noga](https://github.com/fabio-noga)
- [kaiju466](https://github.com/kaiju466)

## Disclaimer

This is a personal hobby project. The codebase is functional but not production-grade — minimal comments, no tests, and some rough edges. Use at your own discretion.

SRTto3Dsubtitles

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README