---
title: SubSync Myanmar Subtitle Translator
emoji: 🎬
colorFrom: yellow
colorTo: gray
sdk: docker
app_port: 7860
pinned: false
license: mit
---

# SubSync — Myanmar Subtitle Translator

`.srt` / `.vtt` / `.ass` ဖိုင်များကို သဘာဝကျသော မြန်မာဘာသာသို့ ပြောင်းပေးသည့် tool။

## HF Space Setup

**Secrets** (Space Settings → Secrets) တွင် ထည့်ရန်:

| Secret name         | ဖော်ပြချက်                        |
|---------------------|-----------------------------------|
| `SUBTITLE_USER`     | Login username                    |
| `SUBTITLE_PASS`     | Login password                    |
| `GEMINI_API_KEY`    | Google Gemini API key (optional)  |
| `OPENROUTER_API_KEY`| OpenRouter API key (optional)     |

> API keys များကို Settings page မှလည်း ထည့်နိုင်သည်။ Secrets တွင်ထည့်ထားလျှင် auto-fill ဖြစ်မည်။

## Local Dev

```bash
pip install -r requirements.txt
SUBTITLE_USER=admin SUBTITLE_PASS=secret streamlit run app.py
```

## File Structure (flat)

```
/
├── app.py              ← Main entry + global layout
├── auth.py             ← Login / session logic
├── api_handler.py      ← Gemini & OpenRouter calls  (Step 2)
├── subtitle_parser.py  ← pysubs2 read/write         (Step 3)
├── translation.py      ← Glossary + chunking         (Step 4-5)
├── Dockerfile
├── requirements.txt
└── README.md
```