# cordovat-dev/subtitulos architecture

> Architecture diagram of the GitHub repository cordovat-dev/subtitulos, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cordovat-dev/subtitulos
- Repository: https://github.com/cordovat-dev/subtitulos

## Overview

This Java project has two subtitle/file utilities: matching episode files across extensions and converting subtitle input into SRT output. The visible `main` entry point runs conversion; a separate method builds a file-pairing report. The graph preserves both workflows and the separate `sub2` time-range model. Relationships are limited to those shown in excerpts or the source index; several subtitle implementations were not excerpted.

Main entry points: [`src/sub/Main.java`](https://github.com/cordovat-dev/subtitulos/blob/master/src/sub/Main.java) (Main workflows), [`src/arc/Fabrica.java`](https://github.com/cordovat-dev/subtitulos/blob/master/src/arc/Fabrica.java) (Object factory), [`src/arc/PareadorArchivos.java`](https://github.com/cordovat-dev/subtitulos/blob/master/src/arc/PareadorArchivos.java) (File pairer), [`src/sub/ConvStrToSub.java`](https://github.com/cordovat-dev/subtitulos/blob/master/src/sub/ConvStrToSub.java) (Line converter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application entry"]
  node_main["Main workflows<br/>[Main.java]"]
end

subgraph group_matching["File matching"]
  node_factory["Object factory<br/>[Fabrica.java]"]
  node_filters["Extension filters"]
  node_episode_file["Episode file<br/>[Archivo.java]"]
  node_file_base["File abstraction"]
  node_pairer["File pairer"]
  node_pairing_base["Pairing abstraction"]
  node_file_pair["File pair<br/>[ParArchivos.java]"]
  node_pair_base["Pair abstraction"]
end

subgraph group_subtitles["Subtitle conversion"]
  node_subtitle_input["Subtitle reader<br/>[ArchivoSrt.java]"]
  node_subtitle_file["Subtitle file I/O"]
  node_converter["Line converter<br/>[ConvStrToSub.java]"]
  node_line_converter_base["Converter abstraction"]
  node_srt_line["SRT line<br/>[LineaSrt.java]"]
  node_subtitle_line["Subtitle line<br/>[LineaSub.java]"]
  node_additional_converter["SRT adjustment"]
  node_subtitle_reader_variant["Subtitle reader variant<br/>[ArchivoSub.java]"]
end

subgraph group_time_model["Subtitle time model"]
  node_time_line["Timed subtitle line"]
  node_sub_time_line["Subtitle time line"]
  node_time_range["Time range<br/>[RangoTiempo.java]"]
end

node_main -->|"creates pairer"| node_factory
node_main -->|"sets extensions"| node_filters
node_main -->|"requests report"| node_pairing_base
node_factory -->|"creates"| node_pairer
node_pairer -->|"creates files and pairs"| node_factory
node_pairer -->|"filters files"| node_filters
node_pairer -->|"extends"| node_pairing_base
node_factory -->|"creates"| node_episode_file
node_episode_file -->|"extends"| node_file_base
node_factory -->|"creates"| node_file_pair
node_file_pair -->|"extends"| node_pair_base
node_main -->|"opens input"| node_subtitle_input
node_main -->|"converts lines"| node_converter
node_main -->|"writes output"| node_subtitle_file
node_subtitle_input -->|"extends"| node_subtitle_file
node_converter -->|"extends"| node_line_converter_base
node_converter -->|"uses"| node_srt_line
node_converter -->|"produces"| node_subtitle_line
node_additional_converter -->|"uses"| node_line_converter_base
node_additional_converter -->|"uses"| node_subtitle_line
node_subtitle_reader_variant -->|"extends"| node_subtitle_file
node_time_line -->|"uses"| node_time_range
node_sub_time_line -->|"uses"| node_time_range

click node_main "https://github.com/cordovat-dev/subtitulos/blob/master/src/sub/Main.java"
click node_factory "https://github.com/cordovat-dev/subtitulos/blob/master/src/arc/Fabrica.java"
click node_filters "https://github.com/cordovat-dev/subtitulos/blob/master/src/arc/FiltroArchivos.java"
click node_episode_file "https://github.com/cordovat-dev/subtitulos/blob/master/src/arc/Archivo.java"
click node_file_base "https://github.com/cordovat-dev/subtitulos/blob/master/src/arc/ArchivoAbstracto.java"
click node_pairer "https://github.com/cordovat-dev/subtitulos/blob/master/src/arc/PareadorArchivos.java"
click node_pairing_base "https://github.com/cordovat-dev/subtitulos/blob/master/src/arc/PareadorArchivosAbstracto.java"
click node_file_pair "https://github.com/cordovat-dev/subtitulos/blob/master/src/arc/ParArchivos.java"
click node_pair_base "https://github.com/cordovat-dev/subtitulos/blob/master/src/arc/ParArchivosAbstracto.java"
click node_subtitle_input "https://github.com/cordovat-dev/subtitulos/blob/master/src/sub/ArchivoSrt.java"
click node_subtitle_file "https://github.com/cordovat-dev/subtitulos/blob/master/src/sub/ArchivoSubtitulo.java"
click node_converter "https://github.com/cordovat-dev/subtitulos/blob/master/src/sub/ConvStrToSub.java"
click node_line_converter_base "https://github.com/cordovat-dev/subtitulos/blob/master/src/sub/ConvertidorLineaSubtitulos.java"
click node_srt_line "https://github.com/cordovat-dev/subtitulos/blob/master/src/sub/LineaSrt.java"
click node_subtitle_line "https://github.com/cordovat-dev/subtitulos/blob/master/src/sub/LineaSub.java"
click node_additional_converter "https://github.com/cordovat-dev/subtitulos/blob/master/src/sub/ConvAdicionalSrtSrt.java"
click node_subtitle_reader_variant "https://github.com/cordovat-dev/subtitulos/blob/master/src/sub/ArchivoSub.java"
click node_time_line "https://github.com/cordovat-dev/subtitulos/blob/master/src/sub2/LineaSubtitulo.java"
click node_sub_time_line "https://github.com/cordovat-dev/subtitulos/blob/master/src/sub2/LineaSubtituloSub.java"
click node_time_range "https://github.com/cordovat-dev/subtitulos/blob/master/src/sub2/RangoTiempo.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main toneBlue
class node_factory,node_filters,node_episode_file,node_file_base,node_pairer,node_pairing_base,node_file_pair,node_pair_base toneAmber
class node_subtitle_input,node_subtitle_file,node_converter,node_line_converter_base,node_srt_line,node_subtitle_line,node_additional_converter,node_subtitle_reader_variant toneMint
class node_time_line,node_sub_time_line,node_time_range toneRose
```

## Components

### Application entry

- [Main workflows](https://github.com/cordovat-dev/subtitulos/blob/master/src/sub/Main.java): `src/sub/Main.java`

### File matching

- [Object factory](https://github.com/cordovat-dev/subtitulos/blob/master/src/arc/Fabrica.java): `src/arc/Fabrica.java`
- [Extension filters](https://github.com/cordovat-dev/subtitulos/blob/master/src/arc/FiltroArchivos.java): `src/arc/FiltroArchivos.java`
- [Episode file](https://github.com/cordovat-dev/subtitulos/blob/master/src/arc/Archivo.java): `src/arc/Archivo.java`
- [File abstraction](https://github.com/cordovat-dev/subtitulos/blob/master/src/arc/ArchivoAbstracto.java): `src/arc/ArchivoAbstracto.java`
- [File pairer](https://github.com/cordovat-dev/subtitulos/blob/master/src/arc/PareadorArchivos.java): `src/arc/PareadorArchivos.java`
- [Pairing abstraction](https://github.com/cordovat-dev/subtitulos/blob/master/src/arc/PareadorArchivosAbstracto.java): `src/arc/PareadorArchivosAbstracto.java`
- [File pair](https://github.com/cordovat-dev/subtitulos/blob/master/src/arc/ParArchivos.java): `src/arc/ParArchivos.java`
- [Pair abstraction](https://github.com/cordovat-dev/subtitulos/blob/master/src/arc/ParArchivosAbstracto.java): `src/arc/ParArchivosAbstracto.java`

### Subtitle conversion

- [Subtitle reader](https://github.com/cordovat-dev/subtitulos/blob/master/src/sub/ArchivoSrt.java): `src/sub/ArchivoSrt.java`
- [Subtitle file I/O](https://github.com/cordovat-dev/subtitulos/blob/master/src/sub/ArchivoSubtitulo.java): `src/sub/ArchivoSubtitulo.java`
- [Line converter](https://github.com/cordovat-dev/subtitulos/blob/master/src/sub/ConvStrToSub.java): `src/sub/ConvStrToSub.java`
- [Converter abstraction](https://github.com/cordovat-dev/subtitulos/blob/master/src/sub/ConvertidorLineaSubtitulos.java): `src/sub/ConvertidorLineaSubtitulos.java`
- [SRT line](https://github.com/cordovat-dev/subtitulos/blob/master/src/sub/LineaSrt.java): `src/sub/LineaSrt.java`
- [Subtitle line](https://github.com/cordovat-dev/subtitulos/blob/master/src/sub/LineaSub.java): `src/sub/LineaSub.java`
- [SRT adjustment](https://github.com/cordovat-dev/subtitulos/blob/master/src/sub/ConvAdicionalSrtSrt.java): `src/sub/ConvAdicionalSrtSrt.java`
- [Subtitle reader variant](https://github.com/cordovat-dev/subtitulos/blob/master/src/sub/ArchivoSub.java): `src/sub/ArchivoSub.java`

### Subtitle time model

- [Timed subtitle line](https://github.com/cordovat-dev/subtitulos/blob/master/src/sub2/LineaSubtitulo.java): `src/sub2/LineaSubtitulo.java`
- [Subtitle time line](https://github.com/cordovat-dev/subtitulos/blob/master/src/sub2/LineaSubtituloSub.java): `src/sub2/LineaSubtituloSub.java`
- [Time range](https://github.com/cordovat-dev/subtitulos/blob/master/src/sub2/RangoTiempo.java): `src/sub2/RangoTiempo.java`

## Connections

- Main workflows → Object factory: creates pairer (evidence: `src/sub/Main.java`)
- Main workflows → Extension filters: sets extensions (evidence: `src/sub/Main.java`)
- Main workflows → Pairing abstraction: requests report (evidence: `src/sub/Main.java`)
- Object factory → File pairer: creates (evidence: `src/arc/Fabrica.java`)
- File pairer → Object factory: creates files and pairs (evidence: `src/arc/PareadorArchivos.java`)
- File pairer → Extension filters: filters files (evidence: `src/arc/PareadorArchivos.java`)
- File pairer → Pairing abstraction: extends (evidence: `src/arc/PareadorArchivos.java`)
- Object factory → Episode file: creates (evidence: `src/arc/Fabrica.java`)
- Episode file → File abstraction: extends (evidence: `src/arc/Archivo.java`)
- Object factory → File pair: creates (evidence: `src/arc/Fabrica.java`)
- File pair → Pair abstraction: extends (evidence: `src/arc/ParArchivos.java`)
- Main workflows → Subtitle reader: opens input (evidence: `src/sub/Main.java`)
- Main workflows → Line converter: converts lines (evidence: `src/sub/Main.java`)
- Main workflows → Subtitle file I/O: writes output (evidence: `src/sub/Main.java`)
- Subtitle reader → Subtitle file I/O: extends (evidence: `src/sub/ArchivoSrt.java`)
- Line converter → Converter abstraction: extends (evidence: `src/sub/ConvStrToSub.java`)
- Line converter → SRT line: uses (evidence: `src/sub/ConvStrToSub.java`)
- Line converter → Subtitle line: produces (evidence: `src/sub/ConvStrToSub.java`)
- SRT adjustment → Converter abstraction: uses (evidence: `src/sub/ConvAdicionalSrtSrt.java`)
- SRT adjustment → Subtitle line: uses (evidence: `src/sub/ConvAdicionalSrtSrt.java`)
- Subtitle reader variant → Subtitle file I/O: extends (evidence: `src/sub/ArchivoSub.java`)
- Timed subtitle line → Time range: uses (evidence: `src/sub2/LineaSubtitulo.java`)
- Subtitle time line → Time range: uses (evidence: `src/sub2/LineaSubtituloSub.java`)
