aeidon
Reading, writing and manipulating text-based subtitle files
Decision gist · record as of 2026-08-14
Yes. aeidon is actively maintained with no known vulnerabilities and low install friction. The GPL-3.0-or-later license is a blocker only for proprietary closed-source use; for open-source or internal projects, it's a straightforward choice.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later
- Low install friction with a pure-Python wheel and single runtime dependency.
- Actively maintained with a recent release.
License · maintenance · safety
GPL-3.0-or-later (copyleft) — GPL-3.0-or-later copyleft license requires derivative works to be licensed under compatible terms; not suitable for proprietary closed-source software.
last release 2026-08-09 (5 days) · last repo commit 2026-08-09 · 274 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 109,687 downloads/mo, #12,502 on PyPI
Alternatives
Verify before relying
pip install aeidon
import aeidon
project = aeidon.Project()
project.open_main("/path/to/file.srt", "utf_8")
project.shift_positions(None, aeidon.as_seconds(-2))
project.save_main()- Which subtitle formats beyond SubRip and MicroDVD are supported by the library
- Performance characteristics when processing large subtitle files
- Whether the API documentation reflects current version 2.0 behavior
What it is and what it does
aeidon is a Python library for working with text-based subtitle files. It provides a Project-based API for reading and writing subtitles in multiple formats, along with functions to manipulate subtitle timing and text content. The package is part of the Gaupol subtitle editor ecosystem and handles the core subtitle data operations that the editor's GUI layer builds upon.
The library abstracts away format-specific details, allowing you to load a subtitle file in one format, adjust timing or edit content, and save it in a different format. It requires Python 3.10 or later and depends only on charset-normalizer for character encoding handling, making it lightweight to integrate into subtitle processing workflows.
Use it for
- Convert subtitle files between formats programmatically
- Batch-shift subtitle timings by a fixed offset across multiple files
- Build subtitle editing or validation tools on top of the library's data model
- Automate subtitle file processing in video production pipelines
- Parse and extract subtitle text and timing data for analysis
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
aeidon is actively maintained with no known vulnerabilities and low install friction. The GPL-3.0-or-later license is a blocker only for proprietary closed-source use; for open-source or internal projects, it's a straightforward choice.
Install
aeidon on PyPI
Before you install
Low install friction with a pure-Python wheel and single runtime dependency. Actively maintained with a recent release.
Requires Python 3.10 or later
License in practice
GPL-3.0-or-later copyleft license requires derivative works to be licensed under compatible terms; not suitable for proprietary closed-source software.
Quickstart
pip install aeidon
import aeidon
project = aeidon.Project()
project.open_main("/path/to/file.srt", "utf_8")
project.shift_positions(None, aeidon.as_seconds(-2))
project.save_main()Verify before relying
- Which subtitle formats beyond SubRip and MicroDVD are supported by the library
- Performance characteristics when processing large subtitle files
- Whether the API documentation reflects current version 2.0 behavior
Package facts
| License | GPL-3.0-or-later copyleft |
| Python support | Supports the current Python release >=3.10.0 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagecharset-normalizer |
| Maintenance | Actively maintained 5 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 109,687 / month, #12,502 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
Evidence: aeidon-2.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “subtitle file conversion”
- aeidonaeidon reads, writes, and manipulates text-based subtitle files in…
- pysubs2pysubs2 loads, edits, and saves subtitle files in multiple formats…
- pysrtpysrt parses, edits, and writes SubRip (.srt) subtitle files,…
Give your agent the search over MCP, or paste the wish link into any chat.
More Text Processing packages
A drop-in replacement for Python's standard `re` module that adds advanced regex features like nested sets, fuzzy matching, lookaround in conditionals, and full Unicode case-folding while maintaining backward compatibility.
pyparsing provides a library for building text parsers directly in Python code using composable grammar classes, handling quoted strings, whitespace variation, and embedded comments without regex or lex/yacc.
Install it if you need to parse text or define grammars programmatically.
fonttools manipulates font files in multiple formats (TrueType, OpenType, AFM, Type 1, Mac-specific) and includes TTX, a tool to convert fonts to and from XML text format.
Install it if you need to read, write, or manipulate fonts programmatically or via the TTX command-line tool.
Docutils converts plaintext documentation in reStructuredText format into multiple output formats including HTML, XML, and LaTeX using a modular processing system.
RapidFuzz provides fast fuzzy string matching using Levenshtein Distance and related metrics, implemented mostly in C++ with Python bindings for rapid similarity scoring and approximate string matching.
Install it if you need fuzzy string matching; it's a solid replacement for FuzzyWuzzy with better licensing and performance.
tinycss2 parses CSS strings into token and block objects, and generates CSS strings from those objects, following the CSS Syntax Level 3 specification without enforcing specific properties or values.
Install it if your project requires CSS tokenization or syntax manipulation.
See also pysubs2 · pysrt · srt · pydub · trakit · webvtt-py · subliminal · youtube-transcript-api · translate-toolkit · pytubefix