A powerful subtitle file converter that ensures proper UTF-8 encoding. Supports multiple subtitle formats with a simple command-line interface and flexible configuration.
Repo onyxdevs/subzilla, read from GitHub 1 h ago. onyxdevs has not joined Take My Repo.
onyxdevs/subzilla is a public repo on GitHub by onyxdevs. A powerful subtitle file converter that ensures proper UTF-8 encoding. Supports multiple subtitle formats with a simple command-line interface and flexible configuration. It declares the ISC license on GitHub. It is written mainly in TypeScript, has 5 stars and last changed on 2026-11-15. Nobody has reviewed it on Take My Repo yet, which says nothing about its quality. Read from GitHub on 2026-11-22.
In the maintainer's words. Shown from GitHub; Take My Repo does not keep a copy.
A powerful subtitle file converter that ensures proper UTF-8 encoding with robust support for Arabic and other languages. SubZilla automatically detects the input file encoding and converts it to UTF-8, making it perfect for fixing subtitle encoding issues. Built with SOLID, YAGNI, KISS, and DRY principles in mind.
<font> tags and timestamps cannot out-vote a windows-1256 Arabic payload)..srt, .sub, .ass, .ssa, .txt).<br>, <p>/<div>, , ASS \N and exotic Unicode line breaks all become real separators) and never splits a cue.# Install globally using yarn
yarn global add subzilla
# Or using npm
npm install -g subzilla
# Clone the repository
git clone https://github.com/onyxdevs/subzilla.git
cd subzilla
# Install dependencies (installs all workspace packages)
yarn install
# Build all packages
yarn build
# Run the CLI
yarn start
# Development mode (watch for changes)
yarn dev
# Convert a single subtitle file
subzilla convert path/to/subtitle.srt
# The converted file will be saved as path/to/subtitle.utf8.srt
# Strip HTML formatting
subzilla convert input.srt --strip-html
# Strip color codes
subzilla convert input.srt --strip-colors
# Strip style tags
subzilla convert input.srt --strip-styles
# Replace URLs with [URL]
subzilla convert input.srt --strip-urls
# Strip all formatting
subzilla convert input.srt --strip-all
# Create backup and strip formatting
subzilla convert input.srt -b --strip-all
# Create numbered backups instead of overwriting existing backup
subzilla convert input.srt -b --no-overwrite-backup
# Combine multiple strip options
subzilla convert input.srt --strip-html --strip-colors
Convert multiple subtitle files at once using glob patterns:
# Convert all .srt files in current directory
subzilla batch "*.srt"
# Convert files recursively in all subdirectories
subzilla batch "**/*.srt" -r
# Convert multiple formats
subzilla batch "**/*.{srt,sub,txt}" -r
# Specify output directory
subzilla batch "**/*.srt" -o converted/
# Process files in parallel for better performance
subzilla batch "**/*.srt" -p
# Skip existing UTF-8 files
subzilla batch "**/*.srt" -s
# Combine basic options for maximum efficiency
subzilla batch "**/*.{srt,sub,txt}" -r -p -s -o converted/
# Advanced Directory Processing
# Limit recursive depth to 2 levels
subzilla batch "**/*.srt" -r -d 2
# Only process files in specific directories
subzilla batch "**/*.srt" -r -i "movies" "series"
# Exclude specific directories
subzilla batch "**/*.srt" -r -x "temp" "backup"
# Preserve directory structure in output
subzilla batch "**/*.srt" -r -o converted/ --preserve-structure
# Complex example combining all features
subzilla batch "**/*.{srt,sub,txt}" -r -p -s -o converted/ \
-d 3 -i "movies" "series" -x "temp" "backup" --preserve-structure
# Strip formatting in batch mode
subzilla batch "**/*.srt" -r --strip-all
# Strip specific formatting in batch mode
subzilla batch "**/*.srt" -r --strip-html --strip-colors
# Create backups and strip formatting
subzilla batch "**/*.srt" -r -b --strip-all
# Create numbered backups instead of overwriting existing ones
subzilla batch "**/*.srt" -r -b --no-overwrite-backup --strip-all
# Complex example with formatting options
subzilla batch "**/*.{srt,sub,txt}" -r -p -s -o converted/ \
-d 3 -i "movies" "series" -x "temp" "backup" \
--preserve-structure --strip-all -b
Options:
-o, --output-dir <dir>: Save converted files to specified directory.-r, --recursive: Search for files in subdirectories.-p, --parallel: Process files in parallel (faster for many files).-s, --skip-existing: Skip files that already have a UTF-8 version.-d, --max-depth <depth>: Maximum directory depth for recursive search.-i, --include-dirs <dirs...>: Only process files in these directories.-x, --exclude-dirs <dirs...>: Exclude files in these directories.--preserve-structure: Preserve directory structure in output.-b, --backup: Create backup of original files.--no-overwrite-backup: Create numbered backups instead of overwriting existing backup.--strip-html: Strip HTML tags (block tags and <br> become line breaks, entities like are decoded).--strip-markdown: Strip Markdown formatting (**bold**, *italic*, ~~strike~~, `code`, [text](url), ## headings). Subtitle conventions that merely look like Markdown β dialogue dashes, # song lyrics #, f**k, >> Speaker: β are left alone.--strip-colors: Strip color codes.--strip-styles: Strip style tags.--strip-urls: Replace URLs with [URL].--strip-all: Strip all formatting (equivalent to all strip options).Features:
Example Output:
π Found 25 files in 5 directories...
Converting |==========| 100% | 25/25 | Total Progress
Converting |==========| 100% | 8/8 | Processing movies
Converting |==========| 100% | 7/7 | Processing series/season1
Converting |==========| 100% | 5/5 | Processing series/season2
Converting |==========| 100% | 3/3 | Processing series/specials
Converting |==========| 100% | 2/2 | Processing extras
π Batch Processing Summary:
ββββββββββββββββββββββββββ
Total files processed: 25
Directories processed: 5
β
Successfully converted: 23
β Failed: 1
βοΈ Skipped: 1
β±οΈ Total time: 5.32s
β‘ Average time per file: 0.22s
π Directory Statistics:
ββββββββββββββββββββ
movies:
Total: 8
β
Success: 8
β Failed: 0
βοΈ Skipped: 0
series/season1:
Total: 7
β
Success: 6
β Failed: 1
βοΈ Skipped: 0
series/season2:
Total: 5
β
Success: 5
β Failed: 0
βοΈ Skipped: 0
series/specials:
Total: 3
β
Success: 2
β Failed: 0
βοΈ Skipped: 1
extras:
Total: 2
β
Success: 2
β Failed: 0
βοΈ Skipped: 0
β Errors:
βββββββββ
series/season1/broken.srt: Failed to detect encoding
SubZilla provides flexible backup options to protect your original files:
# Basic backup creation
subzilla convert input.srt -b
# By default, subsequent runs overwrite the existing backup
# First run: creates input.srt.bak
# Second run: overwrites input.srt.bak (clean, no accumulation)
# Create numbered backups instead (legacy behavior)
subzilla convert input.srt -b --no-overwrite-backup
# First run: creates input.srt.bak
# Second run: creates input.srt.bak.1
# Third run: creates input.srt.bak.2
# Configure backup behavior in config file
# .subzillarc:
# output:
# createBackup: true
# overwriteBackup: false # Creates numbered backups
Backup Behavior Summary:
overwriteBackup: true (default): Clean backup management - always overwrites existing backupoverwriteBackup: false: Legacy behavior - creates numbered backups (.bak.1, .bak.2, etc.)--no-overwrite-backup to temporarily disable backup overwriting# Specify output file (single file conversion)
subzilla convert input.srt -o output.srt
# Get help
subzilla --help
# Get version
subzilla --version
# Get help for specific command
subzilla convert --help
subzilla batch --help
SubZilla includes a native macOS desktop application built with Electron, featuring a drag-and-drop interface for easy subtitle conversion.
Grab the latest .dmg from the releases page: Subzilla-<version>-arm64.dmg for Apple Silicon, Subzilla-<version>.dmg for Intel.
The app is not signed with an Apple Developer ID (it is ad-hoc signed, so its signature is valid but not tied to a verified developer), so macOS blocks it on first launch. Open it once via System Settings β Privacy & Security β Open Anyway (or run xattr -cr /Applications/Subzilla.app). For the same reason the built-in auto-updater cannot install updates on its own; download new versions from the releases page.
Development Mode:
# Build all packages first
yarn build
# Run the Mac app in development mode
yarn workspace @subzilla/mac dev
Building for Distribution:
# Build the Mac app (creates DMG and ZIP)
yarn workspace @subzilla/mac build
# Output files are in packages/mac/dist-electron/
# - Subzilla-<version>-arm64.dmg / -arm64-mac.zip (Apple Silicon)
# - Subzilla-<version>.dmg / -mac.zip (Intel)
.srt, .sub, .ass and .ssa files (hidden folders, already-converted .subzilla. files and VobSub .sub/.idx pairs are skipped)The Mac app is located in packages/mac/ and includes:
src/main/ - Electron main process (window management, IPC handlers)src/preload/ - Secure context bridgesrc/renderer/ - User interface (HTML/CSS/JS)SubZilla supports flexible configuration through YAML files and environment variables. All settings are optional with sensible defaults.
SubZilla looks for configuration files in the following order:
--config option.subzillarc in the current directory.subzilla.yml or .subzilla.yamlsubzilla.config.yml or subzilla.config.yamlThe Mac app treats these files differently from the CLI: once you save the Preferences window, Preferences is the only source of settings and .subzillarc files are ignored. Before the first save (and again after Reset to Defaults) a .subzillarc in your home directory seeds the initial values over the built-in defaults, and the Preferences window shows them. Environment variables are not read by the app.
Several example configurations are provided in the examples/config directory:
Full Configuration (.subzillarc):
input:
encoding: auto # auto, utf8, utf16le, utf16be, ascii, windows1256
format: auto # auto, srt, sub, ass, ssa, txt
output:
directory: ./converted # Output directory path
createBackup: true # Create backup of original files
overwriteBackup: true # Overwrite existing backup files (default: true)
format: srt # Output format
encoding: utf8 # Always UTF-8
bom: false # Add BOM to output files
lineEndings: lf # lf, crlf, or auto
# ... and more settings
Minimal Configuration (minimal.subzillarc):
input:
encoding: auto
format: auto
output:
directory: ./converted
createBackup: true
overwriteBackup: true # Overwrite existing backup files
format: srt
strip:
html: true
markdown: true
colors: true
styles: true
batch:
recursive: true
parallel: true
skipExisting: true
preserveStructure: true # Maintain directory structure
chunkSize: 5
Performance-Optimized (performance.subzillarc):
output:
createBackup: false # Skip backups
overwriteBackup: true # When backups are created, overwrite existing ones
overwriteInput: true # Overwrite input files
overwriteExisting: true # Don't check existing files
batch:
parallel: true
preserveStructure: false # Flat output structure
chunkSize: 20 # Larger chunks
retryCount: 0 # No retries
failFast: true # Stop on first error
Arabic-Optimized (arabic.subzillarc):
input:
encoding: windows1256 # Common Arabic encoding
output:
bom: true # Add BOM for compatibility
lineEndings: crlf # Windows line endings
batch:
includeDirectories:
- arabic
- Ω
Ψ³ΩΨ³ΩΨ§Ψͺ
- Ψ£ΩΩΨ§Ω
You can also configure SubZilla using environment variables. Copy .env.example to .env and modify as needed:
# Input Settings
SUBZILLA_INPUT_ENCODING=utf8
SUBZILLA_INPUT_FORMAT=srt
SUBZILLA_INPUT_DEFAULT_LANGUAGE=ar
# Output Settings
SUBZILLA_OUTPUT_DIRECTORY=./output
SUBZILLA_OUTPUT_CREATE_BACKUP=true
# Complex settings use JSON
SUBZILLA_STRIP='{"html":true,"colors":true,"styles":true}'
SUBZILLA_BATCH_INCLUDE_DIRECTORIES='["movies","series"]'
Settings are merged in the following order (later ones override earlier ones):
encoding: Input file encoding (auto, utf8, utf16le, utf16be, ascii, windows1256).format: Input format (auto, srt, sub, ass, ssa, txt).directory: Output directory path.createBackup: Create backup of original files.overwriteBackup: Overwrite existing backup files (default: true).format: Output format.encoding: Output encoding (always utf8).bom: Add BOM to output files.lineEndings: Line ending style (lf, crlf, auto).overwriteInput: Overwrite input files.overwriteExisting: Overwrite existing files.html: Remove HTML tags. <br> and block tags (<p>, <div>, <li>, ...) become line breaks, and entities ( , &,  , ...) are decoded.markdown: Remove Markdown formatting (**bold**, *italic*, ~~strike~~, `code`, [text](url), ## headings), leaving subtitle conventions such as dialogue dashes and # song lyrics # alone.colors: Remove color codes.styles: Remove style tags.urls: Replace URLs with [URL].timestamps: Replace timestamps with [TIMESTAMP].numbers: Replace numbers with #.punctuation: Remove punctuation.emojis: Replace emojis with [EMOJI].brackets: Remove brackets.bidiControl: Remove invisible bidirectional control characters (RLM, LRM, ALM, embeddings, isolates). Recommended for Arabic.
timestamps,numbers,punctuationandbracketsare ignored when converting subtitle files, because they would destroy the cue numbers and timing lines. They only take effect whenFormattingStripperis used directly on plain text.
recursive: Process subdirectories.parallel: Process files in parallel.skipExisting: Skip existing UTF-8 files.maxDepth: Maximum directory depth.includeDirectories: Only process these directories.excludeDirectories: Skip these directories.preserveStructure: Maintain directory structure.chunkSize: Files per batch.retryCount: Number of retry attempts.retryDelay: Delay between retries (ms).failFast: Stop on first error.SubZilla follows a modular monorepo architecture with clear separation of concerns:
@subzilla/cli @subzilla/mac
βββ @subzilla/core βββ @subzilla/core
β βββ @subzilla/types β βββ @subzilla/types
βββ @subzilla/types βββ @subzilla/types
The monorepo uses TypeScript project references for:
SubZilla is organized as a Yarn Workspaces monorepo with four main packages:
subzilla/
βββ packages/
β βββ cli/ # @subzilla/cli - Command-line interface
β β βββ src/
β β β βββ commands/ # CLI command implementations
β β β βββ constants/# Shared CLI options
β β β βββ registry/ # Command registration system
β β β βββ utils/ # CLI utilities
β β β βββ main.ts # CLI entry point
β β βββ package.json
β βββ core/ # @subzilla/core - Core processing logic
β β βββ src/
β β β βββ utils/ # Output strategies
β β β βββ *.ts # Core services and processors
β β β βββ index.ts # Package exports
β β βββ package.json
β βββ mac/ # @subzilla/mac - macOS desktop application
β β βββ src/
β β β βββ main/ # Electron main process
β β β βββ preload/ # Context bridge
β β β βββ renderer/ # UI (HTML/CSS/JS)
β β βββ package.json
β βββ types/ # @subzilla/types - TypeScript definitions
β βββ src/
β β βββ cli/ # CLI-related types
β β βββ core/ # Core functionality types
β β βββ index.ts # Main exports
β β βββ validation.ts # Zod schemas
β βββ package.json
βββ examples/ # Configuration examples
βββ package.json # Workspace root configuration
βββ tsconfig.json # TypeScript project references
Each package has comprehensive documentation:
SubZilla includes a comprehensive Jest testing framework with 680 passing tests across all packages:
# Run all tests
yarn test
# Test specific package
yarn workspace @subzilla/core test
yarn workspace @subzilla/cli test
yarn workspace @subzilla/types test
yarn workspace @subzilla/mac test
The CLI integration tests run the compiled CLI, so build first (
npx tsc --build).
Test Coverage:
Adversarial suites (packages/core/__tests__/*.adversarial.test.ts) run the real pipeline on real bytes and assert exact output:
WordBoundary: every known way formatting removal can glue two Arabic words or split a cue, plus a seeded generative test (400 random files) asserting each cue keeps the same words in the same order.EncodingDetection: decoded text must round-trip across 9 legacy encodings Γ 4 markup styles, including tiny files and BOM-less UTF-16.MarkdownStrip: what must be stripped, and the subtitle conventions that must be left alone.LineBreakCollapse: inline <br> / ASS \N handling.Key Features:
execSyncWorkspace-level scripts:
yarn build: Build all packages in dependency orderyarn start: Run the SubZilla CLIyarn dev: Development mode with watch for all packagesyarn test: Run tests across all packagesyarn type-check: TypeScript type checking for all packagesyarn lint: Run linter across all packagesyarn lint:fix: Fix linting issues across all packagesyarn format: Format code using Prettier across all packagesyarn format:check: Check code formatting across all packagesyarn clean: Clean all build artifactsPackage-specific scripts:
# Build specific package
yarn workspace @subzilla/core build
# Run CLI directly
yarn workspace @subzilla/cli start
# Develop specific package
yarn workspace @subzilla/types dev
The workspace structure provides several advantages:
yarn install and yarn build for the entire projectSee CONTRIBUTING.md for setup, testing expectations and commit conventions. In short:
Fork the repository
Clone your fork and install dependencies
git clone https://github.com/your-username/subzilla.git
cd subzilla
yarn install
Create your feature branch
git checkout -b feature/amazing-feature
Make your changes
yarn buildTest your changes
yarn build
yarn test
yarn lint
yarn type-check
Commit your changes
git commit -m 'Add some amazing feature'
Push to your branch
git push origin feature/amazing-feature
Open a Pull Request
# Start development mode (watches all packages)
yarn dev
# Build specific package
yarn workspace @subzilla/core build
# Test specific package
yarn workspace @subzilla/cli test
# Run CLI during development
yarn start --help
# Clean and rebuild everything
yarn clean
yarn build
This project is licensed under the ISC License - see the LICENSE file for details.
If you encounter any issues or have questions, please:
Planned improvements and feature additions:
Enhanced Format Support
.ass and .ssa subtitle formatsUser Interface & Experience
Performance & Reliability
Advanced Features
Developer Experience & Infrastructure
Integration & Ecosystem
Want to contribute to these enhancements? Check our Contributing section!
onyxdevs/subzilla is a public repo on GitHub by onyxdevs. A powerful subtitle file converter that ensures proper UTF-8 encoding. Supports multiple subtitle formats with a simple command-line interface and flexible configuration.
It declares the ISC license on GitHub.
Its maker tagged it for macOS, Windows and Linux, or as Docker or cross-platform. That is declared by the maker; Take My Repo has not tested it.
Open "Take it" on its page: Take My Repo writes an install plan for your machine and hands it to your AI agent (Claude Code, Codex or Cursor), which asks you before each step. Take My Repo has not tested it on any machine.
Its last change on GitHub was on 2026-11-15. GitHub counts 2 open issues and pull requests. Take My Repo does not judge from that whether it is maintained.
PEASS - Privilege Escalation Awesome Scripts SUITE (with colors)
Nobody has reviewed it on Take My Repo yet, which says nothing about its quality.
Dependency-Track is an intelligent Component Analysis platform that allows organizations to identify and reduce risk in the software supply chain.

DataLoader is a generic utility to be used as part of your application's data fetching layer to provide a consistent API over various backends and reduce requests to those backends via batching and caching.
Creates CycloneDX Bill of Materials (BOM) for your projects from source and container images. Supports many languages and package managers. Integrate in your CI/CD pipeline with automatic submission to Dependency Track server

SeaTunnel is a multimodal, high-performance, distributed, massive data integration tool.
A powerful example for a hotel reservation system with React.js, Redux, Sagas, TypeScript, Custom Validation, Custom Hooks, and much more...
Simple and functional slot machine project bootstrapped with Create React App and includes extra useful dependencies with tests for all the used components and hooks.
An organizational chart made with D3.js with lots of features like expanding and zooming.
DropzoneJS example with everything you will need, translations, custom preview and a powerful PHP code to handle upload/delete the file
Well-structured React.js boilerplate bootstrapped with Create React App and includes many more features out of the box like Redux, Sagas, React Router and more.
JavaScript interactive colored SVG lines, interact with mousemove and taken from The BΓ©zier Game, a very interactive game to help you master and understand the pen tool.
This page is also available as structured data, with the same sources and dates.
/api/v1/resources/gh/onyxdevs/subzillaTake My Repo has not tested this on your machine. Requirements come from the project's own documentation.